DESCRIBE TASK¶

Décrit les colonnes dans une tâche.

DESCRIBE peut être abrégé en DESC.

Voir aussi :: DROP TASK , ALTER TASK , CREATE TASK , SHOW TASKS

Syntaxe¶

DESC[RIBE] TASK <name>

Copy

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, `USING CRON 0 9-17 * * SUN America/Los_Angeles`.
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 : SCHEDULED : exécution planifiée. EXECUTING : en cours d’exécution. SUCCEEDED : exécution réussie. FAILED : l’exécution a échoué et la tâche a expiré. FAILED_AND_AUTO_SUSPENDED : l’exécution a échoué et la tâche a été automatiquement suspendue. CANCELLED : exécution annulée. SKIPPED : indique qu’une tâche a commencé à être exécutée, mais que la condition `WHEN` facultative a été évaluée à False, de sorte que l’exécution n’a pas eu lieu.
definition	Instruction SQL que la tâche exécute lorsqu’elle est planifiée ou déclenchée.
condition	Texte des conditions `WHEN` qui doivent être évaluées sur true pour que la tâche s’exécute.
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 `null` si non spécifié.
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 `ROLE`. Si Snowflake Native App est propriétaire de l’objet, la valeur est `APPLICATION`.
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 : USER_SUSPENDED : l’utilisateur a suspendu la tâche en exécutant la commande `alter task <nom> suspend`. SCHEMA_OR_DATABASE_DELETED : le schéma ou la base de données de la tâche a été supprimé. GRANT_OWNERSHIP : l’utilisateur a transféré la propriété de la tâche à un autre rôle en exécutant la commande `grant ownership`. SUSPENDED_DUE_TO_ERRORS : la tâche a échoué un certain nombre de fois consécutives et a été suspendue. Vous pouvez définir le paramètre SUSPEND_TASK_AFTER_NUM_FAILURES pour le nombre d’échecs requis pour suspendre cette tâche. CHILD_BECAME_ROOT : la tâche était auparavant une tâche enfant dans un graphique de tâches, mais tous les prédécesseurs de la tâche enfant ont été supprimés et la tâche enfant est devenue une tâche racine. FINALIZER_BECAME_ROOT : la tâche était auparavant une tâche de finalisation dans un graphique de tâches, mais la finalisation a été supprimée et la tâche est devenue une tâche racine. MATCHING_OWNER_NOT_FOUND : lors de la réplication de la tâche, le rôle propriétaire de la tâche n’a pas été trouvé dans la base de données secondaire.

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 ( ... );

Copy

Décrire les colonnes de la tâche :

DESC TASK mytask;

Copy