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