Créer une règle d’alerte sur une requête SQL Fabric Warehouse

Cet article vous montre comment créer une alerte sur une requête SQL Warehouse. Lorsque vous créez une alerte sur une requête SQL, une alerte est déclenchée lorsque la requête retourne les résultats. Si la requête ne retourne aucune valeur, aucune alerte n’est déclenchée.

Créer une règle d’alerte

Dans l’éditeur de requête SQL d’une requête SQL Warehouse, entrez et exécutez une requête SQL, puis sélectionnez Créer une règle dans le ruban.

Capture d’écran du bouton Définir l’alerte sur le ruban.

Note

La requête SQL doit être une requête SELECT.

Passez à la section suivante pour commencer à créer une règle.

Section Détails

Dans la page Ajouter une règle , dans la section Détails , pour le nom de la règle, entrez un nom pour la règle.

Capture d’écran montrant le volet Ajouter une règle avec le nom de la règle renseigné.

Section de Surveillance

  1. Dans la section Moniteur , pour Source, vérifiez que la source est définie sur la table sur laquelle vous avez exécuté la requête.
  2. Pour Requête, vérifiez que vous voyez la requête que vous avez exécutée dans l’éditeur de requête SQL. Pour afficher la requête complète, sélectionnez Afficher plus.
  3. Pour le champ Exécuter la requête toutes les, sélectionnez la fréquence à laquelle la requête doit être exécutée pour vérifier la condition.

Capture d’écran de la fenêtre Ajouter une règle avec les sections Détails, Moniteur et Condition.

Section des conditions

Pour le champ Vérifier , vérifiez que sur chaque événement est sélectionné. Ce paramètre signifie que l’alerte est évaluée chaque fois que la requête s’exécute.

Section des actions

Dans la section Action , sélectionnez l’une des actions suivantes :

Courrier électronique

Pour configurer l’alerte pour envoyer un e-mail lorsque la condition est remplie, procédez comme suit :

  1. Pour sélectionner une action, sélectionnez Envoyer un e-mail.

  2. Pour à, entrez l’adresse e-mail du destinataire ou utilisez la liste déroulante pour sélectionner une propriété dont la valeur est une adresse e-mail.

  3. Pour Objet, entrez un objet pour l’e-mail.

  4. Pour Titre, entrez un titre pour l’e-mail.

  5. Pour Notes, entrez des notes pour les e-mails.

    Note

    Lorsque vous entrez un sujet, un titre ou des notes, vous pouvez faire référence aux propriétés des données en tapant @ ou en sélectionnant le bouton en regard des zones de texte. Par exemple : @BikepointID.

  6. Pour Context, sélectionnez des valeurs dans la liste déroulante que vous souhaitez inclure dans le contexte.

    Capture d’écran du volet Ajouter une règle avec l’action Envoyer un e-mail sélectionnée.

Message Microsoft Teams

Pour configurer l’alerte pour envoyer un message Teams à une personne ou à un groupe ou à un canal lorsque la condition est remplie, procédez comme suit :

  1. Pour sélectionner une action, sélectionnez Teams ->Message à des personnes ou un message de conversation de groupe ou publication de canal.

  2. Suivez l’une de ces étapes en fonction de l’option que vous avez sélectionnée à l’étape précédente :

    • Si vous avez sélectionné l’option Message à des personnes , entrez des adresses e-mail de récepteurs ou utilisez la liste déroulante pour sélectionner une propriété dont la valeur est une adresse e-mail. Lorsque la condition est remplie, un message Teams est envoyé à des personnes spécifiées.
    • Si vous avez sélectionné l’option de message de conversation de groupe, sélectionnez une conversation de groupe dans la liste déroulante. Lorsque la condition est remplie, un message est publié dans la conversation de groupe.
    • Si vous avez sélectionné l’option de publication de canal , sélectionnez une équipe et un canal. Lorsque la condition est remplie, un message est publié dans le canal.
  3. Pour Sujet, entrez un sujet pour le message Teams.

  4. Pour Notes, entrez des notes pour le message Teams.

    Note

    Lorsque vous entrez des titres ou des notes, vous pouvez faire référence à des propriétés dans les données en tapant @ ou en sélectionnant le bouton en regard des zones de texte. Par exemple : @BikepointID.

  5. Pour Context, sélectionnez des valeurs dans la liste déroulante que vous souhaitez inclure dans le contexte.

    Capture d’écran du volet Ajouter une règle avec l’option Envoyer un message Teams sélectionnée.

Exécuter des activités Fabric

Une règle d’activateur peut exécuter une activité Fabric définie dans l’un des types d’éléments Fabric suivants :

  • Flux de données
  • Pipeline
  • Tâche Spark
  • Notebook
  • Fonction
  • Tâche de copie
  • Publier un événement métier (préversion)

Pour configurer votre règle pour lancer une activité de Fabric, procédez comme suit :

  1. Pour Sélectionner une action, sélectionnez le type d’élément Fabric approprié dans la section « Exécuter les activités Fabric »

    Capture d’écran de l’option Exécuter des éléments Fabric.

  2. Dans Sélectionner l’élément Fabric à exécuter, sélectionnez l’élément Fabric dans la liste.

  3. Pour les types d’événements métier Pipeline, Dataflow, Notebook, job Spark et Publish (aperçu), sélectionnez Ajouter le paramètre et spécifiez le nom du paramètre pour l’élément Fabric ainsi qu’une valeur pour celui-ci. Vous pouvez ajouter plusieurs paramètres. Le type de job Copy n’accepte pas de paramètres.

    Capture d’écran du volet Ajouter une règle avec des paramètres pour un élément Fabric spécifié.

Exécuter la fonction

Si vous sélectionnez Exécuter la fonction, procédez comme suit pour sélectionner la fonction et spécifier les paramètres pour celui-ci :

  1. Pour la fonction, sélectionnez une fonction dans la liste.

  2. Pour les paramètres de la fonction, spécifiez des valeurs pour chacun des paramètres définis pour la fonction, comme indiqué dans l’exemple suivant :

    Capture d’écran du volet Ajouter une règle avec des paramètres pour une fonction spécifiée.

    Vous pouvez utiliser des propriétés à partir des données en tapant @ ou en sélectionnant le bouton en regard des zones de texte. Par exemple : @BikepointID.

Publier un événement métier (préversion)

Si vous sélectionnez Publier un événement métier (préversion), procédez comme suit pour sélectionner un schéma d’événement métier à partir du registre de schémas et spécifier des paramètres pour celui-ci :

  1. Lorsque vous sélectionnez Publier un événement professionnel (préversion), vous voyez la fenêtre Sélectionner un événement professionnel .

  2. Dans cette fenêtre, sélectionnez un schéma d’événement métier dans la liste des schémas inscrits dans le registre de schémas. Vous pouvez également rechercher un schéma en tapant son nom dans la zone de recherche.

    Capture d’écran de la fenêtre Sélectionner un événement professionnel.

  3. Pour les paramètres de l’événement métier, spécifiez des valeurs pour chacun des paramètres définis pour le schéma, comme indiqué dans l’exemple suivant :

Action personnalisée

Pour configurer l’alerte pour appeler une action personnalisée lorsque la condition est remplie, procédez comme suit :

  1. Pour Sélectionner une action, sélectionnez Créer une action personnalisée.

    Capture d’écran de la section Action avec une action personnalisée sélectionnée.

  2. Comme mentionné dans la section Action , créez d’abord la règle, puis effectuez la configuration de l’action personnalisée en suivant les étapes de Déclencheur d’actions personnalisées (flux Power Automate) .

    Capture d’écran de l’action personnalisée sélectionnée.

  3. Après avoir créé l’action personnalisée, dans le volet Définition de la règle, sélectionnez l’action personnalisée dans la liste déroulante Action .

    Capture d’écran de l’action personnalisée sélectionnée dans la liste déroulante Sélectionner une action.

Section Enregistrer l’emplacement

  1. Dans la section Enregistrer l'emplacement, pour l'espace de travail, sélectionnez l'espace de travail dans lequel vous souhaitez que l'activateur Fabric soit créé ou qu'il existe déjà.

  2. Pour Élément, sélectionnez un élément d’activateur existant ou créez-en un. Pour créer un élément d’activateur, sélectionnez Créer un élément, puis entrez un nom pour l’élément d’activateur.

    Capture d’écran montrant le volet Ajouter une règle avec l’emplacement de l’élément d’activateur Fabric sélectionné.

Créer la règle

  1. Dans la page Ajouter une règle , sélectionnez Créer pour créer la règle. Une fois la création de la règle réussie, elle s’exécute en fonction de la fréquence que vous avez définie dans la requête Exécuter chaque champ. Si la requête retourne des résultats, la règle déclenche les actions que vous définissez.
  2. Vous voyez la règle dans le volet Règles . Vous pouvez sélectionner la règle pour afficher ses détails, la modifier ou la supprimer ou l’ouvrir dans Activateor.

Volet Règles

Dans le volet Règles , vous pouvez effectuer les tâches suivantes :

  • Utilisez le bouton bascule pour activer ou désactiver la règle. Lorsque la règle est arrêtée, elle ne s’exécute pas et aucune alerte n’est envoyée. Une fois que vous voyez quelques exemples d’alertes, arrêtez la règle pour éviter d’envoyer trop d’alertes. Vous pouvez recommencer la règle lorsque vous souhaitez recevoir des alertes.

  • Utilisez le bouton Modifier pour modifier la règle sans quitter la page de l’éditeur de requête SQL. Vous pouvez modifier les détails, les conditions, les actions et l’emplacement d’enregistrement de la règle.

  • Utilisez le bouton Supprimer pour supprimer la règle.

  • Sélectionnez Afficher dans Activateur pour ouvrir la règle dans Activateur. Vous pouvez afficher les détails de la règle, le modifier ou le supprimer dans Activateor. Lorsque vous affichez l’activateur, vous pouvez également voir l’historique de la règle, notamment quand elle a été déclenchée et les alertes envoyées.

    Dans la page Activateur, sélectionnez le nom de l’événement, puis sélectionnez Gérer la source pour afficher la requête SQL qui a déclenché l’alerte. Si vous sélectionnez le lien de requête, vous revenez à la page de l’éditeur de requête SQL.

    Capture d’écran de la page d’événements Sample Warehouse avec un lien vers l’exemple d’entrepôt.

Exemple d’alerte

Voici un exemple de message Teams d’alerte que vous recevez lorsque l’alerte est déclenchée :

Capture d’écran de l’exemple de message d’alerte Teams.