Visualiser et gérer les informations des projets dbt existants¶

Cette rubrique explique comment explorer la structure et les métadonnées d’un objet de projet dbt existant. Cela inclut l’affichage des DAG du projet, l’inspection des détails du modèle et de la source, et l’exécution des projets dbt.

Parcourir le DAG du projet pour voir la lignée du modèle et les dépendances¶

Le Directed Acyclic Graph (DAG) montre comment les modèles dbt dépendent les uns des autres, en visualisant la lignée des données afin que vous puissiez :

Vérifier où un modèle est construit (database.schema), comment il se matérialise et quelles dépendances en amont et en aval il possède.
Détecter et améliorer les conceptions de modèles inefficaces pour prendre en charge l’amélioration des performances et de la mise à l’échelle.

Pour parcourir le projet DAG dans Snowsight, accédez à Databases`|ra| votre base de données |ra| votre schéma |ra|:ui:`dbt Projects et sélectionnez votre projet. La page de détails du projet affiche le Graph de vos modèles et de leurs relations, ainsi qu’une Description de votre projet, la dbt Project definition, et les Privileges.

Dans le Graph, cliquez sur un nœud de modèle pour inspecter les détails du modèle, de la source ou du test (tel que le SQL compilé et la configuration) directement à partir du DAG.

Astuce

Si vous travaillez dans un espace de travail, vous pouvez également accéder à la page de détails du projet en sélectionnant Connect » View project de l’éditeur d’espace de travail. Pour plus d’informations, voir Workspaces for dbt Projects on Snowflake.

Inspecter les détails du modèle à partir du DAG¶

Lorsque vous sélectionnez un nœud de modèle dans le DAG, la vue des détails du modèle s’ouvre, affichant :

Le type du modèle, le chemin d’accès au fichier, l’objet cible, le nombre de lignes et le nombre de colonnes.
Une description du modèle (s’il est défini dans le projet dbt).
La lignée du modèle, la liste des dépendances en amont et en aval avec des liens pour naviguer entre elles.
Le SQL source et compilé pour le modèle.

Exécuter des modèles à partir du DAG¶

Vous pouvez exécuter un sous-ensemble de votre projet dbt directement depuis le DAG en sélectionnant le menu … sur un nœud de modèle. Les options d’exécution suivantes sont disponibles :


Options de menu	Ce qu’il exécute	Indicateur `--select` équivalent
Execute model	Uniquement le modèle sélectionné	`--select model_name`
Execute model+	Le modèle et toutes les dépendances en aval	`--select model_name+`
Execute +model	Le modèle et tous les parents en amont	`--select +model_name`
Execute +model+	Le modèle, ses parents et ses enfants	`--select +model_name+`

La sélection d’une option ouvre la boîte de dialogue Execute dbt project avec le champ Additional flags prérempli avec la valeur --select correspondante. À partir de la boîte de dialogue, vous pouvez :

Choisir l’opération, par exemple Run, Test, ou Build.
Choisir la cible de profil (par exemple, dev ou prod).
Modifier les indicateurs avant l’exécution si vous souhaitez affiner la sélection.

Vous pouvez utiliser la même syntaxe --select avec les opérateurs de graphique + dans SQL et le CLI Snowflake :

EXECUTE DBT PROJECT my_dbt_project
  ARGS = 'build --select +stg_customers+ --target dev';

Pour plus d’informations sur les commandes et les indicateurs dbt pris en charge, voir Commandes et indicateurs dbt pris en charge.

Afficher les propriétés de l’objet de projet dbt¶

Consultez les métadonnées que Snowflake stocke sur un objet de projet dbt pour voir comment il s’appelle, qui en est propriétaire, quelle version est la version par défaut et où se trouvent ses fichiers dans la zone de préparation interne snow://dbt/... de Snowflake.

Pour voir les propriétés (telles que le nom, le propriétaire, le commentaire) d’un projet dbt spécifique, utilisez la commande DESCRIBE DBT PROJECT comme le montre l’exemple suivant :

DESCRIBE DBT PROJECT my_dbt_project;

La sortie indique le nom de l’objet, le propriétaire, le commentaire, les détails de la gestion des versions et l’intégration d’accès externe. Pour plus d’informations, voir DESCRIBE DBT PROJECT.

Voir tous les projets dbt¶

Utilisez SHOW DBT PROJECTS lorsque vous souhaitez voir tous les objets de projet dbt auxquels vous pouvez accéder, plus les métadonnées clés.

SHOW DBT PROJECTS IN DATABASE mydb;

La sortie affiche la base de données, le schéma, le propriétaire, le commentaire de chaque objet, la date de sa création et de sa dernière mise à jour, les détails de gestion des versions et l’intégration d’accès externe. Pour plus d’informations, voir SHOW DBT PROJECTS.

Vous pouvez également utiliser la commande snow dbt list. Pour plus d’informations, voir Répertorier tous les objets de projet dbt disponibles.