TASK_HISTORY¶

Syntax¶

TASK_HISTORY(
      [ SCHEDULED_TIME_RANGE_START => <constant_expr> ]
      [, SCHEDULED_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ]
      [, TASK_NAME => '<string>' ]
      [, ERROR_ONLY => { TRUE | FALSE } ]
      [, ROOT_TASK_ID => '<string>'] )

Argumente¶

Alle Argumente sind optional.

SCHEDULED_TIME_RANGE_START => constant_expr, . SCHEDULED_TIME_RANGE_END => constant_expr

Zeitbereich (im TIMESTAMP_LTZ-Format) innerhalb der letzten 7 Tage, in dem die Aufgabenausführung geplant wurde. Wenn der Zeitbereich nicht in den letzten 7 Tagen liegt, wird ein Fehler zurückgegeben.

• Wenn SCHEDULED_TIME_RANGE_END nicht angegeben ist, gibt die Funktion die Aufgaben zurück, die bereits fertig ausgeführt wurden, aktuell ausgeführt werden oder für die Zukunft geplant sind.

• Wenn SCHEDULED_TIME_RANGE_END CURRENT_TIMESTAMP ist, gibt die Funktion die Aufgaben zurück, die bereits fertig ausgeführt wurden oder gerade ausgeführt werden. Beachten Sie, dass eine Aufgabe, die unmittelbar vor der aktuellen Zeit ausgeführt wird, möglicherweise noch als geplant identifiziert wird.

• Um nur die Aufgaben abzufragen, die bereits fertig ausgeführt wurden oder gerade ausgeführt werden, schließen Sie WHERE query_id IS NOT NULL als Filter ein. Die Spalte QUERY_ID in der Ausgabe TASK_HISTORY wird nur ausgefüllt, wenn eine Aufgabe gestartet wurde.

Bemerkung

Wenn keine Start- oder Endzeit angegeben ist, werden die letzten Aufgaben bis zum angegebenen RESULT_LIMIT-Wert zurückgegeben.

RESULT_LIMIT => integer

Eine Zahl, die die maximale Anzahl von Zeilen angibt, die von der Funktion zurückgegeben werden.

Wenn die Anzahl der übereinstimmenden Zeilen größer ist als dieser Grenzwert, werden die Aufgabenausführungen sortiert nach Zeitstempel (neuester zuerst) bis zum angegebenen Grenzwert zurückgegeben.

Bereich: 1 bis 10000

Standard: 100.

TASK_NAME => string

Eine Zeichenfolge, bei der die Groß-/Kleinschreibung nicht berücksichtigt wird und die eine Aufgabe angibt. Es werden nur nicht qualifizierte Aufgabennamen unterstützt. Es werden nur Ausführungen der angegebenen Aufgabe zurückgegeben. Beachten Sie, dass die Funktion den Verlauf für jede der Aufgaben zurückgibt, wenn mehrere Aufgaben denselben Namen haben.

ERROR_ONLY => TRUE | FALSE

Wenn diese Funktion auf TRUE gesetzt ist, gibt sie nur Aufgabenausführungen zurück, die fehlgeschlagen sind oder abgebrochen wurden.

ROOT_TASK_ID =>string

Eindeutiger Bezeichner der Stammaufgabe eines Task-Graphen. Diese ID stimmt mit dem Wert in der ID-Spalte der SHOW TASKS-Ausgabe derselben Aufgabe überein. Geben Sie ROOT_TASK_ID an, um den Verlauf der Stammaufgabe und aller untergeordneten Aufgaben, die Teil des Task-Graphen sind, anzuzeigen.

Nutzungshinweise¶

• Diese Funktion liefert nur Ergebnisse für die Rolle ACCOUNTADMIN, den Aufgabeneigentümer oder eine Rolle mit der globalen Berechtigung MONITOR EXECUTION. Beachten Sie, dass die Werte DATABASE_NAME und SCHEMA_NAME in der Ausgabe NULL sind, sofern eine Rolle mit der Berechtigung MONITOR EXECUTION nicht auch die Berechtigung USAGE für die Datenbank und das Schema hat, in denen die Aufgabe gespeichert ist.

• Diese Funktion gibt maximal 10.000 Zeilen zurück. Der Wert wird im Argument RESULT_LIMIT festgelegt. Der Standardwert ist 100. Um diese Einschränkung zu umgehen, können Sie die TASK_HISTORY-Ansicht (Account Usage) verwenden.

• Beachten Sie, dass bei der Abfrage der Funktion TASK_HISTORY die Argumente Aufgabenname, Zeitbereich und Ergebnislimit zuerst angewendet werden und erst danach, falls angegeben, die Klauseln WHERE und LIMIT. Darüber hinaus gibt die Funktion TASK_HISTORY Datensätze in absteigender Reihenfolge gemäß SCHEDULED_TIME-Wert zurück. Aufgaben mit Status SUCCEEDED, FAILED oder CANCELLED werden in der Regel früher geplant, sodass sie in der Regel später in den Suchergebnissen angezeigt werden.

• In der Praxis, wenn viele Aufgaben in Ihrem Konto ausgeführt werden, könnten die von der Funktion zurückgegebenen Ergebnisse weniger abgeschlossene Aufgaben als erwartet oder nur geplante Aufgaben enthalten. Zur Abfrage des Verlaufs von bereits ausgeführten Aufgaben verwenden Sie eine Kombination der Argumente SCHEDULED_TIME_RANGE_START => constant_expr und SCHEDULED_TIME_RANGE_END => constant_expr.

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

• Aufgaben, die während eines Ausfalls der Clouddienste ausgeführt werden, können als doppelte Einträge in den Ergebnissen dieser Funktion auftreten. Bei einem Ausfall von Clouddiensten kann Snowflake eine Aufgabe erneut ausführen, wodurch die Aufgabe zwei UUIDs mit unterschiedlichen SCHEDULED_TIME-Aufgaben aufweist. Ansicht TASK_HISTORY zeigt nur die letzte UUID der neu ausgeführten Aufgabe an.

• Bei allen Aufgaben einer Task-Graph-Ausführung ist die Ausgabe des Aufgabenverlaufs identisch.

Ausgabe¶

Die Funktion gibt die folgenden Spalten zurück:

Beispiele¶

Abrufen der 100 neuesten (abgeschlossenen, noch ausgeführten oder geplanten) Aufgabenausführungen im Konto. Beachten Sie, dass die maximale Anzahl von Zeilen, die von der Funktion zurückgegeben werden können, standardmäßig auf 100 begrenzt ist.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY())
  ORDER BY SCHEDULED_TIME;

Copy

Abrufen des Ausführungsverlaufs für Aufgaben im Konto innerhalb eines festgelegten Zeitraums von 30 Minuten innerhalb eines festgelegten Zeitraums von 7 Tagen:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY(
    SCHEDULED_TIME_RANGE_START=>TO_TIMESTAMP_LTZ('2024-11-9 12:00:00.000 -0700'),
    SCHEDULED_TIME_RANGE_END=>TO_TIMESTAMP_LTZ('2024-11-9 12:30:00.000 -0700')));

Copy

Rufen Sie die 10 neuesten (abgeschlossen, noch ausgeführten oder geplanten) Ausführungen einer bestimmten Aufgabe ab, die innerhalb der letzten Stunde geplant wurde:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY(
    SCHEDULED_TIME_RANGE_START=>DATEADD('hour',-1,current_timestamp()),
    RESULT_LIMIT => 10,
    TASK_NAME=>'mytask'));

Copy

Bemerkung

Filtern Sie die Abfrage mit WHERE query_id IS NOT NULL, um nur Aufgaben abzurufen, die abgeschlossen sind oder noch ausgeführt werden. Beachten Sie, dass dieser Filter erst angewendet wird, nachdem RESULT_LIMIT die zurückgegebenen Ergebnisse bereits reduziert hat. Daher kann die Abfrage 9 Aufgaben zurückgeben, wenn 1 Aufgabe geplant war, aber noch nicht gestartet wurde.

Abrufen des Ausführungsverlaufs aller Aufgaben im Task-Graphen der angegebenen Stammaufgabe.

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY(ROOT_TASK_ID=>'d4b89013-c942-465c-bcb8-e7037a932b04'));

Copy

Abrufen des Ausführungsverlaufs aller Aufgaben im Task-Graphen der zuletzt abgefragten Stammaufgabe:

DESC TASK my_task
SET task_id=(SELECT "id" FROM TABLE(RESULT_SCAN(LAST_QUERY_ID())));
SELECT *
  FROM TABLE(INFORMATION_SCHEMA.TASK_HISTORY(ROOT_TASK_ID=>$task_id));

Copy