DESCRIBE TASK

Beschreibt die Spalten in einer Aufgabe.

DESCRIBE kann mit DESC abgekürzt werden.

Siehe auch:

DROP TASK, ALTER TASK, CREATE TASK, SHOW TASKS

Syntax

DESC[RIBE] TASK <name>
Copy

Parameter

name

Gibt den Bezeichner für die zu beschreibende Aufgabe an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

Ausgabe

Die Befehlsausgabe enthält Eigenschaften und Metadaten der Aufgabe in den folgenden Spalten:

Spaltenname

Beschreibung

created_on

Datum und Uhrzeit, zu der die Aufgabe erstellt wurde.

name

Name der Aufgabe.

id

Der weltweit eindeutige Bezeichner (GUID) für die Aufgabe.

database_name

Name der Datenbank, die die Aufgabe enthält.

schema_name

Der Name des Schemas, das die Aufgabe enthält.

owner

Der Name der Rolle, der die Aufgabe gehört.

comment

Kommentar zur Aufgabe, falls vorhanden.

warehouse

Der Name des virtuellen Warehouses, das Computeressourcen für die Ausführung der Aufgabe bereitstellt.

schedule

Der Zeitplan, falls vorhanden, für die regelmäßige Ausführung der Aufgabe, als Cron-Ausdruck. Beispiel: USING CRON 0 9-17 * * SUN America/Los_Angeles.

predecessors

Der Name oder die Namen der Vorgängeraufgaben der aktuellen Aufgabe, falls vorhanden.

state

Eine der folgenden Optionen:

  • SCHEDULED – zur Ausführung vorgesehen.

  • EXECUTING – wird derzeit ausgeführt.

  • SUCCEEDED – Ausführung erfolgreich.

  • FAILED – die Ausführung ist fehlgeschlagen und die Aufgabe hat eine Zeitüberschreitung.

  • FAILED_AND_AUTO_SUSPENDED – Ausführung fehlgeschlagen und die Aufgabe wurde automatisch unterbrochen.

  • CANCELLED – Ausführung abgebrochen.

  • SKIPPED – zeigt an, dass ein Aufgabenlauf begonnen hat, aber die optionale Bedingung WHEN zu „false“ ausgewertet wurde, sodass der Lauf nicht ausgeführt wurde.

definition

Die SQL-Anweisung, die die Aufgabe ausführt, wenn sie geplant oder ausgelöst wird.

condition

Text der WHEN-Bedingungen, die als wahr bewertet werden müssen, damit die Aufgabe ausgeführt wird.

allow_overlapping_execution

TRUE oder FALSE. Gilt nur für Stammaufgaben. TRUE zeigt an, dass mehrere Instanzen der Stammaufgabe gleichzeitig laufen können. FALSE ist der Standard.

error_integration

Der Name der Benachrichtigungsintegration, die für die Kommunikation mit Amazon SNS, MS Azure Event Grid oder Google Pub/Sub verwendet wird. Gibt null zurück, wenn nicht angegeben.

last_committed_on

Zeitstempel, wann eine Version der Aufgabe zuletzt festgelegt wurde, falls zutreffend. Weitere Informationen dazu finden Sie unter Versionieren von Aufgabenausführungen.

last_suspended_on

Zeitstempel, wann die Aufgabe zuletzt angehalten wurde, falls zutreffend.

owner_role_type

Der Typ der Rolle, die das Objekt besitzt, zum Beispiel ROLE. Wenn eine Snowflake Native App das Objekt besitzt, lautet der Wert APPLICATION.

config

Gilt nur für Stammaufgaben in einem Aufgabendiagramm. Zeigt die Konfiguration an, falls vorhanden.

Budget

Name des Budgets, wenn das Objekt durch ein Budget überwacht wird. Andernfalls NULL.

task_relations

Zeigt die Beziehung zwischen der Stammaufgabe und den zugehörigen Finalizer-Aufgaben an.

last_suspended_reason

Zeigt den Grund an, warum die Aufgabe ausgesetzt wurde. Mögliche Gründe sind:

  • USER_SUSPENDED – Der Benutzer hat die Aufgabe durch Ausführung des Befehls alter task <name> suspend angehalten.

  • SCHEMA_OR_DATABASE_DELETED – Das Schema oder die Datenbank der Aufgabe wurde gelöscht.

  • GRANT_OWNERSHIP – Der Benutzer hat die Eigentümerschaft an der Aufgabe mit dem Befehl grant ownership auf eine andere Rolle übertragen.

  • SUSPENDED_DUE_TO_ERRORS – Die Aufgabe ist eine bestimmte Anzahl von Versuchen hintereinander fehlgeschlagen und wurde angehalten. Sie können den Parameter SUSPEND_TASK_AFTER_NUM_FAILURES für die Anzahl der fehlgeschlagenen Versuche festlegen, die erforderlich sind, damit diese Aufgabe angehalten wird.

  • CHILD_BECAME_ROOT – Die Aufgabe war zuvor eine untergeordnete Aufgabe in einem Task-Graphen, aber alle Vorgänger der untergeordneten Aufgabe wurden entfernt und die untergeordnete Aufgabe wurde zu einer Stammaufgabe.

  • FINALIZER_BECAME_ROOT – Die Aufgabe war zuvor eine Finalizer-Aufgabe in einem Task-Graphen, aber die Finalisierung wurde entfernt und die Aufgabe wurde zu einer Stammaufgabe.

  • MATCHING_OWNER_NOT_FOUND – Während der Aufgabenreplikation wurde die Rolle, die Eigentümer der Aufgabe ist, in der Sekundärdatenbank nicht gefunden.

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.

  • Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Beispiele

Erstellen Sie eine Beispielaufgabe:

CREATE TASK mytask ( ... );
Copy

Beschreiben Sie die Spalten in der Tabelle:

DESC TASK mytask;
Copy