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>
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);
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>;
Où 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;