Azure Data Explorer-Connector für Microsoft Power Automate

Wichtig

Dieser Connector kann in Echtzeitanalyse in Microsoft Fabric verwendet werden. Verwenden Sie die Anweisungen in diesem Artikel mit den folgenden Ausnahmen:

• Erstellen Sie bei Bedarf Datenbanken mithilfe der Anweisungen unter Erstellen einer KQL-Datenbank.
• Erstellen Sie bei Bedarf Tabellen mithilfe der Anweisungen unter Erstellen einer leeren Tabelle.
• Rufen Sie Abfrage- oder Erfassungs-URIs mithilfe der Anweisungen unter Kopieren von URI ab.
• Führen Sie Abfragen in einem KQL-Abfrageset aus.

Der Azure Data Explorer Connector für Power Automate (zuvor Microsoft Flow) ermöglicht es Ihnen, Abläufe zu orchestrieren und zu planen, Benachrichtigungen und Warnungen als Teil eines geplanten oder ausgelösten Vorgangs zu koordinieren und zu planen.

Sie haben folgende Möglichkeiten:

• Senden sie Benachrichtigungen und Warnungen basierend auf Abfrageergebnissen, z. B. wenn Schwellenwerte bestimmte Grenzwerte überschreiten.
• Senden Sie regelmäßig, z. B. täglich oder wöchentlich, Berichte mit Tabellen und Diagrammen.
• Planen Sie reguläre Aufträge mithilfe von Verwaltungsbefehlen in Clustern. Kopieren Sie beispielsweise Daten aus einer Tabelle mithilfe des Befehls .set-or-append in eine andere.
• Exportieren und Importieren von Daten zwischen Azure Data Explorer und anderen Datenbanken

Weitere Informationen finden Sie unter Anwendungsbeispiele für den Azure Data Explorer-Connector für Power Automate (Vorschauversion).

Hinweis

Damit ein Power Automate Connector auf einen netzwerkgeschützten Cluster zugreifen kann, müssen Sie der Firewall-Zulassungsliste die ausgehenden IP-Adressen hinzufügen, die der Region Ihres Connectors zugeordnet sind. Weitere Informationen finden Sie unter Verwalten des öffentlichen Zugriffs auf Ihren Azure Data Explorer-Cluster.

Erstellen eines neuen Flow mithilfe des Azure Data Explorer-Connectors

Um den Connector zu verwenden, müssen Sie zunächst einen Trigger hinzufügen. Sie können einen Trigger auf der Grundlage eines wiederkehrenden Zeitraums oder als Reaktion auf eine vorherige Flow-Aktion festlegen.

1. Melden Sie sich bei Power Automate an.

2. Erstellen Sie einen neuen Flow, oder wählen Sie auf der StartseitePower Automate die Optionen Meine Flows>+ Neuer Flow aus.

   

3. Wählen Sie Geplanter Cloud-Flow aus.

   

4. Geben Sie unter Geplanten Cloud-Flow erstellen die erforderlichen Informationen ein.

   

5. Wählen Sie Erstellen>+ Neuer Schritt aus.

6. Geben Sie in das Suchfeld Kusto oder Azure Data Explorer ein, und wählen Sie Azure Data Explorer aus.

   

7. Wählen Sie eine Aktion aus der Liste aus. Eine Erläuterung der einzelnen Aktionen und deren Konfiguration finden Sie unter Flow-Aktionen.

   Wichtig

   Sie müssen über eine gültige Azure-Data Explorer-Verbindung verfügen, damit Ihr Ablauf ausgeführt werden kann. Informationen zum Erstellen einer Verbindung finden Sie unter Erstellen einer Azure Data Explorer-Verbindung in Power Automate.

   

Flow-Aktionen

Wenn Sie den Azure Data Explorer-Connector auswählen, können Sie eine der folgenden Aktionen auswählen, die Ihrem Flow hinzugefügt werden sollen:

• Ausführen einer KQL-Abfrage
• Ausführen einer KQL-Abfrage und Rendern eines Diagramms
• Ausführen des asynchronen Verwaltungsbefehls
• Ausführen des Verwaltungsbefehls und Rendern eines Diagramms
• Ausführen des Befehls "Show-Verwaltung"

In diesem Abschnitt werden die Funktionen und Parameter für jede Aktion beschrieben und ein Beispiel zum Hinzufügen einer E-Mail-Aktion zu jedem Flow bereitgestellt.

KQL-Abfrage ausführen

Hinweis

Wenn Ihre Abfrage mit einem Punkt beginnt, handelt es sich um einen Verwaltungsbefehl. Verwenden Sie den Befehl "asynchrone Verwaltung ausführen".

Verwenden Sie diese Aktion, um den angegebenen Cluster abzufragen. Die Aktionen, die später hinzugefügt werden, durchlaufen jede Zeile der Ergebnisse der Abfrage.

Wenn die Ausführung der Abfrage mehr als 8 Minuten dauert, tritt ein Fehler mit der Ausnahme "RequestTimeout" auf. Um dieses Problem zu vermeiden, optimieren Sie Ihre Abfrage, oder teilen Sie sie in kleinere Teile auf. Weitere Informationen finden Sie unter Bewährte Methoden für Abfragen.

Beispiel

Der folgende Flow löst jede Minute eine Abfrage aus. Die Abfrage überprüft die Anzahl der Datensätze in der Tabelle und sendet nur dann eine E-Mail, wenn die Anzahl der Datensätze größer als 0 ist.

Ausführen einer KQL-Abfrage und Rendern eines Diagramms

Hinweis

Wenn Ihre Abfrage mit einem Punkt beginnt, handelt es sich um einen Verwaltungsbefehl. Verwenden Sie den Befehl Verwaltung ausführen, und rendern Sie ein Diagramm.

Verwenden Sie diese Aktion, um ein KQL-Abfrageergebnis als Tabelle oder Diagramm zu visualisieren. Verwenden Sie diesen Flow beispielsweise, um tägliche Berichte per E-Mail zu erhalten.

Wenn die Ausführung der Abfrage mehr als 8 Minuten dauert, tritt ein Fehler mit der Ausnahme "RequestTimeout" auf. Um dieses Problem zu vermeiden, optimieren Sie Ihre Abfrage, oder teilen Sie sie in kleinere Teile auf. Weitere Informationen finden Sie unter Bewährte Methoden für Abfragen.

Beispiel

Der folgende Flow stellt die Abfrageergebnisse als Zeitdiagramm dar.

Ausführen des asynchronen Verwaltungsbefehls

Verwenden Sie diese Aktion, um einen Verwaltungsbefehl asynchron auszuführen, was bedeutet, dass er weiterhin im Hintergrund ausgeführt wird. Die Aktion gibt eine ID, einen Zustand und status zurück. Um die status und Details eines asynchronen Befehls zu überprüfen, verwenden Sie den Befehl .show operations mit der von dieser Aktion zurückgegebenen ID.

Wenn die Ausführung des asynchronen Verwaltungsbefehls mehr als 60 Minuten dauert, tritt ein Fehler mit der Ausnahme "RequestTimeout" auf.

Beispiel

Der folgende Flow löst einen asynchronen Befehl aus, um 10 Datensätze aus der Tabelle "TransformedSysLogs" in die "TargetTable" zu kopieren. Beachten Sie, dass die "asynchrone" Schlüsselwort (keyword) in der Abfrage erforderlich ist.

Ausführen des Verwaltungsbefehls und Rendern eines Diagramms

Verwenden Sie diese Aktion, um einen Verwaltungsbefehl auszuführen und das Ergebnis als Diagramm anzuzeigen. Die Diagrammoptionen umfassen eine HTML-Tabelle, ein Kreisdiagramm, ein Zeitdiagramm und ein Balkendiagramm.

Wenn die Ausführung des Verwaltungsbefehls mehr als 8 Minuten dauert, tritt ein Fehler mit der Ausnahme "RequestTimeout" auf.

Ausführen des Befehls "Show-Verwaltung"

Diese Aktion führt den Befehl show management aus und gibt das Ergebnis zurück, das in den folgenden Connectors verwendet werden kann.

Wenn die Ausführung des Verwaltungsbefehls mehr als 8 Minuten dauert, tritt ein Fehler mit der Ausnahme "RequestTimeout" auf.

Beispiel

Im folgenden Flow wird der Befehl .show-Vorgang ausgeführt, um die status eines asynchronen Befehls mithilfe einer Vorgangs-ID zu ermitteln, die von einer asynchronen Befehlsausführung zurückgegeben wird.

Kusto-Abfrageergebnisse per E-Mail senden

Sie können einen Schritt in einen beliebigen Flow einbeziehen, um Berichte per E-Mail an eine beliebige E-Mail-Adresse zu senden.

1. Wählen Sie + Neuer Schritt aus, um einen neuen Schritt zu Ihrem Flow hinzuzufügen.
2. Geben Sie in das Suchfeld Office 365 ein, und wählen Sie Office 365 Outlook aus.
3. Wählen Sie E-Mail senden (V2) aus.
4. Geben Sie die E-Mail-Adresse ein, an die der E-Mail-Bericht gesendet werden soll.
5. Geben Sie den Betreff der E-Mail ein.
6. Wählen Sie Codeansicht aus.
7. Platzieren Sie den Cursor in das Feld Text, und wählen Sie Dynamischen Inhalt hinzufügen aus.
8. Wählen Sie BodyHtml aus.
9. Wählen Sie Erweiterte Optionen anzeigen aus.
10. Wählen Sie unter Anlagenname -1 die Option Anlagenname aus.
11. Wählen Sie unter Anlageninhalt die Option Anlageninhalt aus.
12. Fügen Sie bei Bedarf weitere Anlagen hinzu.
13. Legen Sie, falls erforderlich, die Wichtigkeitsstufe fest.
14. Wählen Sie Speichern aus.

Erstellen einer Azure Data Explorer-Verbindung

Um einen Fluss auszuführen, der einen Azure Data Explorer Connector enthält, müssen Sie eine gültige Azure-Data Explorer-Verbindung verwenden. Sie können eine neue Verbindung aus dem linken Bereich Power Automate erstellen und authentifizieren, Daten>Verbindungen oder innerhalb des Flows auswählen, indem Sie das Menü des Azure Data Explorer Connectors >Neue Verbindung hinzufügen auswählen.

Die folgenden Schritte zeigen, wie Sie eine Verbindung innerhalb eines Flow erstellen.

1. Wählen Sie unter KQL-Abfrage auswählen die drei Punkte oben rechts im Power Automate Connector.

   

2. Wählen Sie Neue Verbindung hinzufügen aus. Wenn Sie zum ersten Mal eine Verbindung herstellen, werden Sie aufgefordert, sich anzumelden, um die Verbindung zu authentifizieren.

   

Authentifizierung

Sie können sich mit Benutzeranmeldeinformationen oder mit einer Microsoft Entra-Anwendung authentifizieren. Wenn Sie sich mit Anmeldeinformationen authentifizieren möchten, wählen Sie Anmelden aus, und geben Sie Ihre Anmeldeinformationen ein.

Authentifizieren mit einem Dienstprinzipal:

1. Klicken Sie auf Verbindung über Dienstprinzipal herstellen.

2. Füllen Sie das Formular mit den folgenden Informationen aus:

   • Verbindungsname: Ein beschreibender und aussagekräftiger Name für die neue Verbindung. In diesem Beispiel haben wir „MyApplication“ verwendet.
   • Client-ID: Ihre Anwendungs-ID
   • Geheimer Clientschlüssel: Ihr Anwendungsschlüssel
   • Mandant: Die ID des Microsoft Entra Verzeichnisses, in dem Sie die Anwendung erstellt haben.

   Hinweis

   Stellen Sie sicher, dass Ihre Anwendung eine Microsoft Entra-Anwendung ist und zum Ausführen von Abfragen in Ihrem Cluster autorisiert ist.

   

   Wenn die Authentifizierung abgeschlossen ist, vergewissern Sie sich, dass Ihr Flow die neue Verbindung verwendet.

   

   Nachdem die Verbindung festgelegt wurde, wird der Flow mit den Anwendungsanmeldeinformationen ausgeführt.

Testen des Flows

Um zu überprüfen, ob Ihr Flow erfolgreich war, betrachten Sie sich den Verlauf des Flows:

1. Wechseln Sie zur Power Automate Startseite.

2. Wählen Sie im Hauptmenü Meine Flows aus.

   

3. Wählen Sie in der Zeile des Flows, den Sie untersuchen möchten, das Symbol für weitere Befehle und dann Ausführungsverlauf aus.

   

   Alle Flowausführungen werden mit Informationen zu Startzeit, Dauer und Status aufgelistet.

   Wählen Sie zum Abrufen der vollständigen Details zum Flow auf der Seite Meine Flows den Flow aus, den Sie untersuchen möchten.

   

Wählen Sie die Startzeit der Ausführung aus, um zu prüfen, warum bei der Ausführung ein Fehler aufgetreten ist. Der Flow wird angezeigt, und der fehlerhafte Schritt des Flows wird durch ein rotes Ausrufezeichen gekennzeichnet. Erweitern Sie den fehlerhaften Schritt, um seine Details anzuzeigen. Der Bereich Details auf der rechten Seite enthält Informationen zu dem Fehler, damit Sie ihn beheben können.

Einschränkungen

• Die maximale Anzahl von Datensätzen pro Anforderung beträgt 50.000 und die maximale Datengröße pro Anforderung 32 MB. Diese Grenzwerte können nicht geändert werden.
• Synchrone Anforderungen weisen ein Timeout von 8 Minuten auf.
• Asynchrone Anforderungen weisen ein Timeout von 60 Minuten auf.
• Der Connector unterstützt keine Operatoren, die vom getschema-Operator nicht unterstützt werden. Beispielsweise werden die Operatoren fork, facet und evaluate nicht unterstützt.
• Flows funktionieren am besten mit Microsoft Edge und Google Chrome.

Verwandte Inhalte

• Verwenden Sie den Azure Kusto Logic App-Connector , um Kusto-Abfragen und -Befehle als Teil einer geplanten oder ausgelösten Aufgabe auszuführen.