COMPLETE_TASK_GRAPHS¶

Syntax¶

COMPLETE_TASK_GRAPHS(
      [ RESULT_LIMIT => <integer> ]
      [, ROOT_TASK_NAME => '<string>' ]
      [, ERROR_ONLY => { TRUE | FALSE } ] )

Argumente¶

Alle Argumente sind optional.

RESULT_LIMIT => integer

Eine Zahl, die die maximale Anzahl von Zeilen angibt, die von der Funktion zurückgegeben werden. Beachten Sie, dass die Ergebnisse in absteigender Reihenfolge gemäß COMPLETED_TIME-Wert zurückgegeben werden. Wenn die Anzahl der übereinstimmenden Zeilen größer ist als dieses Ergebnislimit, werden die abgeschlossenen Task-Graph-Ausführungen sortiert nach Zeitstempel des Abschlusses (neuester zuerst) bis zum angegebenen Limit zurückgegeben.

Bereich: 1 bis 10000

Standard: 1000

ROOT_TASK_NAME => string

Eine von Groß-/Kleinschreibung unabhängige Zeichenfolge, die den Namen der Stammaufgabe angibt. Es werden nur nicht qualifizierte Aufgabennamen unterstützt. Es werden nur Task-Graph-Ausführungen der angegebenen Aufgabe zurückgegeben. Wenn mehrere Aufgaben denselben Namen haben, gibt die Funktion die Task-Graph-Ausführungen für jede dieser Aufgaben zurück.

ERROR_ONLY => TRUE | FALSE

Wenn diese Funktion auf TRUE gesetzt ist, werden nur Task-Graph-Ausführungen zurückgegeben, die fehlgeschlagen sind oder abgebrochen wurden.

Nutzungshinweise¶

• Gibt nur Ergebnisse für die Rolle ACCOUNTADMIN oder den Aufgabeneigentümer zurück (d. h. die Rolle mit der Berechtigung OWNERSHIP für die Aufgabe) 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 1000. Um diese Einschränkung zu umgehen, können Sie die COMPLETE_TASK_GRAPHS-Ansicht (Account Usage) verwenden.

• Wenn die Funktion COMPLETE_TASK_GRAPHS abgefragt wird, werden zuerst die Argumente Aufgabenname und Ergebnislimit angewendet und erst danach, falls angegeben, die Klauseln WHERE und LIMIT. Darüber hinaus gibt die Funktion Datensätze in absteigender Reihenfolge gemäß COMPLETED_TIME-Wert zurück.

  In der Praxis kann es vorkommen, dass die von der Funktion zurückgegebenen Ergebnisse keinen erwarteten Datensatz enthalten, wenn in der vorangegangenen Stunde viele Task-Graphen in Ihrem Konto abgeschlossen wurden und insbesondere wenn der RESULT_LIMIT-Wert relativ niedrig ist.

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

Ausgabe¶

Die Funktion gibt die folgenden Spalten zurück:

Beispiele¶

Abrufen der 1.000 neuesten abgeschlossenen Task-Graph-Ausführungen im Konto. Beachten Sie, dass die maximale Anzahl von Zeilen, die von der Funktion zurückgegeben werden, standardmäßig auf 1.000 begrenzt ist. Um die Anzahl der zurückgegebenen Zeilen zu ändern, müssen Sie den Wert des Arguments RESULT_LIMIT anpassen:

select *
  from table(information_schema.complete_task_graphs())
  order by scheduled_time;

Copy

Abrufen der 10 neuesten abgeschlossenen Task-Graph-Ausführungen einer bestimmten Aufgabe innerhalb der letzten Stunde:

select *
  from table(information_schema.complete_task_graphs (
    result_limit => 10,
    root_task_name=>'MYTASK'));

Copy