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 Task-Graphen 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 (Integer), die die Version des Task-Graphen angibt, der ausgeführt wurde oder dessen Ausführung geplant ist. Jede inkrementelle Erhöhung des Werts bedeutet, dass eine oder mehrere Änderungen an Aufgaben im Task-Graphen 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 oder die Stammaufgabe in einem Task-Graphen 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 eines Task-Graphen. Diese ID stimmt mit dem Wert in der ID-Spalte der SHOW TASKS-Ausgabe derselben Aufgabe überein.

SCHEDULED_FROM

TEXT

Eine der folgenden Optionen:

  • SCHEDULE: Die Aufgabe wurde so geplant, dass sie normal ausgeführt wird, wie für SCHEDULE- oder AFTER-Klauseln von CREATE TASK beschrieben.

  • EXECUTE TASK: Die Aufgabe wurde für die Ausführung mit EXECUTE TASK geplant.

  • MANUAL RETRY: Die Aufgabe wurde für die Ausführung mit EXECUTE TASK … RETRY LAST geplant.

Bei der Ausführung einer untergeordneten Aufgabe eines Task-Graphen 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.

QUERY_HASH_VERSION

NUMBER

Die Version der Logik, die zur Berechnung von QUERY_HASH verwendet wird.

QUERY_PARAMETERIZED_HASH

TEXT

Der Hash-Wert, der auf Grundlage der parametrisierten Abfrage berechnet wird.

QUERY_PARAMETERIZED_HASH_VERSION

NUMBER

Die Version der Logik, die zur Berechnung von QUERY_PARAMETERIZED_HASH verwendet wird.

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

Reserviert für zukünftige Verwendung. Der zurückgegebene Wert ist für alle Zeilen NULL.

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
ORDER BY completed_time DESC
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