Kategorien:: Information Schema, Tabellenfunktionen

DYNAMIC_TABLE_GRAPH_HISTORY¶

Diese Tabellenfunktion gibt Informationen zu allen dynamischen Tabellen im aktuellen Konto zurück. Diese Informationen beinhalten die Abhängigkeiten zwischen dynamischen Tabellen und von Basistabellen. Eine häufige Verwendung ist das Identifizieren aller dynamischen Tabellen, die Teil einer Pipeline sind.

In der Ausgabe dieser Funktion repräsentiert jede Zeile eine dynamische Tabelle. Die Spalten VALID_FROM und VALID_TO geben die Zeitspanne an, in der die Beschreibung einer dynamischen Tabelle gültig war (d. h. die dynamische Tabelle genau beschrieben war).

Änderungen an einer dynamischen Tabelle, wie z. B. das Ändern des TARGET_LAG-Ergebnisses, führen zum Erstellen neuer Einträge.

Diese Tabellenfunktion liefert nur Beschreibungen mit einem VALID_TO-Wert innerhalb von 1 Tag nach der aktuellen Zeit.

Syntax¶

DYNAMIC_TABLE_GRAPH_HISTORY(
  [ AS_OF => <constant_expr> ]
  [ , HISTORY_START => <constant_expr> [ , HISTORY_END => <constant_expr> ] ]
)

Copy

Argumente¶

Alle Argumente sind optional. Wenn keine Argumente angegeben werden, wird nur die aktuelle Beschreibung der derzeit vorhandenen dynamischen Tabellen zurückgegeben.

AS_OF => constant_expr: Zeitpunkt (im Format TIMESTAMP_LTZ), zu dem der Status des Task-Graphen zurückgegeben werden soll. Sie können einen Zeitpunkt angeben, der einem Wert in der Spalte REFRESH_VERSION in der Ausgabe der Funktion DYNAMIC_TABLE_REFRESH_HISTORY entspricht.
HISTORY_START => constant_expr, . HISTORY_END => constant_expr: Der Zeitbereich (Datum/Uhrzeit) der Aktualisierungshistorie der dynamischen Tabelle. HISTORY_START gibt den frühesten Zeitpunkt (Datum/Uhrzeit) an, zu dem Daten zurückgegeben werden sollen. HISTORY_END, das mit HISTORY_START angegeben werden muss, gibt den Endzeitpunkt (Datum/Uhrzeit) für die Rückgabe der Daten an.

Ausgabe¶

Die Funktion gibt die folgenden Spalten zurück:

Spaltenname	Datentyp	Beschreibung
NAME	TEXT	Name der dynamischen Tabelle.
SCHEMA_NAME	TEXT	Name des Schemas, das die dynamische Tabelle enthält.
DATABASE_NAME	TEXT	Name der Datenbank, die die dynamische Tabelle enthält.
QUALIFIED_NAME	TEXT	Vollqualifizierter Name der dynamischen Tabelle, wie er im Task-Graph der dynamischen Tabellen angezeigt wird. Sie können dies verwenden, um die Ausgabe mit der Ausgabe der Funktion DYNAMIC_TABLE_REFRESH_HISTORY zu verknüpfen.
INPUTS	ARRAY von OBJECTs	Jedes OBJECT repräsentiert eine Tabelle, Ansicht oder dynamische Tabelle, die als Eingabe für diese dynamische Tabelle dient, und aus Folgendem besteht: `name` (TEXT): vollqualifizierter Name. `kind` (TEXT): Typ der Eingabe (TABLE,VIEW oder DYNAMIC TABLE).
TARGET_LAG_TYPE	TEXT	Eine der folgenden Optionen: USER_DEFINED - Bestimmt durch den Parameter TARGET_LAG, der für die dynamische Tabelle angegeben wurde. DOWNSTREAM - Zeigt eine dynamische Tabelle mit einem DOWNSTREAM TARGET_LAG an. Weitere Informationen dazu finden Sie unter Erläuterungen zum Aktualisieren von dynamischen Tabellen.
TARGET_LAG_SEC	NUMBER	Die Zielverzögerungszeit in Sekunden für diese dynamische Tabelle. Dies ist der Wert, der im Parameter TARGET_LAG der dynamischen Tabelle angegeben ist.
QUERY_TEXT	TEXT	Die SELECT-Anweisung für diese dynamische Tabelle.
VALID_FROM	TIMESTAMP_LTZ	Die Beschreibung der dynamischen Tabelle ist nach diesem Zeitpunkt gültig.
VALID_TO	TIMESTAMP_LTZ	Wenn vorhanden, war die Beschreibung der dynamischen Tabelle bis zu diesem Zeitpunkt gültig. Falls nicht vorhanden, ist die Beschreibung immer noch gültig.
SCHEDULING_STATE	OBJECT	OBJECT, das aus Folgendem besteht: `state` (TEXT): Zeitplanungsstatus (RUNNING oder SUSPENDED). `reason_code` (TEXT): Optionaler Grund, wenn der Zustand nicht RUNNING ist. `reason_message` (TEXT): Textbeschreibung des Grundes, warum die dynamische Tabelle nicht ausgeführt wird. Gilt nur, wenn Status nicht RUNNING ist. `suspended_on` (TIMESTAMP_LTZ): Optionaler Zeitstempel für den Zeitpunkt, wann die dynamische Tabelle ausgesetzt wurde. `resumed_on` (TIMESTAMP_LTZ): Optionaler Zeitstempel für den Zeitstempel, wann sie zuletzt wieder fortgesetzt wurde, falls die dynamische Tabelle den Status RUNNING hat.

Nutzungshinweise¶

Beim Aufrufen einer Tabellenfunktion des Information Schema muss die Sitzung über ein aktives INFORMATION_SCHEMA-Schema verfügen oder der Funktionsname muss vollqualifiziert sein. Weitere Details dazu finden Sie unter Snowflake Information Schema.