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 } ]
  [ REVIEW = { TRUE | FALSE } ]
Copy

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 également SHOWAPPLICATIONPACKAGES.

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înes 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.

REVIEW =  { TRUE | FALSE }

Indique si l’annonce est soumise pour examen et approbation.

Par défaut : TRUE.

La table suivante répertorie les différentes combinaisons de propriétés PUBLISH et REVIEW et leurs comportements associés :

PUBLISH

REVIEW

Comportement

TRUE

TRUE

Demandez un examen, puis publiez immédiatement après approbation.

TRUE

FALSE

Renvoie une erreur. Une annonce doit être examinée avant d’être publiée.

FALSE

TRUE

Demande de révision sans publication automatique.

FALSE

FALSE

Enregistre l’annonce en tant qu’ébauche sans révision ni publication.

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette commande SQL doit avoir l’un des privilèges suivants au minimum :

Privilège

Objet

Remarques

CREATE ORGANIZATION LISTING ou CREATE DATA EXCHANGE LISTING

Compte

Pour créer et modifier des annonces organisationnelles.

Le rôle utilisé pour exécuter cette commande SQL doit disposer de l’un des privilèges suivants :

Privilège

Objet

Remarques

USAGE

SHARE

Pour joindre le partage spécifié à une annonce.

USAGE

APPLICATION

Pour joindre le Snowflake Native App Framework spécifié à une annonce.

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>"
$$
;
Copy
Langage: Français