SHOW VERSIONS IN LISTING¶

Répertorie et fournit des détails sur toutes les versions des listings.

Voir aussi :: CREATE LISTING, ALTER LISTING, DESCRIBE LISTING, DROP LISTING

Syntaxe¶

SHOW VERSIONS IN LISTING <name>
  [ LIMIT <rows> ]

Copy

Paramètres¶

name

Indique l’identificateur (le nom) de l’annonce. 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.

Pour plus d’informations, voir Exigences relatives aux identificateurs.

LIMIT rows

(Facultatif) Limite le nombre maximum de lignes retournées, tout en permettant la « pagination » des résultats. Le nombre réel de lignes renvoyées peut être inférieur à la limite spécifiée. Par exemple, le nombre d’objets existants est inférieur à la limite spécifiée.

Sortie¶

La sortie de la commande comprend les colonnes suivantes, qui décrivent les propriétés et les métadonnées de l’objet :

Colonne	Description
`created_on`	Date et heure de création de la version.
`name`	Nom de la version généré par le système.
`alias`	Alias de la version spécifié par l’utilisateur.
`location_url`	URL complète de la version, par rapport à laquelle des opérations en zone de préparation peuvent être effectuées.
`is_default`	Identifie la version de listing qui est publiée.
`is_live`	Identifie si la version est une version en direct du listing.
`is_first`	Identifie si la version est la première version du listing.
`is_last`	Identifie si la version est la dernière version du listing.
`comment`	Commentaires facultatifs sur la version de listing.
`source_location_url`	URL d’emplacement de la source à partir de laquelle cette version est créée.
`git_commit_hash`	Hachage de validation Git, si la version est créée à partir d’une source Git.

Exigences en matière de contrôle d’accès¶

Pour afficher les versions d’un listing, vous devez utiliser un rôle disposant du privilège USAGE ou OWNERSHIP sur le listing.

Notes sur l’utilisation¶

La valeur de LIMIT rows ne peut pas dépasser 10000. Si LIMIT rows est omis, la commande entraîne une erreur si le jeu de résultats est supérieur à dix mille lignes.

Pour afficher les résultats pour lesquels il existe plus de dix mille enregistrements, vous devez inclure LIMIT rows ou interroger la vue correspondante dans Schéma d’information de Snowflake.

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 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 commande SHOW qui a été analysée.

Exemples¶

Afficher toutes les versions du listing MYLISTING :

SHOW VERSIONS IN LISTING MYLISTING

Copy

+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
|             created_on            |             name             |             alias            |                  location_uri                 |     is_default     |       is_live      |      is_first      |       is_last      |                   comment                   |          source_location_uri          |             git_commit_hash           |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
|   2025-01-08 11:18:39.921 -0800   |                              |                              |  snow://listing/MYLISTING/versions/live/      |        FALSE       |        TRUE        |        FALSE       |       FALSE        |                                             |            @listingstage              |                                       |
|   2025-01-08 11:18:24.550 -0800   |        VERSION$2             |                              |  snow://listing/MYLISTING/versions/version$2/ |        TRUE        |        FALSE       |        FALSE       |       TRUE         |                                             |            @listingstage              |                                       |
|   2025-01-08 11:17:32.894 -0800   |        VERSION$1             |                              |  snow://listing/MYLISTING/versions/version$1/ |        FALSE       |        FALSE       |        TRUE        |       FALSE        |                                             |            @listingstage              |                                       |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+