CREATE ORGANIZATION LISTING¶
Créez une annonce organisationnelle pour partager des produits de données en toute sécurité au sein de votre organisation.
Syntaxe¶
CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
[ { SHARE <share_name> | APPLICATION PACKAGE <package_name> } ]
AS '<yaml_manifest_string>'
[ PUBLISH = { TRUE | FALSE } ]
Paramètres¶
name
Spécifie l’identificateur (nom) de l’annonce. Il doit être conforme à ce qui suit :
Doit être unique au sein d’un compte, quelle que soit la région Snowflake dans laquelle se trouve le compte. Le localisateur d’annonces uniformes (ULL) doit être unique au sein d’une organisation.
Ne peut contenir de signes dollar intégrés.
Doit être conforme aux exigences de l’identificateur Snowflake. Voir Exigences relatives à l’identificateur.
SHARE share_name
Spécifie l’identificateur du partage à associer à l’annonce.
APPLICATION PACKAGE package_name
Spécifie le paquet d’application associé à l’annonce.
Voir aussi SHOW APPLICATION PACKAGES.
AS 'yaml_manifest_string'
Spécifie le manifeste de format YAML de l’annonce. Voir Référence au manifeste d’annonce pour des détails et des exemples de fichiers de manifeste d’annonce.
Les manifestes sont normalement fournis sous forme de chaînes encadrées de dollars. Pour plus d’informations, voir Constantes de chaîne encadrées de dollars.
PUBLISH = { TRUE | FALSE }
Spécifie comment publier l’annonce.
Si TRUE, l’annonce est immédiatement publiée sur le Marketplace interne.
Par défaut : TRUE.
Exigences en matière de contrôle d’accès¶
Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :
Privilège |
Objet |
Remarques |
---|---|---|
CREATE ORGANIZATION LISTING ou CREATE DATA EXCHANGE LISTING |
Compte |
Pour créer et modifier des annonces organisationnelles. |
Un rôle utilisé pour exécuter cette commande SQL doit avoir au moins l’un des privilèges suivants définis au minimum ainsi :
Privilège |
Objet |
Remarques |
---|---|---|
CREATE ORGANIZATION LISTING |
ACCOUNT |
Pour joindre le partage spécifié ou le Snowflake Native App Framework spécifié à un listing. Lorsque vous spécifiez un Snowflake Native App Framework, OWNERSHIP ou ATTACH LISTING sont également requis. |
IMPORT ORGANIZATION LISTING |
ACCOUNT |
Pour monter un listing ou exécuter une requête qui utilise un localisateur d’annonces uniformes (ULL) pour référencer un listing organisationnel. |
Notes sur l’utilisation¶
Les annonces créées à l’aide de CREATE ORGANIZATION LISTING … sont automatiquement publiées.
Exemples¶
Cet exemple crée une annonce nommée MYORGLISTING en utilisant les paramètres spécifiés dans le manifeste YAML. Il cible un rôle dans un compte dans une région et inclut les contacts de support et d’approbation.
Note
support_contact
est obligatoire. approver_contact
est obligatoire si une cible discovery
est fournie.
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>"
$$
;