DESCRIBE TASK¶
Décrit les colonnes dans une tâche.
DESCRIBE peut être abrégé en DESC.
- Voir aussi :
Syntaxe¶
DESC[RIBE] TASK <name>
Paramètres¶
name
Indique l’identificateur de la tâche à décrire. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.
Sortie¶
La sortie de commande fournit les propriétés des tâches et les métadonnées dans les colonnes suivantes :
Nom de la colonne |
Description |
---|---|
created_on |
Date et heure de création de la tâche. |
name |
Nom de la tâche. |
id |
Identificateur unique au niveau mondial (GUID) de la tâche. |
database_name |
Nom de la base de données contenant la tâche. |
schema_name |
Nom du schéma contenant la tâche. |
propriétaire |
Nom du rôle qui possède la tâche. |
commentaire |
Commentaire pour la tâche, le cas échéant. |
entrepôt |
Nom de l’entrepôt virtuel qui fournit les ressources de calcul pour l’exécution de la tâche. |
schedule |
Planification éventuelle pour l’exécution périodique de la tâche, sous la forme d’une expression cron. Par exemple, |
predecessors |
Le ou les noms des tâches précédentes, s’il y en a, pour la tâche en cours. |
state |
L’un ou l’autre des états suivants :
|
definition |
Instruction SQL que la tâche exécute lorsqu’elle est planifiée ou déclenchée. |
condition |
Texte des conditions |
allow_overlapping_execution |
TRUE ou FALSE. S’applique uniquement aux tâches racines. TRUE indique que plusieurs instances de la tâche racine peuvent s’exécuter simultanément. FALSE est défini par défaut. |
error_integration |
Nom de l’intégration de notification utilisée pour communiquer avec Amazon SNS, MS Azure Event Grid ou Google Pub/Sub. Renvoie |
last_committed_on |
Horodatage de la dernière version définie pour la tâche, le cas échéant. Pour plus d’informations, voir Gestion des versions des exécutions de tâches. |
last_suspended_on |
Horodatage de la dernière suspension de la tâche, le cas échéant. |
owner_role_type |
Type de rôle propriétaire de l’objet, par exemple |
config |
S’applique uniquement aux tâches racines dans un graphique de tâches. Affiche la configuration, le cas échéant. |
budget |
Nom du budget si l’objet est contrôlé par un budget. sinon, NULL. |
task_relations |
Affiche la relation entre la tâche racine et les tâches de finalisation correspondantes. |
last_suspended_on |
Affiche la raison pour laquelle la tâche a été suspendue. Les raisons possibles sont les suivantes :
|
Notes sur l’utilisation¶
Renvoie uniquement les lignes du propriétaire d’une tâche (c’est-à-dire le rôle avec le privilège OWNERSHIP sur une tâche) ou un rôle avec le privilège MONITOR ou OPERATE sur une tâche.
Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.
Exemples¶
Créer un exemple de tâche :
CREATE TASK mytask ( ... );
Décrire les colonnes de la tâche :
DESC TASK mytask;