DESCRIBE LISTING¶

Décrit les colonnes d’une annonce.

Voir aussi :: CREATE LISTING, ALTER LISTING, SHOW LISTINGS, SHOW VERSIONS IN LISTING, DROP LISTING

Syntaxe¶

{ DESC | DESCRIBE } LISTING <name>  [ REVISION = { DRAFT | PUBLISHED } ]

Copy

Paramètres¶

name

Identificateur, spécifié lors de la création du listing, du listing à décrire. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Consultez SHOW LISTINGS pour les détails du listing, y compris le nom du listing.

REVISION = { DRAFT | PUBLISHED }

Spécifie la révision à afficher.

Par exemple, si vous disposez d’un brouillon d’une annonce publiée, vous pouvez spécifier soit le brouillon, soit la version publiée à afficher.

Valeurs valides:

DRAFT : décrivez la version brouillon de l’annonce.
PUBLISHED : décrivez la version publiée de l’annonce.

Par défaut:: PUBLISHED

Notes sur l’utilisation¶

Vous ne pouvez décrire une annonce que si vous utilisez un rôle qui possède le privilège USAGE, MODIFY, ou OWNERSHIP sur l’annonce.

Pour post-traiter la sortie de cette commande, vous pouvez utiliser la syntaxe opérateur de canal (->>) ou la fonction RESULT_SCAN. Les deux constructions traitent la sortie comme un jeu de résultats que vous pouvez interroger.

Par exemple, vous pouvez utiliser l’opérateur de canal ou la fonction RESULT_SCAN pour sélectionner des colonnes spécifiques à partir de la sortie de la commande SHOW ou pour filtrer les lignes.

Lorsque vous faites référence aux colonnes de sortie, utilisez des identificateurs entre guillemets doubles pour les noms des colonnes. Par exemple, pour sélectionner la colonne de sortie type, spécifiez SELECT "type".

Vous devez utiliser des identificateurs entre guillemets doubles, car les noms des colonnes de sortie pour les commandes SHOW sont en minuscules. Les guillemets doubles garantissent que les noms des colonnes dans la liste SELECT ou dans la clause WHERE correspondent aux noms des colonnes dans la sortie de la commande SHOW qui a été analysée.

Sortie¶

La sortie de la commande fournit les propriétés et les métadonnées de l’annonce dans les colonnes suivantes :

Colonne	Description
`global_name`	Nom global de la liste
`name`	Nom spécifié lors de la création de l’annonce.
`owner`	Propriétaire de la liste.
`owner_role_type`	Type de rôle du propriétaire de la liste.
`created_on`	Date et heure de création de la liste.
`updated_on`	Date et heure de la dernière mise à jour de la liste.
`published_on`	Date et heure de la dernière publication de la liste.
`title`	Titre spécifié dans le manifeste de l’annonce
`subtitle`	Sous-titre spécifié dans le manifeste de l’annonce
`description`	The listing description.
`listing_terms`	Conditions de la liste.
`state`	État de l’annonce ; l’un des états suivants : DRAFT PUBLISHED UNPUBLISHED
`share`	Identificateur de partage pour cette annonce.
`application_package`	Paquet d’application associé à la liste.
`business_needs`	Besoins de l’entreprise remplis par la liste.
`usage_examples`	Exemple montrant une requête de l’annonce.
`data_attributes`	Attributs de l’annonce, notamment la fréquence d’actualisation, la couverture géographique et l’intervalle de temps.
`categories`	Catégories de la liste.
`resources`	Ressources de l’annonce, par exemple un lien de documentation.
`profile`	Nom du profil du fournisseur.
`customized_contact_info`	Informations de contact du fournisseur.
`data_dictionary`	Métadonnées des listes.
`data_preview`	Preview of the listing data.
`comment`	Commentaire associé, le cas échéant.
`revisions`	État d’examen, pour les listes publiques uniquement.
`target_accounts`	Liste de comptes cibles séparés par des virgules.
`regions`	Régions de la liste.
`refresh_schedule`	Fréquence d’actualisation de la liste en minutes.
`refresh_type`	Type d’actualisation de la liste.
`review_state`	État d’examen de la liste.
`rejection_reason`	Motif de rejet de la liste.
`unpublished_by_admin_reasons`	Motif pour lequel le propriétaire de la liste n’a pas publié la liste.
`is_monetized`	Indicateur de monétisation.
`is_application`	Is application flag. If `true`, an application package is attached to the listing.
`is_targeted`	Indicateur de ciblage.
`is_limited_trial`	Is limited trial flag.
`is_by_request`	Indicateur de demande.
`limited_trial_plan`	The plan associated with a limited trial listing.
`retired_on`	Date and time the listing was retired. Null if not retired.
`scheduled_drop_time`	Date et heure prévues pour la suppression de l’annonce (qui deviendra indisponible pour les consommateurs existants). Null si non planifiée.
`manifest_yaml`	Intégralité du manifeste publié lorsque `REVISION` est `PUBLISHED`, et intégralité du manifeste publié avec modifications projetées lorsque `REVISION` est `DRAFT`.
`distribution`	Détails de la distribution, le cas échéant, tels que `EXTERNAL`.
`is_mountless_queryable`	`true` si l’annonce peut être interrogée sans être montée ; sinon, `false`.
`organization_profile_name`	Nom du profil de l’organisation associée.
`uniform_listing_locator`	Localisateur d’annonces uniformes (ULL). Pour plus d’informations sur ULLs, voir Configurer les annonces d’organisation.
`trial_details`	Details associated with trial listings.
`approver_contact`	Approver contact information.
`support_contact`	Support contact information.
`live_version_uri`	Indicateur uniforme de ressources complet (URI) de la version active de l’annonce, sur laquelle des opérations de zone de préparation peuvent être effectuées. NULL si aucune version active de l’annonce n’existe.
`last_committed_version_uri`	Full URI of the last committed version of the listing.
`last_committed_version_name`	Nom généré par le système de la dernière version validée de l’annonce.
`last_committed_version_alias`	User-specified alias for the last committed version of the listing.
`published_version_uri`	Full URI of the current published version of the listing.
`published_version_name`	System-generated name of the published version of the listing.
`published_version_alias`	User-specified alias for the last published version of the listing.
`compliance_badges`	Compliance badges associated with this listing, if any.
`is_share`	Indicateur de partage. Si `true`, l’annonce a été créée en fonction d’un partage.
`monetization_version`	Modèle de monétisation utilisé par l’annonce.
`request_approval_type`	Listing access request type. The access request type defines how discovery targets of a listing submit access requests to the listing approver. Any one of: `NULL` `REQUEST_AND_APPROVE_IN_SNOWFLAKE` indique que les demandes d’accès sont soumises et approuvées dans l’environnement Snowflake. `REQUEST_AND_APPROVE_OUTSIDE_SNOWFLAKE` indique que le fournisseur gère les soumissions et les approbations de demandes d’accès de manière indépendante. La valeur pour les annonces externes est toujours `NULL`.
`monetization_display_order`	Ordre dans lequel les plans et les offres tarifaires sont présentés aux consommateurs.
`legacy_uniform_listing_locator`	Spécifie le localisateur d’annonces uniformes hérité (ULL). Si un profil d’annonce d’organisation existant est mis à jour pour utiliser un profil d’organisation personnalisé, cette colonne comprend l’ULL associé au profil par défaut précédent encore valide. Si aucune mise à jour du profil n’a été effectuée, cette colonne est NULL. Pour plus d’informations sur les ULLs, voir Définir le localisateur d’annonce uniforme ou le nom de l’annonce.
`share_restrictions`	Indicateur qui signale si des restrictions de partage existent pour les annonces privées externes.

Exemples¶

To describe the columns in a listing named MYLISTING, run the following command:

DESC LISTING MYLISTING;

Copy