- Schema:
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 Kombination der Werte ROOT_TASK_ID und RUN_ID identifiziert eine bestimmte Ausführung eines DAG. . 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. |
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_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 |
- 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;
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());