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 } ]

CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
  [ { SHARE <share_name>  |  APPLICATION PACKAGE <package_name> } ]
  FROM '<yaml_manifest_stage_location>'
  [ PUBLISH = { 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.

FROM 'yaml_manifest_stage_location'

Spécifie le chemin d’accès à la zone de préparation interne ou au fichier manifest.yml du clone du référentiel Git.

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'

Le manifeste YAML pour le profil de l’organisation. Pour des détails et des exemples de champs de manifeste, voir Référence au manifeste de listing d’organisation.

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

Copy

Crée un listing provisoire nommé “MYLISTING” à partir d’un emplacement de zone de préparation spécifique. Dans l’exemple suivant, le fichier manifest.yml est situé dans le dossier listingmanifests de la zone de préparation nommée listingstage.

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

Copy