Schema:

ACCOUNT_USAGE

Ansicht TASK_HISTORY

Mit dieser Account Usage-Ansicht können Sie den Verlauf der Tasknutzung innerhalb der letzten 365 Tage (1 Jahr) abrufen, wenn die entsprechenden Verlaufsmetadaten verfügbar sind. Die Ansicht zeigt eine Zeile für jede Ausführung einer Aufgabe im Verlauf an.

Spalten

Spaltenname

Datentyp

Beschreibung

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 gespeicherten Prozedur zu bieten.

NAME

TEXT

Name der Aufgabe.

DATABASE_NAME

TEXT

Name der Datenbank, die die Aufgabe enthält.

SCHEMA_NAME

TEXT

Name des Schemas, das die Aufgabe enthält.

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.

STATE

TEXT

Status der abgeschlossenen Aufgabe: SUCCEEDED, FAILED oder CANCELLED. Ab November 2020 gibt die Ansicht auch Aufgaben mit dem Status SKIPPED zurück. Beachten Sie, dass die Ansicht Aufgabenausführungen mit Status SCHEDULED oder EXECUTING nicht zurückgibt. Um Details zum Aufgabenverlauf für Ausführungen abzurufen, die geplant oder gerade ausgeführt werden, fragen Sie die Tabellenfunktion TASK_HISTORY im Information Schema ab.

ERROR_CODE

NUMBER

Fehlercode, wenn die Anweisung einen Fehler zurückgegeben hat.

ERROR_MESSAGE

TEXT

Fehlermeldung, wenn die Anweisung einen Fehler zurückgegeben hat.

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.

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.

COMPLETED_TIME

TIMESTAMP_LTZ

Zeitpunkt, zu dem die Aufgabe abgeschlossen wurde.

ROOT_TASK_ID

TEXT

Eindeutiger Bezeichner der Stammaufgabe eines Aufgabenstrukturbaums. Dieses ID entspricht dem Wert in der ID-Spalte der SHOW TASKS-Ausgabe derselben Aufgabe.

GRAPH_VERSION

NUMBER

Ganzzahl, die die Version des Aufgabenstrukturbaums 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 Strukturbaum 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 oder Stammaufgabe in einem Aufgabenstrukturbaum ursprünglich ausgeführt werden soll/sollte. Das Format ist die Epochenzeit (in Millisekunden). Die Kombination der Werte ROOT_TASK_ID und RUN_ID identifiziert eine bestimmte Ausführung eines Aufgabenstrukturbaums. . 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 aus 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.

RETURN_VALUE

TEXT

Wert, der für die Vorgängeraufgabe in einem Aufgabenstrukturbaum festgelegt wurde. Der Rückgabewert wird von der Vorgängeraufgabe durch Aufrufen der Funktion SYSTEM$SET_RETURN_VALUE explizit festgelegt.

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 * FROM snowflake.account_usage.task_history
  LIMIT 10;

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

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