Informationen zu bestehenden dbt-Projekten anzeigen und verwalten¶

In diesem Thema wird beschrieben, wie Sie die Struktur und die Metadaten eines vorhandenen dbt-Projektobjekts untersuchen können. Dazu gehört das Anzeigen des DAG des Projekts, das Prüfen von Modell- und Quellendetails und das Ausführen von dbt-Projekten.

Den DAG des Projekts durchsuchen, um Modellherkunft und Abhängigkeiten zu sehen¶

Der Directed Acyclic Graph DAG) zeigt, wie dbt-Modelle voneinander abhängen und visualisiert die Datenherkunft, sodass Sie Folgendes tun können:

Überprüfen, wo ein Modell erstellt wird (database.schema), wie es materialisiert wird und welche vor- und nachgelagerten Abhängigkeiten es hat
Erkennen und Verbessern von ineffiziente Modellentwürfen, um Leistung und Skalierbarkeit zu verbessern

Um das Projekt DAG in Snowsight zu durchsuchen, navigieren Sie zu Databases », Ihrer Datenbank » Ihrem Schema » dbt Projects und wählen Sie Ihr Projekt aus. Die Projektdetailseite zeigt das Graph Ihrer Modelle und deren Beziehungen sowie eine Description Ihres Projekts, die dbt Project definition und Privileges.

Klicken Sie in Graph auf einen Modellknoten, um das Modell, die Quelle oder die Testdetails (z. B. kompilierte SQL und die entsprechende Konfiguration) direkt über das DAG zu prüfen.

Tipp

Wenn Sie in einem Arbeitsbereich arbeiten, können Sie die Seite mit den Projektdetails auch erreichen, indem Sie Connect`|ra|:ui:`View project aus dem Workspace-Editor auswählen. Weitere Informationen dazu finden Sie unter Workspaces for dbt Projects on Snowflake.

Prüfen der Modelldetails in DAG¶

Wenn Sie einen Modellknoten in DAG ausführen, öffnet sich die Ansicht mit den Modelldetails und enthält Folgendes:

Der Typ des Modells, der Dateipfad, das Zielobjekt, die Zeilen- und Spaltenanzahl.
Eine Beschreibung des Modells (falls eine im dbt-Projekt definiert ist).
Modell-Lineage mit einer Auflistung von Upstream- und Downstream-Abhängigkeiten sowie Links zur Navigation zwischen diesen.
Die Quell- und kompilierte SQL für das Modell.

Ausführen von Modellen aus DAG¶

Sie können eine Teilmenge Ihres dbt-Projekts direkt über DAG ausführen, indem Sie das …-Menü auf einem Modellknoten auswählen. Die folgenden Ausführungsoptionen sind verfügbar:


Menüoption	Was ausgeführt wird	`--select`-Äquivalent
Execute model	Nur das ausgewählte Modell	`--select model_name`
Execute model+	Das Modell und alle nachgelagerten Abhängigen	`--select model_name+`
Execute +model	Das Modell und alle vorgelagerten Modelle	`--select +model_name`
Execute +model+	Das Modell, seine übergeordneten Modelle und seine untergeordneten Modelle	`--select +model_name+`

Wenn Sie eine Option auswählen, wird der Execute dbt project-Dialog mit dem:ui:Additional flags-Feld geöffnet, das mit dem entsprechenden --select-Wert bereits ausgefüllt ist. Funktionen im Dialogfeld:

Wählen Sie Vorgänge wie Run ,:ui:Test oder:ui:Build.
Wählen Sie das Profilziel (z. B.:ui:dev oder prod).
Bearbeiten Sie die Flags vor dem Ausführen, falls Sie die Auswahl genauer definieren möchten.

Sie können dieselbe --select-Syntax mit den +-Graphoperatoren in SQL und in der Snowflake CLI verwenden:

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

Weitere Informationen zu unterstützten dbt-Befehlen und -Flags finden Sie unter Unterstützte dbt-Befehle und -Flags.

Eigenschaften der dbt-Projektobjekte anzeigen¶

Sehen Sie sich die Metadaten an, die Snowflake zu einem dbt-Projektobjekt speichert, um zu sehen, wie es heißt, wem es gehört, welche Version die Standardversion ist und wo sich die Dateien im internen snow://dbt/...-Stagingbereich von Snowflake befinden.

Um die Eigenschaften (wie beispielsweise Name, Eigentümer, Kommentar) eines bestimmten dbt-Projekts anzuzeigen, verwenden Sie den Befehl DESCRIBE DBT PROJECT, wie im folgenden Beispiel gezeigt:

DESCRIBE DBT PROJECT my_dbt_project;

Die Ausgabe zeigt den Namen des Objekts, den Eigentümer, den Kommentar, die Versionsdetails und die Integration für den externen Zugriff an. Weitere Informationen dazu finden Sie unter DESCRIBE DBT PROJECT.

Alle dbt-Projekte anzeigen¶

Verwenden Sie SHOW DBT PROJECTS, wenn Sie alle dbt-Projektobjekte, auf die Sie zugreifen können, sowie die wichtigsten Metadaten anzeigen möchten.

SHOW DBT PROJECTS IN DATABASE mydb;

Die Ausgabe zeigt die Datenbank, das Schema, den Eigentümer und den Kommentar jedes einzelnen Objekts an, wann es erstellt und zuletzt aktualisiert wurde, die Versionsdetails und die Integration für den externen Zugriff. Weitere Informationen dazu finden Sie unter SHOW DBT PROJECTS.

Verwenden Sie alternativ den Befehl snow dbt list. Weitere Informationen dazu finden Sie unter Auflisten aller verfügbaren dbt-Projektobjekte.