SHOW VERSIONS IN DBT PROJECT

Affiche une liste de toutes les versions d’un objet de projet dbt.

Voir aussi :

ALTER DBT PROJECT, DESCRIBE DBT PROJECT, EXECUTE DBT PROJECT, SHOW DBT PROJECTS, DROP DBT PROJECT

Syntaxe

SHOW VERSIONS IN DBT PROJECT <name>
  [ LIMIT <number> ]
Copy

Paramètres

name

Chaîne qui spécifie l’identificateur (c’est-à-dire le nom) de l’objet de projet dbt dans Snowflake ; doit être unique pour le schéma dans lequel le projet dbt est créé.

De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (par exemple, "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

LIMIT rows

(Facultatif) Limite le nombre maximum de lignes renvoyées. 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.

Par défaut : aucune valeur (aucune limite n’est appliquée à la sortie).

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

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège

Objet

USAGE

L’objet du projet dbt

MONITOR

L’objet du projet dbt

OWNERSHIP

L’objet du projet dbt

Notes sur l’utilisation

  • La commande ne nécessite pas l’exécution d’un entrepôt en cours d’exécution.

  • La commande ne renvoie que les objets pour lesquels le rôle actuel de l’utilisateur s’est vu accorder au moins un privilège d’accès.

  • Le privilège d’accès MANAGE GRANTS permet implicitement à son titulaire de voir tous les objets du compte. Par défaut, seuls l’administrateur du compte (utilisateurs avec le rôle ACCOUNTADMIN) et l’administrateur de sécurité (utilisateurs avec le rôle SECURITYADMIN) ont le privilège MANAGE GRANTS.

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser l’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 pour 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.

Sortie

La sortie de la commande fournit les propriétés des tables et les métadonnées sur les versions des projets dbt dans les colonnes suivantes :

Colonne

Description

created_on

Date et heure de création de l’objet de projet dbt.

name

Le nom automatiquement attribué de la version du projet dbt. Par exemple, VERSION$1.

alias

L’alias du projet dbt que vous avez attribué (par exemple, ALTER DBT PROJECT <name> ADD VERSION <alias> FROM ...). Null si non spécifié.

location_uri

URL complète de la version du projet dbt.

is_default

TRUE si la version par défaut de l’objet du projet dbt pointe vers cette version.

is_live

TRUE si la version du projet dbt est une version en direct de l’annonce.

is_first

TRUE si le projet dbt est la première version.

is_last

TRUE si le projet dbt est la dernière version.

comment

Commentaire défini sur le projet dbt.

source_location_uri

L’URI d’emplacement source à partir duquel cette version de projet dbt est créée.

git_commit_hash

Le hachage de commit git, si la version du projet dbt a été créée à partir d’une source git.

Exemples

Afficher toutes les versions de my_dbt_project :

SHOW VERSIONS IN DBT PROJECT my_dbt_project;
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:24.550 -0800 | VERSION$2 | null  |  snow://dbtproject/mydb.my_schema.my_dbt_project/versions/version$2/ | TRUE       | FALSE   | FALSE    |  TRUE   | null    | null                | null            |
|   2025-01-08 11:17:32.894 -0800 | VERSION$1 | null  |  snow://dbtproject/mydb.my_schema.my_dbt_project/versions/version$2/ | FALSE      | FALSE   | TRUE     |  FALSE  | null    | null                | null            |
+---------------------------------+-----------+------------------------------+-----------------------------------------------+------------+--------------------+---------+---------+---------------------+-----------------+
Langage: Français