Kategorien:: Information Schema, Tabellenfunktionen

TASK_DEPENDENTS¶

Diese Tabellenfunktion gibt die Liste der untergeordneten Aufgaben für eine bestimmte Stammaufgabe in einem Task-Graphen zurück.

Syntax¶

TASK_DEPENDENTS(
      TASK_NAME => '<string>'
      [, RECURSIVE => <Boolean> ] )

Copy

Argumente¶

TASK_NAME => 'string'

Eine Zeichenfolge, mit der eine Aufgabe angegeben wird. Die Funktion gibt die angegebene Stammaufgabe als ersten Eintrag zurück, gefolgt von der Liste der untergeordneten Aufgaben.

Beachten Sie, dass der gesamte Name in einfache Anführungszeichen eingeschlossen werden muss, einschließlich Datenbank und Schema (wenn der Name vollqualifiziert ist), d. h. '<Datenbank>.<Schema>.<Aufgabenname>'.
Wenn der Aufgabenname zwischen Groß- und Kleinschreibung unterscheidet bzw. Sonderzeichen oder Leerzeichen enthält, sind doppelte Anführungszeichen erforderlich, damit Groß-/Kleinschreibung und die Zeichen korrekt verarbeitet werden. Die doppelten Anführungszeichen müssen in einfache Anführungszeichen eingeschlossen werden, d. h. '"<Aufgabenname>"'.

RECURSIVE => Boolean

Gibt an, ob die Ausgabe auf direkte untergeordnete Aufgaben beschränkt werden oder alle rekursiven untergeordneten Aufgaben beinhalten soll.

Werte:

TRUE: Gibt alle rekursiven untergeordneten Aufgaben (untergeordnete, weiter untergeordnete usw.) in der Ausgabe zurück.

FALSE: Gibt nur direkte untergeordnete Aufgaben in der Ausgabe zurück.

Standard: TRUE.

Nutzungshinweise¶

Gibt nur Zeilen für einen Aufgabeneigentümer (d. h. für die Rolle mit der Berechtigung OWNERSHIP für die Aufgabe) oder für eine Rolle mit MONITOR- oder OPERATE-Berechtigung für die Aufgabe zurück.
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 Funktionsausgabe enthält Tabelleneigenschaften und Metadaten in den folgenden Spalten:

| created_on | name | database_name | schema_name | owner | comment | warehouse | schedule | predecessors | state | definition | condition |

Copy

Spalte	Beschreibung
`created_on`	Datum und Uhrzeit der Erstellung der Aufgabe.
`name`	Name der Aufgabe.
`database_name`	Datenbank für das Schema der Aufgabe.
`schema_name`	Schema für die Aufgabe.
`owner`	Rolle, die die Aufgabe besitzt (d. h. die die Berechtigung OWNERSHIP für die Aufgabe besitzt)
`comment`	Kommentar zur Aufgabe.
`warehouse`	Warehouse, das die erforderlichen Ressourcen zum Ausführen der Aufgabe bereitstellt.
`schedule`	Zeitplan für die Ausführung der Aufgabe. Zeigt NULL an, wenn kein Zeitplan angegeben ist.
`predecessors`	JSON-Array aller im Parameter AFTER für die Aufgabe identifizierten Aufgaben (d. h. Vorgängeraufgaben). Wenn diese Aufgaben erfolgreich zu Ende ausgeführt werden, lösen sie die aktuelle Aufgabe aus. Die einzelnen Aufgabennamen im Array sind vollqualifiziert (d. h. sie enthalten den Namen der Container-Datenbank und des Schemas). . . Zeigt ein leeres Array an, wenn die Aufgabe keinen Vorgänger hat.
`state`	„Gestartet“ oder „Angehalten“, basierend auf dem aktuellen Status der Aufgabe.
`definition`	SQL-Anweisungen, die ausgeführt werden, wenn die Aufgabe ausgeführt wird.
`condition`	Bedingung, die in der WHEN-Klausel für die Aufgabe angegeben ist.

Beispiele¶

Rufen Sie die Liste der direkten untergeordneten Aufgaben für die Aufgabe mydb.myschema.mytask ab:

select *
  from table(information_schema.task_dependents(task_name => 'mydb.myschema.mytask', recursive => false));

Copy