Aller au contenu principal
Dernière mise à jour le

Tâche d'alerte SQL pour les Jobs

Utilisez une tâche d'alerte SQL pour évaluer une alerte Databricks SQL dans le cadre d'un Job. Les tâches d'alerte SQL vous permettent d'intégrer le monitoring basé sur les alertes dans vos pipelines de données, permettant des vérifications de conditions automatisées et des notifications parallèlement à d'autres tâches de Job. Pour en savoir plus sur les alertes Databricks SQL, consultez alertes Databricks SQL.

Exigences​

Pour utiliser la tâche d'alerte SQL, vous devez satisfaire aux prérequis suivants :

  • Vous devez avoir une alerte Databricks SQL existante dans votre workspace. 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 SQL warehouse serverless ou Pro.

Configurer une tâche d'alerte SQL​

L'interface utilisateur des jobs 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 Workspace, cliquez Icône Workflows. sur **Tâches et pipelines** dans la barre latérale.

  2. Cliquez sur Créer , puis sur Job .

  3. Cliquez sur Ajouter un autre type de tâche . Recherchez SQL Alert et cliquez sur la vignette pour la sélectionner.

  4. Saisissez un Nom de la 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 le SQL warehouse à utiliser pour exécuter la query d'alerte. S'il n'est pas défini, le warehouse interne de l'alerte est utilisé. Vous devez utiliser un SQL Warehouse serverless ou Pro pour les tâches d'alerte SQL.

  7. (Facultatif) Dans le menu déroulant Abonnés , choisissez les utilisateurs et les destinations de notification qui doivent recevoir des notifications avec les résultats de l'alerte. S'il n'est pas défini, les abonnés internes de l'alerte (le cas échéant) reçoivent les notifications. Pour personnaliser l'objet et le corps de la notification, y compris les résultats de la query, configurez le modèle de notification sur l'alerte Databricks SQL sous-jacente. Consultez Modèles de Template.

  8. (Facultatif) Utilisez les **Notifications** pour avertir les adresses e-mail ou les webhooks lorsque les exécutions de cette tâche démarrent, se terminent ou échouent :

    1. Cliquez sur Icône Plus. Ajouter pour ouvrir la boîte de dialogue Notifications de tâches .
    2. Cliquez sur **Ajouter une notification** pour ajouter une nouvelle notification ou pour 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 Icône Plus. Ajouter une nouvelle destination système pour en configurer une nouvelle. Vous devez être administrateur du Workspace pour ajouter une destination système. Voir Gérer les destinations de notification.
    4. Cliquez sur Enregistrer pour appliquer vos paramètres.

  9. (Facultatif) Pour configurer le **Duration threshold** 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 les tâches dans Lakeflow Jobs.

Comportement de la tâche d'alerte SQL​

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

  1. La query de l'alerte s'exécute sur le SQL Warehouse spécifié.
  2. La condition d'alerte est évaluée par rapport aux résultats de la query.
  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 avec succès, indépendamment du fait que la condition d'alerte ait été Trigger ou non.
  • Échec : une erreur s’est produite lors de l’évaluation de l’alerte, telle qu’un problème de connectivité de SQL Warehouse ou une erreur de query.
remarque

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 affectées par l'exécution du Job.

Limitations​

  • Les tâches SQL Alert ne prennent pas en charge les paramètres. Si vous devez utiliser des queries paramétrées, envisagez d'utiliser une tâche SQL plutôt.
  • Les tâches d'alerte SQL ne prennent en charge que les alertes Databricks SQL. Les anciennes alertes ne sont pas prises en charge.
Sur cette page