Créer une règle dans Fabric Activateur

Lorsque vous apportez des données de diffusion en continu dans un activateur ou attribuez des événements à des objets, vous pouvez créer des règles pour agir sur vos données. L’activation de ces règles peut être l’envoi d’une notification, telle qu’un e-mail ou un message Teams. L’activation de ces règles peut également déclencher un flux de travail, par exemple démarrer un flux de Power Automate.

Les règles d’activateur peuvent également déclencher des actions basées sur des événements Fabric et des événements Azure Blob Storage reçus via Eventstream, ce qui permet l’orchestration pilotée par les événements. Par exemple, vous pouvez démarrer des travaux Spark ou des Dataflows lorsque des fichiers arrivent dans un conteneur Blob. Pour plus d’informations sur la connexion de sources d’événements, consultez Ajoutez une destination d’activateur de Fabric à un flux d’événements.

Conditions préalables

  • Un espace de travail avec une capacité Microsoft Fabric activée.

Ouvrir l’activateur

Conseil / Astuce

La création d’alertes et la gestion des règles sont également incorporées directement dans Fabric Eventstream. Vous pouvez créer et gérer des règles d’activateur dans le contexte lors de la configuration des flux d’événements, sans passer à une expérience d’activateur distincte.

Commencez par ouvrir Fabric dans votre navigateur.

Dans le volet de navigation, sélectionnez Créer>Activateur. Si vous ne voyez pas Créer, sélectionnez l'icône à trois points (...) pour afficher d’autres options.

Sélectionnez Essayer l’exemple pour créer un activateur prérempli avec des exemples d’événements et d’objets.

Définir une condition de règle et une action

Utilisez Règles pour spécifier les valeurs que vous souhaitez surveiller parmi les événements, les conditions que vous souhaitez détecter et les actions que vous souhaitez que Activator effectue.

Sélectionner vos données de règle

Dans l’explorateur Activator, sélectionnez la propriété ou le flux d’événements à surveiller dans votre règle. Pour plus d’informations sur les propriétés, consultez la section Créer des propriétés .

Après avoir sélectionné une propriété ou un flux d’événements, vous voyez un aperçu des valeurs d’un exemple d’instances de l’objet.

Note

L’activateur peut également surveiller les rapports de Power BI publiés et vous avertir lorsqu’une nouvelle ligne apparaît dans un visuel de tableau. Vous configurez cette surveillance à partir du Power BI service. La règle résultante peut déclencher les mêmes actions (e-mail, Teams, élément Fabric ou Power Automate). Pour plus d’informations, consultez Créer une alerte dans Power BI rapport.

Activateur prend en charge la création de règles sur les résultats des requêtes SQL du entrepôt de données Fabric (version préliminaire). Ces règles évaluent une requête SQL selon une planification configurable et déclenchent des actions lorsque des conditions sont remplies, ce qui permet une surveillance périodique des données de l’entrepôt.

Créer une nouvelle règle d’activateur

Pour créer une règle, sélectionnez le flux que vous venez d’ajouter. Vous voyez un volet Créer une règle sur le côté droit. La section Surveiller de la règle est préremplie avec le flux de données que vous avez sélectionné.

Définir la condition à détecter

Ensuite, choisissez le type de condition que vous souhaitez détecter. Vous pouvez utiliser des conditions qui vérifient :

  • Sur chaque événement, effectuez une action.
  • Sur chaque événement lorsqu’une valeur est remplie, effectuez une action.
  • Sur chaque événement regroupé par un champ, effectuez une action (par exemple, sur chaque événement PackageId lorsque la température est supérieure à 30)

Enfin, indiquez si vous souhaitez que l’action vous envoie un e-mail ou vous envoie un message Teams, puis sélectionnez Créer. Vous pouvez modifier les conditions et les actions ultérieurement.

Les graphiques de l’onglet Définition sont mis à jour pour afficher un exemple des événements qui répondent aux conditions que vous définissez.

Capture d’écran montrant une carte de détection dotée de deux graphiques.

Si vous accédez à l’onglet Analytique , vous voyez deux graphiques. Le premier graphique affiche le nombre total de fois que la règle a été déclenchée, pour tous les ID d’objet suivis par Activateor. Utilisez ce graphique pour comprendre le volume des notifications envoyées sur tous les ID d'objet. Le deuxième graphique affiche le nombre total de fois où la règle s’est activée, pour les cinq ID d’objet. Utilisez ce graphique pour mieux comprendre si des ID d’objet particuliers contribuent le plus à toutes les activations qui se déclenchent.

Définir l’action à entreprendre

Enfin, utilisez la section Action pour choisir ce qu’il faut faire lorsque la condition est détectée.

Capture d’écran montrant la sélection d’une action lorsqu’une condition est détectée.

Voici les types d’actions pris en charge :

  • E-mail : envoyez un e-mail aux destinataires spécifiés.

  • Teams : envoyez un message Teams aux destinataires spécifiés, à la conversation de groupe ou au canal.

  • Élément Fabric : exécutez le pipeline Fabric sélectionné, le bloc-notes Fabric, la définition de tâche Spark Fabric, le flux de données Fabric ou la fonction de données utilisateur Fabric. Utilisez ces actions pour implémenter des pipelines pilotés par les événements. Pour plus d’informations, consultez Trigger Fabric éléments.

  • Action Custom action - activez un flux Power Automate.

Capture d’écran de la section Action dans l’interface utilisateur activateur.

Différents types d’actions ont des paramètres différents. Certains de ces paramètres incluent l’adresse e-mail à laquelle vous souhaitez envoyer, le canal Teams ou la conversation de groupe, le flux de travail à démarrer, la ligne d’objet ou des informations supplémentaires (contexte). Pour Le contexte, vous pouvez sélectionner les propriétés supplémentaires à inclure dans le message d’alerte.

Vous pouvez également baliser des propriétés en entrant @ pour ajouter du contexte aux actions que vous envoyez. Par exemple : @bikeId.

Si vous effectuez un résumé sur la propriété dans la Carte de Moniteur, l'Action envoie la valeur d'origine de la propriété plutôt que la valeur résumée.

Sélectionnez Modifier l’action pour afficher un éditeur avec un aperçu du message que l’action envoie et options pour ajouter plus d’informations à l’action.

Tester votre règle

Après avoir créé une règle, testez-la en sélectionnant M’envoyer une alerte de test. Ce bouton permet de rechercher un événement passé pour lequel l’activation de la règle est vraie et d’envoyer une alerte afin que vous puissiez voir à quoi ressemble l’alerte pour cet événement.

  • L’alerte de test vous est toujours envoyée, quel que soit le champ destinataire dans la carte d’action .
  • L’option M’envoyer une alerte de test n’est activée que si vous avez au moins un événement passé pour lequel la condition de la règle est vraie.

Activer et désactiver votre règle

Les règles sont créés dans un état Arrêté. Cet état signifie que le système n’évalue pas la règle en tant que flux de données dans le système et que la règle n’effectue aucune action en conséquence. Après avoir défini la règle, sélectionnez Enregistrer et commencer à activer la règle. Si vous n’êtes pas prêt à démarrer votre règle, enregistrez-la et revenez-y ultérieurement. Lorsque vous êtes prêt, sélectionnez Démarrer dans la barre d’outils pour qu'Activator commence à exécuter le déclencheur et à effectuer une action.

Capture d’écran du démarrage d’une alerte.

Une fois démarrée, vous voyez En cours dans la zone de titre de la carte de règle. En outre, l’icône dans l’Explorateur montre que la règle est en cours d’exécution. Lorsque vous démarrez la règle, les nouvelles activations commencent à s’exécuter sur de nouvelles données ingérées. Votre règle ne s'active pas sur les données déjà ingérées. Pour arrêter l’alerte, sélectionnez Arrêter.

Si vous apportez des modifications à la règle (par exemple, modifiez la condition qu’elle recherche), sélectionnez Mettre à jour dans la barre d’outils pour vous assurer que la règle en cours d’exécution utilise les nouvelles valeurs.

Lorsque vous supprimez une règle (ou un objet), le traitement principal des données peut prendre jusqu’à cinq minutes. Les règles supprimées peuvent continuer à surveiller les données et à prendre des mesures en conséquence, pendant quelques minutes après leur suppression.

Créer des propriétés

Parfois, vous devez réutiliser la logique de règle sur plusieurs règles. Créez une propriété pour définir une condition ou une mesure réutilisable, puis référencez cette propriété à partir de plusieurs règles.

Pour créer une propriété, sélectionnez le flux que vous avez ajouté à l’objet qui vous intéresse, sélectionnez Nouvelle propriété dans le ruban, puis sélectionnez la propriété que vous souhaitez utiliser dans la logique de règle.

Capture d’écran montrant la création d’une propriété pour une alerte.

Après avoir défini une propriété, vous pouvez la référencer à partir d’une ou plusieurs règles. Dans cet exemple, vous référencez la propriété TemperatureTrop chaude pour la médecine.

Capture d’écran montrant la propriété trop chaud du package pour une alerte.

Nettoyer les ressources

Supprimez l’exemple de flux d’événements en sélectionnant les points de suspension (...) à droite du flux d’événements de livraison de colis , puis en sélectionnant Supprimer.

Étape suivante

Didacticiel sur l’activateur

Contenu connexe

  • Last updated on