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 } ]
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.
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'
Especifica o manifesto no formato YAML para a listagem. Consulte Listagem de referência de manifesto para obter detalhes e exemplos de arquivos de manifesto de listagem.
Os manifestos normalmente são fornecidos como cadeias de caracteres entre aspas de cifrão. 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 DATA EXCHANGE 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>"
$$
;