Créer une alerte

Cette page vous guide tout au long de la création d’une alerte Databricks SQL de bout en bout. Il couvre l’éditeur d’alerte, le didacticiel de création d’alerte, la façon de passer en revue les détails de l’évaluation, ainsi que les paramètres avancés et les modèles de notification que vous pouvez configurer.

Explorer l’éditeur d’alerte

Les étapes de cette section vous guident tout au long de la création de l’alerte illustrée dans l’image suivante. Utilisez les étiquettes et les explications pour comprendre chaque composant.

1. Éditeur de requête : écrivez et testez la requête sur laquelle vous souhaitez alerter.
2. Calcul : choisissez l’entrepôt SQL qui exécute la requête d’alerte. L’indicateur d’état indique si le dépôt sélectionné fonctionne. Pour connaître les recommandations et le comportement de dimensionnement de l’entrepôt au moment de l’exécution planifiée, consultez Choisir un entrepôt SQL pour une alerte.
3. Planification : définissez une planification périodique pour que l’alerte s’exécute.
4. Partager : définissez des autorisations qui définissent la façon dont les autres membres de votre espace de travail peuvent utiliser votre alerte.
5. Condition : sélectionnez le seuil de valeur qui doit déclencher une notification d’alerte. Vous pouvez exécuter la requête pour tester la condition à partir de cette section.
6. Notifications : indiquez les utilisateurs ou les destinations de notification qui doivent être alertés lorsque la valeur de seuil se situe en dehors de la plage attendue. Si vous le souhaitez, définissez une fréquence de notification afin de répéter les notifications jusqu’à ce que l’alerte revienne à OK.
7. Avancé : utilisez des paramètres avancés pour alerter sur des valeurs et des conditions spéciales.

Créer une alerte

Pour créer une alerte, procédez comme suit :

1. Cliquez sur Alertes dans la barre latérale, puis cliquez sur Créer une alerte.

2. Copiez et collez la requête suivante dans l’éditeur de requête. Cliquez sur Exécuter tout (1000). Pour en savoir plus sur l’utilisation de l’éditeur SQL, consultez Écrire des requêtes et explorer les données dans le nouvel éditeur SQL.

   SELECT
     to_date(tpep_pickup_datetime) as date,
     SUM(fare_amount) as amount
   FROM
     `samples`.`nyctaxi`.`trips`
   GROUP BY
     ALL
   ORDER BY
     1 DESC
   
   

3. Cliquez sur le sélecteur de calcul, puis cliquez sur un entrepôt dans la liste pour spécifier la ressource de calcul qui exécute l’alerte.

   

4. Dans le champ Condition , définissez les conditions qui doivent déclencher l’alerte.

   

   Appliquez les paramètres suivants, comme indiqué :

   • Sélectionnez Sum comme valeur de données à vérifier. Vous pouvez définir une condition d’alerte sur la première valeur d’une colonne dans le résultat de la requête, ou vous pouvez choisir de définir une agrégation sur toutes les lignes d’une seule colonne, comme SOMME ou MOYENNE.
   • Sélectionnez la quantité en tant que colonne à vérifier.
   • Sélectionnez > (supérieur à) comme opérateur logique à appliquer.
   • Définissez la valeur de seuil sur Static value 4 000. La valeur statique est sélectionnée par défaut. Entrez 4000 dans le champ valeur.

5. Cliquez sur Condition de test pour afficher un aperçu de l’alerte et tester si l’alerte se déclencherait avec les données actuelles. Les paramètres fournis doivent déclencher l’alerte. Vous pouvez modifier la valeur de seuil pour tester davantage.

6. Dans la section Notifications , recherchez votre nom d’utilisateur et cliquez dessus quand il apparaît.

7. Cliquez sur Icône de calendrier pour ouvrir la boîte de dialogue Modifier la planification . Utilisez les menus déroulants pour définir l’alerte afin qu’elle s’exécute toutes les 5minutes à partir de 0 minutes après l'heure. Cliquez sur Enregistrer. Si vous le souhaitez, sélectionnez la case à cocher Afficher la syntaxe Cron pour modifier la planification dans la Syntaxe Quartz Cron.

8. Cliquez sur Afficher l’alerte.

Votre alerte est enregistrée et s’exécute selon la planification que vous avez fournie. Les données utilisées dans cet exemple sont statiques. Par conséquent, si votre condition de test est retournée comme déclenchée, elle déclenche à nouveau la prochaine fois qu’elle s’exécute. Vous recevez une notification par e-mail en tant qu’alerte. Si la condition de test a retourné OK, aucune notification n’est envoyée.

Passer en revue les détails de l’alerte

Une page s’ouvre pour afficher les détails de votre alerte. La page affiche également un historique des alertes avec les détails de l’évaluation. Cliquez sur le bouton Exécuter maintenant pour exécuter la requête d’alerte immédiatement et renvoyer le résultat sur cette page.

Cliquez sur Modifier dans le coin supérieur droit de la page pour continuer à modifier l’alerte.

Paramètres avancés

Cliquez sur Paramètres avancés pour appliquer les paramètres suivants :

• Notification sur OK : Envoyer une notification lorsque l’alerte revient à l’état OK.
• État de résultat vide : définissez un état spécial à retourner lorsque la requête ne retourne aucun résultat.
• Modèle : configurez le modèle de notification. Consultez les modèles de notification.

Les administrateurs d’espace de travail peuvent configurer de nouvelles destinations de notification. Consultez Gérer les destinations de notification.

Modèles de notification

Les notifications utilisent le modèle par défaut, sauf si vous les personnalisez. Pour personnaliser l’objet et le corps, sélectionnez Personnaliser le modèle. Deux éditeurs sont disponibles : l’éditeur standard et l’éditeur Markdown. Cliquez sur les onglets ci-dessous pour les comparer.

Éditeur standard

Dans l’éditeur standard, référencez des variables dans l’objet et le corps avec {{VARIABLE_NAME}}. Les variables suivantes sont prises en charge :

• ALERT_STATUS : état d’alerte évalué (chaîne).
• ALERT_CONDITION : opérateur de condition d’alerte (chaîne).
• ALERT_THRESHOLD : seuil d’alerte (chaîne ou nombre).
• ALERT_COLUMN : nom de la colonne d’alerte (chaîne).
• ALERT_NAME : nom de l’alerte (chaîne).
• ALERT_URL : URL de la page d’alerte (chaîne).
• QUERY_RESULT_TABLE : table HTML du résultat de la requête (chaîne). Les résultats sont limités aux 100 premières lignes. Seules les destinations de notification par e-mail peuvent afficher le code HTML.
• QUERY_RESULT_VALUE : valeur du résultat de la requête (chaîne ou nombre).
• QUERY_RESULT_ROWS : lignes de résultat de la requête (tableau de valeurs).
• QUERY_RESULT_COLS : colonnes de résultat de la requête (tableau de valeurs).

Par exemple : Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

L’éditeur standard prend également en charge le code HTML pour la mise en forme. Seules les destinations de notification par e-mail peuvent afficher le code HTML. Les balises HTML suivantes sont autorisées : <a>, , , <b><blockquote><br><code><del><div><em><h1><h2><h3><h4><h5><h6><hr><i>, <img>, <li>, <ol>, , <p><pre><span><table><thead><tbody><td><th><tr><u><ul>

Les attributs suivants sont autorisés sur les balises répertoriées :

Cliquez sur le bouton bascule Preview (Aperçu) pour afficher un aperçu du résultat du rendu.

Éditeur Markdown

Activez l’éditeur Markdown pour écrire le corps à l’aide de Markdown. L’éditeur Markdown a une barre d’outils de mise en forme et un aperçu rendu.

Dans l’éditeur Markdown, référencez des variables avec @VARIABLE_NAME. Saisissez @ dans le corps du message pour ouvrir le sélecteur de variables. L’éditeur Markdown prend en charge ALERT_NAME, , ALERT_STATUSALERT_CONDITIONALERT_THRESHOLD, ALERT_COLUMN, , ALERT_URLet .QUERY_RESULT_TABLE