CREATE ORGANIZATION LISTING

Crie uma listagem organizacional para compartilhar produtos de dados com segurança em sua organização.

Sintaxe

CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
  [ { SHARE <share_name>  |  APPLICATION PACKAGE <package_name> } ]
  AS '<yaml_manifest_string>'
  [ PUBLISH = { TRUE | FALSE } ]

CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
  [ { SHARE <share_name>  |  APPLICATION PACKAGE <package_name> } ]
  FROM '<yaml_manifest_stage_location>'
  [ PUBLISH = { TRUE | FALSE } ]
Copy

Parâmetros

name

Especifica o identificador (nome) da listagem. Ele deve estar em conformidade com o seguinte:

  • Deve ser exclusivo em uma conta, independentemente da Snowflake Region em que a conta está localizada. O Localizador uniforme de listagens (ULL) deve ser exclusivo dentro de uma organização.

  • Não pode conter sinais de dólar incorporados.

  • Deve estar em conformidade com os requisitos de identificador do Snowflake. Consulte Requisitos para identificadores.

FROM 'yaml_manifest_stage_location'

Especifica o caminho para o arquivo manifest.yml do estágio interno ou do clone do repositório Git.

SHARE share_name

Especifica o identificador do compartilhamento a ser anexado à listagem.

APPLICATION PACKAGE package_name

Especifica o pacote do aplicativo anexado à listagem.

Consulte também SHOW APPLICATION PACKAGES.

AS 'yaml_manifest_string'

O manifesto YAML para o perfil da organização. Para obter detalhes e exemplos de campos de manifesto, consulte Referência do manifesto da listagem da organização.

Os manifestos normalmente são fornecidos como strings entre cifrões. Para obter mais informações, consulte Constantes de cadeias de caracteres entre cifrões.

PUBLISH = { TRUE | FALSE }

Especifica como publicar a listagem.

Se TRUE, a listagem é publicada no Marketplace Interno imediatamente.

Padrão: TRUE.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

Notas

CREATE ORGANIZATION LISTING ou CREATE LISTING

Conta

Para criar e alterar listagens organizacionais.

Uma função usada para executar esse comando SQL deve ter pelo menos um dos seguintes privilégios, no mínimo:

Privilégio

Objeto

Notas

CREATE ORGANIZATION LISTING

ACCOUNT

Para anexar a ação especificada ou o Snowflake Native App Framework especificado a uma listagem. Ao especificar um Snowflake Native App Framework, OWNERSHIP ou ATTACH LISTING também são necessários.

IMPORT ORGANIZATION LISTING

ACCOUNT

Para montar uma listagem ou executar uma consulta que usa um Uniform Listing Locator (ULL) para fazer referência a uma listagem organizacional.

Notas de uso

  • Listagens criadas usando CREATE ORGANIZATION LISTING … são publicadas automaticamente.

Exemplos

Este exemplo cria uma listagem chamada MYORGLISTING usando as configurações especificadas no manifesto YAML. Ele visa a uma função em uma conta em uma região e inclui contatos de suporte e aprovação.

Nota

support_contact é obrigatório. approver_contact é obrigatório se for fornecido um destino discovery.

USE ROLE <organization_listing_role>;

CREATE ORGANIZATION LISTING MYORGLISTING
SHARE <share_name> AS
$$
title: "My title"
description: "One region, all accounts"
organization_profile: "INTERNAL"
organization_targets:
  discovery:
    - account: "<account_name>"
      roles:
        - "<role>"
  access:
    - account: "<account_name>"
      roles:
        - "<role>"
support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
locations:
   access_regions:
   - name: "PUBLIC.<snowflake_region>"
$$
Copy

Cria um rascunho de listagem chamado ‘MYLISTING’ em um local específico do estágio. No exemplo a seguir, o arquivo manifest.yml está localizado na pasta listingmanifests no estágio denominado listingstage.

CREATE ORGANIZATION LISTING MYLISTING
SHARE MySHARE FROM @dbforstage.public.listingstage/listingmanifests;
Copy