- Catégories :
Fonctions système (Contrôle du système)
SYSTEM$USER_TASK_CANCEL_ONGOING_EXECUTIONS¶
Annule une exécution de la tâche spécifiée que le système a déjà commencé à traiter (c’est-à-dire une exécution avec un statut EXECUTING dans la sortie TASK_HISTORY).
Syntaxe¶
SYSTEM$USER_TASK_CANCEL_ONGOING_EXECUTIONS( '<task_name>' )
Arguments¶
nom_tâche
Nom de la tâche.
Notes sur l’utilisation¶
Seul le propriétaire de la tâche (c’est-à-dire le rôle doté du privilège OWNERSHIP sur la tâche) ou un rôle doté du privilège OPERATE sur la tâche peut appeler cette fonction.
nom_tâche
est une chaîne, elle doit donc être placée entre guillemets simples :Notez que le nom complet doit être placé entre guillemets simples, y compris la base de données et le schéma (si le nom est complètement qualifié), c’est-à-dire
'<bd>.<schéma>.<nom_tâche>'
.Si le nom du canal est sensible à la casse ou inclut des caractères spéciaux ou des espaces, des guillemets doubles sont nécessaires pour traiter la casse/les caractères. Les guillemets doubles doivent être placés entre guillemets simples, c’est-à-dire
'"<nom_tâche>"'
.
Pour éviter le démarrage d’exécutions de la tâche, nous vous recommandons tout d’abord de suspendre la tâche (à l’aide de ALTER TASK … SUSPEND) et d’exécuter ensuite cette fonction.
Notez que si la tâche n’est pas suspendue lorsque cette fonction est exécutée, plusieurs minutes sont actuellement nécessaires pour que les services Cloud de Snowflake reprennent la planification des exécutions de cette tâche.
Exemples¶
Abandonnez l’exécution en cours d’une tâche avec un nom insensible à la casse :
SELECT SYSTEM$USER_TASK_CANCEL_ONGOING_EXECUTIONS('mydb.myschema.mytask');
Abandonnez l’exécution en cours d’une tâche avec un nom sensible à la casse :
SELECT SYSTEM$USER_TASK_CANCEL_ONGOING_EXECUTIONS('mydb.myschema."myTask"');