Configuration d’une tâche pour envoyer des notifications d’erreur

Pour permettre à une tâche d’envoyer des notifications d’erreur, vous devez associer la tâche à une intégration de notification. Vous pouvez le faire en exécutant la commande CREATE TASK pour créer une nouvelle tâche ou la commande ALTER TASK pour modifier une tâche existante. Lorsque vous exécutez ces commandes, définissez ERROR_NOTIFICATION comme le nom de l’intégration de notification.

Vous ne pouvez spécifier les intégrations de notification d’erreur que sur une tâche racine d’un graphique de tâches ; toute tâche enfant qui échoue envoie des notifications d’erreur à l’intégration spécifiée pour la tâche racine.

Les tâches avec TASK_AUTO_RETRY_ATTEMPTS défini sur une valeur supérieure à 0 envoient des notifications d’erreur pour chaque échec de l’exécution de la tâche.

Note

La création ou la modification d’une tâche qui fait référence à une intégration de notification nécessite un rôle qui possède le privilège USAGE sur l’intégration de notification. En outre, le rôle doit avoir le privilège CREATE TASK sur le schéma ou le privilège OWNERSHIP sur la tâche, respectivement.

Dans ce chapitre :

Création d’une nouvelle tâche qui envoie des notifications d’erreur

Créez une nouvelle tâche en utilisant CREATE TASK. Pour une description de tous les paramètres de tâche disponibles, voir la rubrique de la commande SQL :

CREATE TASK <name>
  [...]
  ERROR_INTEGRATION = <integration_name>
  AS <sql>
Copy

Où :

ERROR_INTEGRATION = integration_name

Nom de l’intégration de notification créée dans l’une des notifications de niveau plateforme AWS SNS, Google Pub/Sub ou Azure Event Grid.

L’exemple suivant crée une tâche sans serveur qui prend en charge les notifications d’erreur. La tâche insère l’horodatage actuel dans une colonne de la table toutes les 5 minutes :

CREATE TASK mytask
  SCHEDULE = '5 MINUTE'
  ERROR_INTEGRATION = my_notification_int
  AS
  INSERT INTO mytable(ts) VALUES(CURRENT_TIMESTAMP);
Copy

Mise à jour d’une tâche existante pour envoyer des notifications d’erreur

Modifiez une tâche existante en utilisant ALTER TASK :

ALTER TASK <name> SET ERROR_INTEGRATION = <integration_name>;
Copy

integration_name est le nom de l’intégration de notification créée dans l’une des notifications de niveau plateforme AWS SNS, Google Pub/Sub ou Azure Event Grid.

Par exemple :

ALTER TASK mytask SET ERROR_INTEGRATION = my_notification_int;
Copy