Tâche d’alerte SQL pour les travaux

Utilisez une tâche d’alerte SQL pour évaluer une alerte Databricks SQL dans le cadre d’un travail. Les tâches d’alerte SQL vous permettent d’intégrer la surveillance basée sur les alertes dans vos pipelines de données, ce qui permet de vérifier et de recevoir des notifications automatisées en même temps que d’autres tâches de travail. Pour en savoir plus sur les alertes Databricks SQL, consultez alertes Databricks SQL.

Exigences

Pour utiliser la tâche d’alerte SQL, vous devez respecter les conditions préalables suivantes :

• Vous devez disposer d’une alerte Databricks SQL existante dans votre espace de travail. Pour créer une alerte, consultez Créer une alerte.
• Vous devez disposer au moins de l’autorisation CAN RUN sur l’alerte que vous souhaitez utiliser.
• Vous devez avoir accès à un entrepôt SQL sans serveur ou pro.

Configurer une tâche d’alerte SQL

L’interface utilisateur des travaux affiche les options de manière dynamique en fonction d’autres paramètres configurés. Pour configurer une tâche SQL Alert :

1. Dans votre espace de travail, cliquez sur Travaux & Pipelines dans la barre latérale.
2. Cliquez sur Créer, puis Travail.
3. Cliquez sur Ajouter un autre type de tâche. Recherchez l’alerte SQL et cliquez sur la vignette pour la sélectionner.
4. Entrez un nom de tâche.
5. Dans le menu déroulant Alerte , sélectionnez l’alerte Databricks SQL que vous souhaitez évaluer.
6. (Facultatif) Dans le menu déroulant SQL Warehouse , sélectionnez l’entrepôt SQL à utiliser pour exécuter la requête d’alerte. S’il n’est pas défini, l’entrepôt interne de l’alerte est utilisé. Vous devez utiliser un entrepôt SQL serverless ou pro pour les tâches d’alerte SQL.
7. (Facultatif) Dans la liste déroulante Abonnés , choisissez les utilisateurs et les destinations de notification qui doivent recevoir des notifications avec les résultats de l’alerte. Si ce n’est pas le cas, les abonnés internes de l’alerte (le cas échéant) reçoivent des notifications. Pour personnaliser l’objet et le corps de la notification, y compris les résultats de la requête, configurez le modèle de notification sur l’alerte Databricks SQL sous-jacente. Consultez les modèles de notification.
8. (Facultatif) Utilisez notifications pour notifier les adresses e-mail ou les webhooks lorsque les exécutions de cette tâche commencent, se terminent ou échouent :
   1. Cliquez sur Ajouter pour ouvrir la boîte de dialogue Notifications de tâche.
   2. Cliquez sur Ajouter une notification pour ajouter une nouvelle notification ou modifier une notification existante.
   3. Dans le menu déroulant Destination , choisissez une destination. Si la destination souhaitée n’est pas disponible et que vous disposez des autorisations appropriées, cliquez sur Ajoutez une nouvelle destination système pour configurer une nouvelle destination. Vous devez être administrateur d’espace de travail pour ajouter une destination système. Consultez Gérer les destinations de notification.
   4. Cliquez sur Enregistrer pour appliquer vos paramètres.
9. (Facultatif) Pour configurer le seuil de durée ou les nouvelles tentatives, consultez Paramètres de tâche avancés.
10. Cliquez sur Enregistrer la tâche.

Pour modifier, cloner, désactiver ou supprimer cette tâche, consultez Configurer et modifier des tâches dans les travaux Lakeflow.

Comportement de la tâche d’alerte SQL

Lorsqu’un travail exécute une tâche d’alerte SQL, les éléments suivants se produisent :

1. La requête de l’alerte s’exécute sur l’entrepôt SQL spécifié.
2. La condition d’alerte est évaluée par rapport aux résultats de la requête.
3. Les abonnés configurés sur la tâche reçoivent des notifications en fonction du résultat de l’alerte.

La tâche d’alerte SQL signale l’un des états suivants :

• Réussite : l’alerte a été évaluée correctement, que la condition d’alerte ait été déclenchée ou non.
• Échec : une erreur s’est produite lors de l’évaluation de l’alerte, telle qu’un problème de connectivité de l’entrepôt SQL ou une erreur de requête.

Note

La tâche d’alerte SQL évalue l’alerte indépendamment de toute planification configurée sur l’alerte elle-même. Les planifications sur l’alerte sous-jacente ne sont pas impactées par l’exécution de la tâche.

Limitations

• Les tâches d’alerte SQL ne prennent pas en charge les paramètres. Si vous devez utiliser des requêtes paramétrables, envisagez plutôt d’utiliser une tâche SQL .
• Les tâches d’alerte SQL prennent uniquement en charge les alertes Databricks SQL. Les alertes héritées ne sont pas prises en charge.