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.

For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

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