Azure Data Explorer-connector voor MicrosoftPower Automate

  • Artikel

Belangrijk

Deze connector kan worden gebruikt in realtime analyses in Microsoft Fabric. Gebruik de instructies in dit artikel met de volgende uitzonderingen:

Met de Azure Data Explorer-connector voor Power Automate (voorheen Microsoft Flow) kunt u stromen organiseren en plannen, meldingen en waarschuwingen verzenden als onderdeel van een geplande of geactiveerde taak.

U kunt:

  • Meldingen en waarschuwingen verzenden op basis van queryresultaten, bijvoorbeeld wanneer drempelwaarden bepaalde limieten overschrijden.
  • Regelmatig rapporten verzenden, zoals dagelijks of wekelijks, met tabellen en grafieken.
  • Plan reguliere taken met behulp van beheeropdrachten op clusters. Kopieer bijvoorbeeld gegevens van de ene tabel naar de andere met behulp van de .set-or-append opdracht .
  • Gegevens exporteren en importeren tussen Azure Data Explorer en andere databases.

Zie Azure Data Explorer-connectorgebruiksvoorbeelden Power Automatevoor meer informatie.

Notitie

Als u een Power Automate connector toegang wilt geven tot een cluster met netwerkbeveiliging, moet u de uitgaande IP-adressen die zijn gekoppeld aan de regio van uw connector toevoegen aan de lijst met toegestane firewalls. Zie Openbare toegang tot uw Azure Data Explorer-cluster beheren voor meer informatie.

Een nieuwe stroom maken met behulp van de Azure Data Explorer-connector

Als u de connector wilt gebruiken, moet u eerst een trigger toevoegen. U kunt een trigger definiëren op basis van een terugkerende periode of als reactie op een eerdere stroomactie.

  1. Meld u aan bij Power Automate.

  2. Maak een nieuwe stroom of selecteer op de Power Automate startpagina Mijn stromen>+ Nieuwe stroom.

    Schermopname van de Power Automate startpagina, met Mijn stromen en Nieuw gemarkeerd.

  3. Selecteer Geplande cloudstroom.

    Schermopname van het dialoogvenster Nieuw, met Gepland van leeg gemarkeerd.

  4. Voer in Een geplande cloudstroom bouwen de vereiste gegevens in.

    Schermopname van de pagina Een geplande stroom maken, met opties voor stroomnaam gemarkeerd.

  5. Selecteer Maken>+ Nieuwe stap.

  6. Voer Kusto of Azure Data Explorer in het zoekvak in en selecteer Azure Data Explorer.

    Schermopname van het venster Kies een bewerking, met het zoekvak en Azure Data Explorer gemarkeerd.

  7. Selecteer een actie in de lijst. Zie Stroomacties voor een uitleg van elke actie en hoe u deze configureert.

    Belangrijk

    U moet een geldige Azure Data Explorer-verbinding hebben om uw stroom uit te voeren. Zie Een Azure Data Explorer-verbinding maken in Power Automatevoor meer informatie over het maken van een verbinding.

    Schermopname van de lijst Kies een actie, met de lijst met acties gemarkeerd.

Stroomacties

Wanneer u de Azure Data Explorer-connector selecteert, kunt u een van de volgende acties kiezen om toe te voegen aan uw stroom:

In deze sectie worden de mogelijkheden en parameters voor elke actie beschreven en wordt een voorbeeld weergegeven van het toevoegen van een e-mailactie aan een stroom.

KQL-query uitvoeren

Notitie

Als uw query begint met een punt, is het een beheeropdracht. Gebruik de opdracht Asynchroon beheer uitvoeren.

Gebruik deze actie om een query uit te voeren op het opgegeven cluster. De acties die daarna worden toegevoegd, worden herhaald op elke regel van de resultaten van de query.

Als het langer dan acht minuten duurt om de query uit te voeren, mislukt deze met een uitzondering 'RequestTimeout'. Om dit probleem te voorkomen, optimaliseert u de query of verdeelt u deze in kleinere delen. Zie Best practices voor query's voor meer informatie.

Voorbeeld

Met de volgende stroom wordt elke minuut een query geactiveerd. De query controleert het aantal records in de tabel en verzendt vervolgens alleen een e-mailbericht als het aantal records groter is dan 0.

Schermopname van de Azure Data Explorer-connector met de actie KQL-query uitvoeren.

KQL-query uitvoeren en een grafiek weergeven

Notitie

Als uw query begint met een punt, is het een beheeropdracht. Gebruik de opdracht Beheer uitvoeren om een grafiek weer te geven.

Gebruik deze actie om een KQL-queryresultaat te visualiseren als een tabel of grafiek. Gebruik deze stroom bijvoorbeeld om dagelijkse rapporten per e-mail te ontvangen.

Als het langer dan acht minuten duurt om de query uit te voeren, mislukt deze met een uitzondering 'RequestTimeout'. Om dit probleem te voorkomen, optimaliseert u de query of verdeelt u deze in kleinere delen. Zie Best practices voor query's voor meer informatie.

Voorbeeld

In de volgende stroom worden de queryresultaten weergegeven als een tijddiagram.

Schermopname van de Azure Data Explorer-connector met de actie KQL uitvoeren en een grafiek weergeven.

Opdracht asynchroon beheer uitvoeren

Gebruik deze actie om een beheeropdracht asynchroon uit te voeren, wat betekent dat deze op de achtergrond wordt uitgevoerd. De actie retourneert een id, status en status. Als u de status en details van een asynchrone opdracht wilt controleren, gebruikt u de opdracht .show operations met de id die door deze actie wordt geretourneerd.

Als het meer dan 60 minuten duurt voordat de asynchrone beheeropdracht is uitgevoerd, mislukt deze met een uitzondering 'RequestTimeout'.

Voorbeeld

Met de volgende stroom wordt een asynchrone opdracht geactiveerd om 10 records van de tabel 'TransformedSysLogs' naar de 'TargetTable' te kopiëren. Houd er rekening mee dat het trefwoord 'asynchroon' is vereist in de query.

Schermopname van de Azure Data Explorer-connector, met de opdrachtactie Asynchroon beheer uitvoeren.

Beheeropdracht uitvoeren en een grafiek weergeven

Gebruik deze actie om een beheeropdracht uit te voeren en het resultaat weer te geven als een grafiek. De grafiekopties omvatten een HTML-tabel, cirkeldiagram, tijddiagram en staafdiagram.

Als het meer dan 8 minuten duurt voordat de beheeropdracht is uitgevoerd, mislukt deze met een uitzondering 'RequestTimeout'.

Schermopname van de opdracht Beheer uitvoeren en een grafiek weergeven in het deelvenster Terugkeerpatroon.

De opdracht Beheer weergeven uitvoeren

Met deze actie wordt de opdracht beheer weergeven uitgevoerd en wordt het resultaat geretourneerd dat kan worden gebruikt in de volgende connectors.

Als het meer dan 8 minuten duurt voordat de beheeropdracht is uitgevoerd, mislukt deze met een uitzondering 'RequestTimeout'.

Voorbeeld

In de volgende stroom wordt de opdracht .show operation uitgevoerd om de status van een asynchrone opdracht te vinden met behulp van een bewerkings-id die wordt geretourneerd door het uitvoeren van een asynchrone opdracht.

Schermopname van de Azure Data Explorer-connector met de opdracht Run run show management.

Email Kusto-queryresultaten

U kunt een stap in elke stroom opnemen om rapporten per e-mail naar elk e-mailadres te verzenden.

  1. Selecteer + Nieuwe stap om een nieuwe stap toe te voegen aan uw stroom.
  2. Typ Office 365 in het zoekvak en selecteer Office 365 Outlook.
  3. Selecteer Een e-mail verzenden (V2).
  4. Voer het e-mailadres in waarnaar u het e-mailrapport wilt verzenden.
  5. Voer het onderwerp van het e-mailbericht in.
  6. Selecteer Codeweergave.
  7. Plaats de cursor in het veld Hoofdtekst en selecteer Dynamische inhoud toevoegen.
  8. Selecteer BodyHtml. Schermopname van het dialoogvenster Een e-mail verzenden, met het veld Hoofdtekst en BodyHtml gemarkeerd.
  9. Selecteer Geavanceerde opties weergeven.
  10. Selecteer onder Bijlagenaam -1de optie Bijlagenaam.
  11. Selecteer onder Inhoud van bijlagende optie Inhoud van bijlagen.
  12. Voeg indien nodig meer bijlagen toe.
  13. Stel indien nodig het urgentieniveau in.
  14. Selecteer Opslaan.

Schermopname van het dialoogvenster Een e-mail verzenden, met Naam van bijlagen, Inhoud van bijlagen en Opslaan gemarkeerd.

Een Azure Data Explorer-verbinding maken

Als u een stroom wilt uitvoeren die een Azure Data Explorer-connector bevat, moet u een geldige Azure Data Explorer-verbinding gebruiken. U kunt een nieuwe verbinding maken en verifiëren vanuit het Power Automate linkerdeelvenster, Gegevensverbindingen> selecteren of vanuit de stroom door het menu>Nieuwe verbinding toevoegen van de Azure Data Explorer-connector te selecteren.

In de volgende stappen ziet u hoe u een verbinding maakt vanuit een stroom.

  1. Selecteer in KQL-query uitvoeren de drie puntjes rechtsboven in de power automate-connector.

    Schermopname van Azure Data Explorer-verbinding met de verificatieoptie.

  2. Selecteer Nieuwe verbinding toevoegen. Wanneer u voor de eerste keer verbinding maakt, wordt u gevraagd u aan te melden om de verbinding te verifiëren.

    Schermopname van Azure Data Explorer-verbinding met de aanmeldingsoptie.

Verificatie

U kunt zich verifiëren met gebruikersreferenties of met een Microsoft Entra-toepassing. Als u zich wilt verifiëren met referenties, selecteert u Aanmelden en voert u uw referenties in.

Verifiëren met een service-principal:

  1. Selecteer Verbinding maken met service-principal.

  2. Vul het formulier in met de volgende gegevens:

    • Verbindingsnaam: een beschrijvende en betekenisvolle naam voor de nieuwe verbinding. In dit voorbeeld hebben we 'MyApplication' gebruikt.
    • Client-id: uw toepassings-id.
    • Clientgeheim: uw toepassingssleutel.
    • Tenant: de id van de Microsoft Entra map waarin u de toepassing hebt gemaakt.

    Notitie

    Zorg ervoor dat uw toepassing een Microsoft Entra-toepassing is en is gemachtigd om query's uit te voeren op uw cluster.

    Schermopname van Azure Data Explorer-verbinding, met het dialoogvenster voor toepassingsverificatie.

    Wanneer de verificatie is voltooid, controleert u of uw stroom gebruikmaakt van de nieuwe verbinding.

    Schermopname van de voltooide toepassingsverificatie.

    Zodra de verbinding is ingesteld, wordt de stroom uitgevoerd met behulp van de toepassingsreferenties.

De stroom testen

Als u wilt controleren of uw stroom werkt, controleert u de uitvoeringsgeschiedenis van de stroom:

  1. Ga naar de Power Automate startpagina.

  2. Selecteer Mijn stromen in het hoofdmenu.

    Schermopname van Power Automate het hoofdmenu, met Mijn stromen gemarkeerd.

  3. Selecteer in de rij van de stroom die u wilt onderzoeken het pictogram Meer opdrachten en selecteer vervolgens Uitvoeringsgeschiedenis.

    Schermopname van het tabblad Mijn stromen, met Uitvoeringsgeschiedenis gemarkeerd.

    Alle stroomuitvoeringen worden weergegeven, met informatie over begintijd, duur en status. Schermopname van de resultatenpagina Uitvoeringsgeschiedenis.

    Voor volledige informatie over de stroom selecteert u in Mijn stromen de stroom die u wilt onderzoeken.

    Schermopname van de volledige resultatenpagina Van uitvoeringsgeschiedenis.

Als u wilt zien waarom een uitvoering is mislukt, selecteert u de begintijd van de uitvoering. De stroom wordt weergegeven en de stap van de stroom die is mislukt, wordt aangegeven met een rood uitroepteken. Vouw de mislukte stap uit om de details ervan weer te geven. Het deelvenster Details aan de rechterkant bevat informatie over de fout, zodat u deze kunt oplossen.

Schermopname van de stroomuitvoering, met een foutbericht.

Beperkingen

  • Het maximum aantal records per aanvraag is 50.000 en de maximale gegevensgrootte per aanvraag is 32 MB. Deze limieten kunnen niet worden gewijzigd.
  • Synchrone aanvragen hebben een time-out van 8 minuten.
  • Asynchrone aanvragen hebben een time-out van 60 minuten.
  • De connector biedt geen ondersteuning voor operators die niet worden ondersteund door de getschema operator. De fork-, facet- en evaluatieoperators worden bijvoorbeeld niet ondersteund.
  • Stromen werken het beste in Microsoft Edge en Google Chrome.

Gerelateerde inhoud