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> ]
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 |
---|---|
|
Date et heure de création de la version. |
|
Nom de la version généré par le système. |
|
Alias de la version spécifié par l’utilisateur. |
|
URL complète de la version, par rapport à laquelle des opérations en zone de préparation peuvent être effectuées. |
|
Identifie la version de listing qui est publiée. |
|
Identifie si la version est une version en direct du listing. |
|
Identifie si la version est la première version du listing. |
|
Identifie si la version est la dernière version du listing. |
|
Commentaires facultatifs sur la version de listing. |
|
URL d’emplacement de la source à partir de laquelle cette version est créée. |
|
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épasser10000
. SiLIMIT 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.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.
Exemples¶
Afficher toutes les versions du listing MYLISTING :
SHOW VERSIONS IN LISTING MYLISTING
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
| 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 | |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+