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 fonction RESULT_SCAN qui traite la sortie sous forme de table à interroger. Vous pouvez également utiliser l”opérateur de canal pour interroger la sortie de cette commande.

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