Connecteur Azure Data Explorer pour Microsoft Power Automate
Important
Ce connecteur peut être utilisé en temps réel dans Microsoft Fabric. Utilisez les instructions de cet article avec les exceptions suivantes :
- Si nécessaire, créez des bases de données à l’aide des instructions de créer une base de données KQL.
- Si nécessaire, créez des tables à l’aide des instructions de Créer une table vide.
- Obtenir des URI de requête ou d’ingestion à l’aide des instructions de l’URI de copie.
- Exécutez des requêtes dans un ensemble de requêtes KQL.
Le connecteur Azure Data Explorer pour Power Automate (précédemment Microsoft Flow) vous permet d’orchestrer et de planifier des flux, d’envoyer des notifications et des alertes, dans le cadre d’une tâche planifiée ou déclenchée.
Vous pouvez :
- Envoyez des notifications et des alertes en fonction des résultats de la requête, par exemple lorsque les seuils dépassent certaines limites.
- Envoyez des rapports réguliers, tels que quotidiens ou hebdomadaires, contenant des tableaux et des graphiques.
- Planifiez des travaux réguliers à l’aide de commandes de gestion sur des clusters. Par exemple, copiez des données d’une table vers une autre à l’aide de la commande
.set-or-append
. - Exporter et importer des données entre Azure Data Explorer et d’autres bases de données.
Pour plus d’informations, consultez Exemples d’utilisation du connecteur Azure Data Explorer Power Automate.
Remarque
Pour qu’un Power Automate connecteur accède à un cluster protégé par le réseau, vous devez ajouter les adresses IP sortantes associées à la région de votre connecteur à la liste verte du pare-feu. Pour plus d’informations, consultez Gérer l’accès public à votre cluster Azure Data Explorer.
Créer un flux à l’aide du connecteur Azure Data Explorer
Pour utiliser le connecteur, vous devez d’abord ajouter un déclencheur. Vous pouvez définir un déclencheur en fonction d’une période récurrente ou en réponse à une action de flux antérieure.
Connectez-vous à Power Automate.
Créez un flux ou, à partir de la page d’accueil de Power Automate, sélectionnez Mes flux>+ Nouveau flux.
Sélectionnez Flux de cloud planifié.
Dans Créer un flux de cloud planifié, entrez les informations nécessaires.
Sélectionnez Créer>+ Nouvelle étape.
Dans la zone de recherche, entrez Kusto ou Azure Data Explorer, puis sélectionnez Azure Data Explorer.
Sélectionnez une action dans la liste. Pour obtenir une explication de chaque action et comment les configurer, consultez Actions du flux.
Important
Vous devez disposer d’une connexion Azure Data Explorer valide pour que votre flux s’exécute. Pour plus d’informations sur la création d’une connexion, consultez Créer une connexion Azure Data Explorer dans Power Automate.
Actions de flux
Lorsque vous sélectionnez le connecteur Azure Data Explorer, vous pouvez choisir l’une des actions suivantes à ajouter à votre flux :
- Exécuter une requête KQL
- Exécuter une requête KQL et afficher un graphique
- Exécuter une commande de gestion asynchrone
- Exécuter la commande de gestion et afficher un graphique
- Exécuter la commande de gestion show
Cette section décrit les fonctionnalités et les paramètres de chaque action et fournit un exemple montrant comment ajouter une action de messagerie à un flux.
Exécuter une requête KQL
Remarque
Si votre requête commence par un point, il s’agit d’une commande de gestion. Utilisez la commande Exécuter la gestion asynchrone.
Utilisez cette action pour interroger le cluster spécifié. Les actions ajoutées par la suite itèrent sur chaque ligne des résultats de la requête.
Si la requête prend plus de 8 minutes pour s’exécuter, elle échoue avec une exception « RequestTimeout ». Pour éviter ce problème, optimisez votre requête ou divisez-la en parties plus petites. Pour plus d’informations, consultez Bonnes pratiques relatives aux requêtes.
Exemple
Le flux suivant déclenche une requête toutes les minutes. La requête vérifie le nombre d’enregistrements dans la table, puis envoie un e-mail uniquement si le nombre d’enregistrements est supérieur à 0.
Exécuter une requête KQL et afficher un graphique
Remarque
Si votre requête commence par un point, il s’agit d’une commande de gestion. Utilisez la commande Exécuter la gestion et afficher un graphique.
Utilisez cette action pour visualiser le résultat d’une requête KQL sous forme de tableau ou de graphique. Par exemple, utilisez ce flux pour recevoir des rapports quotidiens par e-mail.
Si la requête prend plus de 8 minutes pour s’exécuter, elle échoue avec une exception « RequestTimeout ». Pour éviter ce problème, optimisez votre requête ou divisez-la en parties plus petites. Pour plus d’informations, consultez Bonnes pratiques relatives aux requêtes.
Exemple
Le flux suivant présente les résultats de la requête sous forme d’organigramme.
Exécuter une commande de gestion asynchrone
Utilisez cette action pour exécuter une commande de gestion de manière asynchrone, ce qui signifie qu’elle continuera à s’exécuter en arrière-plan. L’action retourne un ID, un état et un état. Pour vérifier l’état et les détails d’une commande asynchrone, utilisez la commande .show operations avec l’ID retourné par cette action.
Si la commande de gestion asynchrone prend plus de 60 minutes pour s’exécuter, elle échoue avec une exception « RequestTimeout ».
Exemple
Le flux suivant déclenche une commande asynchrone pour copier 10 enregistrements de la table « TransformSysLogs » vers le « TargetTable ». Notez que le mot clé « async » est requis dans la requête.
Exécuter la commande de gestion et afficher un graphique
Utilisez cette action pour exécuter une commande de gestion et afficher le résultat sous forme de graphique. Les options de graphique incluent un tableau HTML, un graphique en secteurs, un graphique chronologique et un graphique à barres.
Si la commande de gestion prend plus de 8 minutes pour s’exécuter, elle échoue avec une exception « RequestTimeout ».
Exécuter la commande de gestion show
Cette action exécute la commande show management et retourne le résultat qui peut être utilisé dans les connecteurs suivants.
Si la commande de gestion prend plus de 8 minutes pour s’exécuter, elle échoue avec une exception « RequestTimeout ».
Exemple
Le flux suivant exécute la commande d’opération .show pour rechercher l’état d’une commande asynchrone à l’aide d’un ID d’opération retourné par une exécution de commande asynchrone.
Envoyer par e-mail les résultats de la requête Kusto
Vous pouvez inclure une étape dans n’importe quel flux pour envoyer quelle adresse e-mail.
- Sélectionnez + Nouvelle étape pour ajouter une nouvelle étape à votre flux.
- Dans la zone de recherche, entrez Office 365, puis sélectionnez Office 365 Outlook.
- Sélectionnez l’action Envoyer un e-mail (V2).
- Entrez l’adresse e-mail à laquelle vous voulez envoyer le rapport par e-mail.
- Entrez l’objet de l’e-mail.
- Sélectionnez Mode Code.
- Placez le curseur dans le champ Corps, puis sélectionnez Ajouter du contenu dynamique.
- Sélectionnez BodyHtml.
- Sélectionnez Afficher les options avancées.
- Sous Nom des pièces jointes -1, sélectionnez Nom de la pièce jointe.
- Sous Contenu des pièces jointes, sélectionnez Contenu de la pièce jointe.
- Le cas échéant, ajoutez d’autres pièces jointes.
- Le cas échéant, définissez le niveau d’importance.
- Cliquez sur Enregistrer.
Créer une connexion Azure Data Explorer
Pour exécuter un flux qui contient un connecteur Azure Data Explorer, vous devez utiliser une connexion Azure Data Explorer valide. Vous pouvez créer et authentifier une nouvelle connexion à partir du volet gauche Power Automate, sélectionner Données>Connexions ou à partir du flux en sélectionnant le menu >Ajouter une nouvelle connexion du connecteur Azure Data Explorer.
Les étapes suivantes montrent comment créer une connexion à partir d’un flux.
Dans Exécuter une requête KQL, sélectionnez les trois points en haut à droite du connecteur Power Automate.
Sélectionnez Ajouter une nouvelle connexion. Quand vous vous connectez pour la première fois, vous êtes invité à vous connecter pour authentifier la connexion.
Authentification
Vous pouvez vous authentifier avec les informations d’identification de l’utilisateur ou avec une application Microsoft Entra. Pour vous authentifier avec des informations d’identification, sélectionnez Se connecter et entrez vos informations d’identification.
Pour s’authentifier avec un principal de service :
Sélectionnez Se connecter avec le principal de service.
Renseignez le formulaire avec les informations suivantes :
- Nom de la connexion : Nom descriptif et explicite pour la nouvelle connexion. Dans cet exemple, nous avons utilisé "MyApplication".
- ID client : votre ID d’application.
- Clé secrète client : clé de votre application.
- Locataire : ID du répertoire Microsoft Entra dans lequel vous avez créé l’application.
Remarque
Vérifiez que votre application est une application Microsoft Entra et est autorisée à exécuter des requêtes sur votre cluster.
Une fois l’authentification terminée, vérifiez que votre flux utilise la nouvelle connexion.
Une fois la connexion définie, le flux s’exécute à l’aide des informations d’identification de l’application.
Tester le flux
Pour vérifier si votre flux fonctionne, consultez l’historique des exécutions du flux :
Accédez à la page d’accueilPower Automate.
Dans le menu principal, sélectionnez Mes flux.
Sur la ligne du flux que vous voulez examiner, sélectionnez l’icône « Plus de commandes », puis Historique des exécutions.
Toutes les exécutions de flux sont listées, avec des informations concernant l’heure de début, la durée et l’état.
Pour obtenir des informations détaillées sur le flux, sur Mes flux, sélectionnez le flux que vous voulez examiner.
Pour déterminer la raison de l’échec d’une exécution, sélectionnez l’heure de début de l’exécution. Le flux s’affiche, et l’étape du flux qui a échoué est indiquée par un point d’exclamation rouge. Développez l’étape ayant échoué pour afficher les détails. Le volet Détails situé à droite contient des informations sur l’échec afin que vous puissiez résoudre le problème.
Limites
- Le nombre maximal d’enregistrements par requête est de 50 000 et la taille maximale des données par requête est de 32 Mo. Ces limites ne peuvent pas être modifiées.
- Les requêtes synchrones ont un délai d’expiration de 8 minutes.
- Les requêtes asynchrones ont un délai d’expiration de 60 minutes.
- Le connecteur ne prend pas en charge les opérateurs qui ne sont pas pris en charge par l’opérateur
getschema
. Par exemple, les opérateurs fork, facetet evaluate ne sont pas pris en charge. - Le fonctionnement des flux est optimal sur Microsoft Edge et Google Chrome.
Contenu connexe
- Utilisez la logique Azure Kusto Connecteur d’applications pour exécuter des requêtes et des commandes Kusto dans le cadre d’une tâche planifiée ou déclenchée.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour