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