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¶

Pour décrire (DESCRIBE) une liste, vous devez utiliser un rôle qui possède l’un des privilèges suivants sur l’annonce : USAGE, MODIFY ou OWNERSHIP.

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.

Les noms des colonnes de sortie de cette commande sont générés en minuscules. Si vous consommez un jeu de résultats de cette commande avec l’opérateur de canal ou la fonction RESULT_SCAN, utilisez des identificateurs entre guillemets doubles pour les noms de colonnes de la requête, afin de vous assurer qu’ils correspondent aux noms de colonnes dans la sortie analysée. Par exemple, si le nom d’une colonne de sortie est type, spécifiez "type" pour l’identificateur.

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`	Description de la liste.
`target_accounts`	Liste de comptes cibles séparés par des virgules.
`is_monetized`	Indicateur de monétisation.
`is_application`	Indicateur d’application. Si un paquet d’application `true` est joint à la liste.
`is_targeted`	Indicateur de ciblage.
`state`	État de l’annonce ; l’un des états suivants : DRAFT PUBLISHED UNPUBLISHED
`revisions`	État d’examen, pour les listes publiques uniquement.
`comment`	Commentaire associé, le cas échéant.
`refresh_schedule`	Fréquence d’actualisation de la liste en minutes.
`refresh_type`	Type d’actualisation de la liste.
`business_needs`	Besoins de l’entreprise remplis par la liste.
`usage_examples`	Cas d’utilisation de la liste.
`listing_terms`	Conditions de la liste.
`profile`	Nom du profil du fournisseur tel que spécifié dans le manifeste de l’annonce.
`customized_contact_info`	Informations de contact du fournisseur.
`application_package`	Paquet d’application associé à la liste.
`data_dictionary`	Métadonnées des listes.
`regions`	Régions de la liste.
`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`.
`review_state`	État d’examen de la liste.
`rejection_reason`	Motif de rejet de la liste.
`categories`	Catégories de la liste.
`resources`	Ressources de la liste.
`unpublished_by_admin_reasons`	Motif pour lequel le propriétaire de la liste n’a pas publié la liste.
`request_approval_type`	Affiche le type de demande d’accès à l’annonce. Le type de demande d’accès définit la manière dont les cibles de découverte d’une annonce soumettent des demandes d’accès à l’approbateur de l’annonce. L’un ou l’autre des états suivants : `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`.

Exemples¶

Décrivez les colonnes de l’annonce nommée MYLISTING :

DESC LISTING MYLISTING;

Copy

+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+-----------------------+
|   global_name                |   name              |   owner          |   owner_role_type   |   created_on                         |   updated_on                         |   published_on                       |   title                                                        |   subtitle                                         |   description                                                                                                              |   target_accounts   |   is_monetized   |   is_application   |   is_targeted   |   state       |   revisions         |   comment   |   refresh_schedule   |   refresh_type    |   business_needs                                                                                                                                         |   usage_examples                                                                                                     |   listing_terms         |   profile                                        |   customized_contact_info   |  application_package |  data_dictionary                                                                                                                   |   regions   |   manifest_yaml                                                                   |   review_state   |   rejection_reason   |   categories   |   resources                                                                                                     |   unpublished_by_admin_reason   | request_approval_type |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+-----------------------+
|   GZ13Z1VEWNG                |   CDC_COVID_19_DATA |   ACCOUNTADMIN   |   ROLE              |   2023-12-01T13:01:13.367-08:00      |   2023-12-01T13:25:11.331-08:00      |   2023-12-01T13:25:11.331-08:00      |   Understanding COVID-19: Explore the Latest Data from the CDC |   Track cases, deaths, vaccination rates, and more |   Get the most up-to-date information on the COVID-19 pandemic from the Centers for Disease Control and Prevention (CDC).  |                     |   false          |   false            |   false         |   PUBLISHED   |   DRAFT,PUBLISHED   |             |   60 MINUTE          |   FULL_DATABASE   |   [{""type"":""CUSTOM"",""name"":""Public Health Monitoring and Response"",""description"":""Monitor trends in cases, deaths, and other key metrics.""}] |   [{""title"":""Identify potential outbreaks of COVID-19 in [country name] by tracking trends in confirmed cases"    |   {"type":"STANDARD"}   |   RAVENCLAW_9A314599_F644_4664_946B_4DE0B2169C28 |                             |                      |  {""database"":""COVIDDATADB"",""objects"":[{""schema"":""PUBLIC"",""domain"":""TABLE"",""name"":""GLOBAL_COVID_STATISTICS""}]}"   |   ALL       |   title: "Understanding COVID-19: Explore the Latest Data from the CDC"  . . .    |                  |                      |   HEALTH       |   "{""documentation"":""https://snowflake.com/doc"",""media"":""https://www.youtube.com/watch?v=AR88dZG-hwo""}" |                                 | NULL                  |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+-----------------------+