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"');