Schema:: ACCOUNT_USAGE

Ansicht TASK_HISTORY¶

Mit dieser Account Usage-Ansicht können Sie den Nutzungsverlauf der Aufgabe innerhalb der letzten 365 Tage (1 Jahr) abrufen. Die Ansicht zeigt eine Zeile für jede Ausführung einer Aufgabe im Verlauf an.

Spalten¶

Spaltenname	Datentyp	Beschreibung
NAME	TEXT	Name der Aufgabe.
QUERY_TEXT	TEXT	Text der SQL-Anweisung.
CONDITION_TEXT	TEXT	Text der WHEN-Bedingung, die die Aufgabe auswertet, um zu bestimmen, ob sie ausgeführt werden soll.
SCHEMA_NAME	TEXT	Name des Schemas, das die Aufgabe enthält.
TASK_SCHEMA_ID	NUMBER	Interner/systemgenerierter Bezeichner für das Schema, das die Aufgabe enthält.
DATABASE_NAME	TEXT	Name der Datenbank, die die Aufgabe enthält.
TASK_DATABASE_ID	NUMBER	Interner/systemgenerierter Bezeichner für die Datenbank, die die Aufgabe enthält.
SCHEDULED_TIME	TIMESTAMP_LTZ	Zeitpunkt, zu dem der Start der Aufgabe geplant ist/war. Beachten Sie, dass wir uns nach besten Kräften um absolute Präzision bemühen, aber nur garantieren, dass Aufgaben nicht vor der geplanten Zeit ausgeführt werden.
COMPLETED_TIME	TIMESTAMP_LTZ	Zeitpunkt, zu dem die Aufgabe abgeschlossen wurde.
STATE	TEXT	Status der abgeschlossenen Aufgabe: SUCCEEDED, FAILED, CANCELLED oder SKIPPED. Beachten Sie, dass die Ansicht Aufgabenausführungen mit Status SCHEDULED oder EXECUTING nicht zurückgibt. Um Details zum Aufgabenverlauf geplanter oder aktiver Ausführungen abzurufen, fragen Sie die Tabellenfunktion TASK_HISTORY im Information Schema ab.
RETURN_VALUE	TEXT	Wert, der für die Vorgängeraufgabe in einem DAG von Aufgaben festgelegt wurde. Der Rückgabewert wird von der Vorgängeraufgabe durch Aufrufen der Funktion SYSTEM$SET_RETURN_VALUE explizit festgelegt.
QUERY_ID	TEXT	ID der SQL-Anweisung, die von der Aufgabe ausgeführt wird. Kann mit der Ansicht QUERY_HISTORY verknüpft werden, um zusätzliche Details zur Ausführung der Anweisung oder der gespeicherten Prozedur zu bieten.
QUERY_START_TIME	TIMESTAMP_LTZ	Zeitpunkt, zu dem die Abfrage der Aufgabendefinition ausgeführt wurde. Dieser Zeitstempel stimmt mit der Startzeit der von QUERY_HISTORY zurückgegebenen Abfrage überein.
ERROR_CODE	NUMBER	Fehlercode, wenn die Anweisung einen Fehler zurückgegeben hat.
ERROR_MESSAGE	TEXT	Fehlermeldung, wenn die Anweisung einen Fehler zurückgegeben hat.
GRAPH_VERSION	NUMBER	Ganzzahl, die die Version des DAG angibt, die ausgeführt wurde oder deren Ausführung geplant ist. Jede inkrementelle Erhöhung des Werts bedeutet, dass eine oder mehrere Änderungen an Aufgaben im DAG vorgenommen wurden. Wenn die Stammaufgabe neu erstellt wird (mit CREATE OR REPLACE TASK), wird die Versionsnummer mit 1 neu gestartet.
RUN_ID	NUMBER	Zeitpunkt, zu dem die eigenständige Aufgabe bzw. Stammaufgabe in einem DAG ursprünglich ausgeführt werden soll/sollte. Das Format ist die Epochenzeit (in Millisekunden). . . Die ursprüngliche geplante Zeit bezieht sich auf seltene Fälle, in denen das System möglicherweise dieselbe Aufgabe neu plant, um sie zu einem anderen Zeitpunkt zu Testzwecken erneut auszuführen, oder die Last neu auszugleichen. In diesem Fall zeigt RUN_ID die ursprünglich geplante Ausführungszeit und SCHEDULED_TIME die neu geplante Ausführungszeit an. . . Beachten Sie, dass RUN_ID möglicherweise kein eindeutiger Bezeichner für die aktuelle Task-Graph-Ausführung vor der Wiederholung ist. Sie können die Spalte GRAPH_RUN_GROUP_ID als Ersatz für RUN_ID verwenden.
ROOT_TASK_ID	TEXT	Eindeutiger Bezeichner der Stammaufgabe in einem DAG. Diese ID stimmt mit dem Wert in der ID-Spalte der SHOW TASKS-Ausgabe derselben Aufgabe überein.
SCHEDULED_FROM	TEXT	Mechanismus, der die Ausführung der Aufgabe veranlasst hat: SCHEDULE zeigt an, dass die Aufgabenausführung durch den Zeitplan in der Aufgabendefinition ausgelöst wurde. EXECUTE TASK zeigt an, dass die Aufgabenausführung durch eine EXECUTE TASK-Anweisung ausgelöst wurde. Bei der Ausführung einer untergeordneten Aufgabe eines DAG gibt die Spalte denselben Wert zurück wie bei der Ausführung der Stammaufgabe.
ATTEMPT_NUMBER	NUMBER	Ganzzahl, die die Anzahl der Versuche angibt, diese Aufgabe auszuführen. Anfänglich eine.
INSTANCE_ID	NUMBER	Interner/systemgenerierter Bezeichner für die Instanz, zu der das Objekt gehört.
CONFIG	TEXT	Zeigt die Konfiguration der Task-Graph-Ebene an, falls diese für die Stammaufgabe festgelegt wurde, andernfalls wird NULL angezeigt.
QUERY_HASH	TEXT	Der Hash-Wert wird auf der Grundlage des kanonisierten SQL-Textes berechnet. 1
QUERY_HASH_VERSION	NUMBER	Die Version der Logik, die zur Berechnung von `QUERY_HASH` verwendet wird. 1
QUERY_PARAMETERIZED_HASH	TEXT	Der Hash-Wert wird auf der Grundlage der parametrisierten Abfrage berechnet. 1
QUERY_PARAMETERIZED_HASH_VERSION	NUMBER	Die Version der Logik, die zur Berechnung von `QUERY_PARAMETERIZED_HASH` verwendet wird. 1
GRAPH_RUN_GROUP_ID	NUMBER	Bezeichner für die Task-Graph-Ausführung. Wenn eine Task-Graph-Ausführung aus mehreren Aufgabenausführungen besteht, wird für jede Aufgabenausführung derselbe GRAPH_RUN_GROUP_ID-Wert angezeigt. Die Kombination aus GRAPH_RUN_GROUP_ID und ATTEMPT_NUMBER kann zur eindeutigen Identifizierung einer Task-Graph-Ausführung verwendet werden.
BACKFILL_INFO	OBJECT	Reserved for future use. The returned value for all rows is NULL.

1(1,2,3,4): Diese Spalte ist nur vorhanden, wenn das Verhaltensänderungs-Bundle 2023_06 aktiviert ist. Diese Spalte ist Teil des Abfrage-Hash-Features.

Nutzungshinweise¶

Die Latenzzeit der Ansicht kann bis zu 45 Minuten betragen.
Um die Leistung zu erhöhen, filtern Sie Abfragen auf der Spalte COMPLETED_TIME oder SCHEDULED_TIME. Weitere Informationen dazu finden Sie im Abschnitt Beispiele (unter diesem Thema).

Beispiele¶

Abrufen von Datensätzen für die 10 zuletzt abgeschlossenen Aufgabenausführungen:

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
LIMIT 10;

Copy

Abrufen von Datensätzen für Aufgabenausführungen, die in der letzten Stunde abgeschlossen wurden:

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
WHERE COMPLETED_TIME > DATEADD(hours, -1, CURRENT_TIMESTAMP());

Copy