CREATE LISTING¶
Créez un listing gratuit à partager directement avec des consommateurs spécifiques, avec un manifeste YAML en ligne, ou à partir d’un fichier situé dans un emplacement de zone de préparation.
- Voir aussi :
ALTER LISTING, DESCRIBE LISTING, SHOW LISTINGS, SHOW VERSIONS IN LISTING, 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>' ]
CREATE EXTERNAL LISTING [ IF NOT EXISTS ] <name>
[ { SHARE <share_name> | APPLICATION PACKAGE <package_name> } ]
FROM '<yaml_manifest_stage_location>'
[ PUBLISH = { TRUE | FALSE } ]
[ REVIEW = { TRUE | FALSE } ]
Paramètres¶
name
Indique l’identificateur (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 (
_
).
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 YAML pour le listing. Pour les paramètres du manifeste, voir Référence au 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.
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.
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.
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. |
COMMENT = 'string_literal'
Un commentaire pour le listing.
Par défaut : aucune valeur
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 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. |
Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.
Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.
Pour des informations générales sur les rôles et les privilèges accordés pour 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. Pour obtenir des informations sur les opérations de dépublication et de publication, voir ALTER LISTING.
Exemples¶
Crée une annonce portant le nom « MYLISTING » avec un manifeste au format YAML spécifique, et la soumet pour examen et 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 *"
$$
;
Crée une annonce provisoire portant le nom « MYLISTING » avec un manifeste au format YAML spécifique :
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;
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 EXTERNAL LISTING MYLISTING
SHARE MySHARE FROM @dbforstage.public.listingstage/listingmanifests;