CREATE LISTING¶

Créez une annonce gratuite à partager directement avec des consommateurs spécifiques.

Voir aussi :: ALTER LISTING, DESCRIBE LISTING, SHOW LISTINGS, DROP LISTING, Référence au manifeste d’annonce

Syntaxe¶

CREATE EXTERNAL LISTING [ IF NOT EXISTS ] <name>
  [ { SHARE <share_name>  |  APPLICATION PACKAGE <package_name> } ]
  AS '<yaml_manifest_string>'
  [ PUBLISH = { TRUE | FALSE } ]
  [ REVIEW = { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

Copy

Paramètres¶

name

Spécifie l’identificateur (c’est-à-dire le nom) de l’annonce. Il doit être conforme à ce qui suit :

Doit être unique au sein d’une organisation, quelle que soit la Snowflake Region dans laquelle se trouve le compte.
Doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux hormis des traits de soulignement (_).

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.

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.

PUBLISH = { TRUE | FALSE }

Spécifie la manière dont l’annonce doit être publiée.

Si cette valeur est définie sur TRUE, l’annonce est publiée immédiatement auprès du service Opérations du Marketplace pour examen.

Par défaut : TRUE.

REVIEW = { TRUE | FALSE }

Spécifie si l’annonce doit ou non être soumise à l’examen du service Opérations du Marketplace.

Par défaut : TRUE.

COMMENT = 'string_literal'

Spécifie un commentaire pour l’annonce.

Par défaut : aucune valeur

Des combinaisons de valeurs différentes pour les propriétés PUBLISH et REVIEW entraînent les comportements suivants :

PUBLISH	REVIEW	Comportement
TRUE	TRUE	Demandez un examen, puis publiez immédiatement après approbation.
TRUE	FALSE	Entraîne une erreur. Vous ne pouvez pas publier d’annonce sur le Snowflake Marketplace sans qu’elle ait été examinée.
FALSE	TRUE	Demandez un examen sans publication automatiquement après l’examen.
FALSE	FALSE	Enregistrez votre annonce sous forme de brouillon sans demander d’examen ni de 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 DATA EXCHANGE LISTING	Compte	Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.
Privilèges délégués pour configurer l’exécution automatique inter-cloud.	Si la commande ALTER modifie le contenu du manifeste pour l’exécution automatique	Reportez-vous à Autoriser d’autres comptes à configurer l’exécution automatique inter-Cloud.

Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.

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

Pour des instructions sur la création d’un rôle personnalisé avec un ensemble spécifié de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les octrois de rôles et de privilèges permettant d’effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Les annonces créées à l’aide de CREATE LISTING … sont automatiquement publiées. Voir ALTER LISTING pour des informations sur les opérations de publication et d’annulation de la publication.

Exemples¶

Créez une annonce portant le nom « MYLISTING », avec le manifeste spécifié, et soumettez-la à des fins d’examen et de publication ultérieure.

Pour d’autres exemples et cas d’utilisation associés à la gestion des annonces à l’aide de SQL, voir Gérer les annonces avec SQL en tant que fournisseur - exemples.

Note

Cet exemple utilise les valeurs par défaut de PUBLISH et de REVIEW.

CREATE EXTERNAL LISTING MYLISTING
SHARE MySHARE AS
$$
title: "MyListing"
subtitle: "Subtitle for MyListing"
description: "Description for MyListing"
listing_terms:
   type: "STANDARD"
targets:
    accounts: ["Org1.Account1"]
usage_examples:
    - title: "this is a test sql"
      description: "Simple example"
      query: "select *"
$$
;

Copy

Créez une annonce portant le nom « MYLISTING », avec le manifeste spécifié comme brouillon.

CREATE EXTERNAL LISTING MYLISTING
SHARE MySHARE AS
$$
title: "MyListing"
subtitle: "Subtitle for MyListing"
description: "Description for MyListing"
listing_terms:
  type: "OFFLINE"
targets:
   regions: ["PUBLIC.AWS_US_EAST_1", "PUBLIC.AZURE_WESTUS2"]
usage_examples:
   - title: "this is a test sql"
     description: "Simple example"
     query: "select *"
$$ PUBLISH=FALSE REVIEW=FALSE;

Copy