CREATE ORGANIZATION LISTING¶

Sintaxe¶

CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
  [ { SHARE <share_name>  |  APPLICATION PACKAGE <package_name> } ]
  AS '<yaml_manifest_string>'
  [ PUBLISH = { TRUE | FALSE } ]
  [ REVIEW = { 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 aspas de cifrão.

PUBLISH = { TRUE | FALSE }

Especifica como publicar a listagem.

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

Padrão: TRUE.

REVIEW =  { TRUE | FALSE }

Especifica se a listagem é enviada para revisão e aprovação.

Padrão: TRUE.

A tabela a seguir lista as diferentes combinações de propriedades PUBLISH e REVIEW e seus comportamentos associados:

PUBLISH	REVIEW	Comportamento
TRUE	TRUE	Solicite uma revisão e publique imediatamente após a revisão.
TRUE	FALSE	Retorna um erro. Uma listagem deve ser revisada antes de ser publicada.
FALSE	TRUE	Solicitar uma revisão sem publicação automática.
FALSE	FALSE	Salva a listagem como um rascunho sem revisão ou publicação.

Requisitos de controle de acesso¶

Uma função usada para executar este comando SQL deve ter no mínimo os seguintes privilégios:

A função usada para executar esse comando SQL deve ter um dos seguintes privilégios:

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.

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>"
$$
;