Kategorien:: Information Schema, Tabellenfunktionen

DBT_PROJECT_EXECUTION_HISTORY¶

Gibt den Ausführungsverlauf für dbt-Projekte in Snowflake zurück.

Rufen Sie diese Funktion auf, um Metadaten und Ergebnisse von früheren dbt-Projektausführungen innerhalb von sieben Tagen nach dem aktuellen Zeitpunkt zu erhalten. Geben Sie optional die Werte an, nach denen die Ergebnisse gefiltert werden sollen.

Verwenden Sie diese Funktion mit den folgenden Systemfunktionen für den programmgesteuerten Zugriff auf dbt-Artefakte und -Protokolle:

Weitere Informationen dazu finden Sie unter Programmgesteuert auf dbt-Artefakte und -Protokolle zugreifen.

Siehe auch:: CREATE DBT PROJECT, EXECUTE DBT PROJECT

Syntax¶

DBT_PROJECT_EXECUTION_HISTORY (
  [ OBJECT_NAME => '<name>' ]
  [ , OBJECT_TYPE = { WORKSPACE | DBT PROJECT }]
  [ , START_TIME_RANGE_START => <start_time> ]
  [ , START_TIME_RANGE_END => <end_time>  ]
  [ , RESULT_LIMIT = <integer> ]
  [ , COMMAND = <dbt_command> ]
  [ , USER_NAME = <user_name> ]
  [ , DATABASE = <db_name> ]
  [ , SCHEMA = <schema_name> ]
)

Copy

Argumente¶

OBJECT_NAME = <name>

Name des Arbeitsbereichs oder des dbt-Projekts, zu dem die Ausführung gehört.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

OBJECT_TYPE = { WORKSPACE | DBT PROJECT }

Typ des Objekts, WORKSPACE oder DBT PROJECT, zu dem die Ausführung gehört.

START_TIME_RANGE_START | START_TIME_RANGE_END = timestamp

Zeitstempel zum Filtern eines Bereichs von dbt-Projektausführungen.

RESULT_LIMIT = integer

Eine Ganzzahl, die die maximale Anzahl der von der Funktion zurückgegebenen Zeilen angibt, von 1 bis einschließlich 10.000.

Standard: 100

COMMAND = dbt_command

Gibt den dbt-Befehl an, der zum Ausführen des dbt-Projekts verwendet wird.

USER_NAME = user_name

Name des Benutzers, der die Ausführung des dbt-Projektobjekts initiiert hat.

DATABASE = db_name

Gibt nur Datensätze für die angegebene Datenbank zurück.

SCHEMA = schema_name

Gibt nur Datensätze für das angegebene Schema zurück.

Ausgabe¶

Die Funktion gibt die folgenden Spalten zurück:

Um diese Spalten anzuzeigen, müssen Sie eine Rolle mit der Berechtigung MONITOR verwenden.

Spaltenname	Datentyp	Beschreibung
QUERY_ID	TEXT	Die ID der Abfrage.
QUERY_START_TIME	TIMESTAMP_LTZ	Zeitpunkt, an dem die Abfrage gestartet wurde.
QUERY_END_TIME	TIMESTAMP_LTZ	Zeitpunkt, zu dem die Abfrage beendet wurde.
USER_NAME	TEXT	Der Benutzende, der das dbt-Projekt erstellt hat.
OBJECT_NAME	TEXT	Name des Arbeitsbereichs oder des dbt-Projekts, zu dem die Ausführung gehörte.
OBJECT_TYPE	TEXT	Typ des Objekts, z. B. WORKSPACE oder DBT PROJECT.
DATABASE_NAME	TEXT	Datenbank des Objekts.
SCHEMA_NAME	TEXT	Schema des Objekts.
COMMAND	TEXT	Der Befehl, der für das Objekt ausgeführt wurde.
ARGS	TEXT	Die Argumente, die in der Ausführung für das Objekt verwendet wurden.
ERROR_CODE	NUMBER	Falls zutreffend, der Fehlercode für die Ausführung.
ERROR_MESSAGE	TEXT	Gegebenenfalls Fehlermeldung, die angibt, warum die Ausführung fehlgeschlagen ist.
WAREHOUSE	TEXT	Warehouse, das für das Objekt verwendet wird.
STATE	TEXT	Status der Ausführung, z. B. HANDLED_ERROR oder SUCCESS.

Anforderungen an die Zugriffssteuerung¶

Diese Tabellenfunktion umfasst nur Ausführungen aus Arbeitsbereichen und dbt-Projekten, in denen Sie über die folgenden Berechtigungen verfügen:

OWNERSHIP oder USAGE für Arbeitsbereiche
OWNERSHIP, USAGE oder MONITOR für dbt-Projekte

Nutzungshinweise¶

Verwenden Sie den exakten Namen des dbt-Projekts (Groß-/Kleinschreibung wird berücksichtigt, wenn die Erstellung mit Anführungszeichen erfolgte). Wenn keine Zeile übereinstimmt (falscher Name des dbt-Projekts oder noch keine Ausführungen), erhalten Sie möglicherweise den Fehler Inputs may not be null..

Beispiele¶

Beispiele für die Verwendung der Tabellenfunktion DBT_PROJECT_EXECUTION_HISTORY finden Sie unter Programmgesteuert auf dbt-Artefakte und -Protokolle zugreifen.