DESCRIBE LISTING¶

Décrit les colonnes d’une annonce.

DESCRIBE peut être abrégé en DESC.

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

Syntaxe¶

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

Copy

Paramètres¶

name

Spécifie l’identificateur spécifié lors de la création de l’annonce à 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.

Voir SHOW LISTINGS pour des informations détaillées sur l’annonce, notamment le nom de l’annonce.

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 fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogé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`	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.

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   |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+
|   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""}" |                                 |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+