DESCRIBE TASK¶
Beschreibt die Spalten in einer Aufgabe.
DESCRIBE kann mit DESC abgekürzt werden.
- Siehe auch:
Syntax¶
DESC[RIBE] TASK <name>
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: |
predecessors |
Der Name oder die Namen der Vorgängeraufgaben der aktuellen Aufgabe, falls vorhanden. |
state |
Eine der folgenden Optionen:
|
definition |
Die SQL-Anweisung, die die Aufgabe ausführt, wenn sie geplant oder ausgelöst wird. |
condition |
Text der |
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 |
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 |
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:
|
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 ( ... );
Beschreiben Sie die Spalten in der Tabelle:
DESC TASK mytask;