Azure Data Explorer connector naar Power Automate (preview)

  • Artikel
  • 5 minuten om te lezen

Met Azure Data Explorer Power Automate (voorheen Microsoft Flow) connector Azure Data Explorer de stroommogelijkheden van Microsoft Power Automate gebruiken. U kunt Kusto-query's en -opdrachten automatisch uitvoeren als onderdeel van een geplande of geactiveerde taak.

U kunt:

  • Dagelijkse rapporten met tabellen en grafieken verzenden.
  • Stel meldingen in op basis van queryresultaten.
  • Plan besturingsopdrachten op clusters.
  • Gegevens exporteren en importeren tussen Azure Data Explorer en andere databases.

Voor meer informatie raadpleegt u Azure Data Explorer Power Automate connector usage examples.

Aanmelden

  1. Wanneer u voor de eerste keer verbinding maakt, wordt u gevraagd u aan te melden.

  2. Selecteer Aanmelden envoer uw referenties in.

Schermopname van Azure Data Explorer aanmeldingsprompt.

Verificatie

U kunt verifiëren met gebruikersreferenties of met een Azure Active Directory (Azure AD)-toepassing.

Notitie

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

  1. Selecteer in De besturingsopdracht uitvoeren en resultatenvisualiseren de drie puntjes rechtsboven in de stroomconnector.

    Schermopname van de opdracht Besturingselement uitvoeren en resultaten visualiseren.

  2. Selecteer Add new connectionVerbinding maken with Service Principal.

    Schermopname van Azure Data Explorer aanmeldingsprompt, met Verbinding maken met de optie Service-principal.

  3. Voer de vereiste gegevens in:

    • Verbindingsnaam: Een beschrijvende en betekenisvolle naam voor de nieuwe verbinding.
    • Client-id: uw toepassings-id.
    • Clientgeheim: uw toepassingssleutel.
    • Tenant: de id van de Azure AD-directory waarin u de toepassing hebt gemaakt.

    Schermopname van Azure Data Explorer het dialoogvenster Toepassingsverificatie.

Wanneer de verificatie is voltooid, ziet u dat uw stroom gebruikmaakt van de zojuist toegevoegde verbinding.

Schermopname van voltooide toepassingsverificatie.

Vanaf nu wordt deze stroom uitgevoerd met behulp van deze toepassingsreferenties.

De Azure Kusto-connector zoeken

Als u de Power Automate 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 vorige stroomactie.

  1. Maak een nieuwe stroomof selecteer op de startpagina van Microsoft de optie Mijn stromen+ Nieuw.

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

  2. Selecteer Gepland, van leeg.

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

  3. Voer in Een geplande stroom bouwende vereiste gegevens in.

    Schermopname van de pagina Een geplande stroom maken, met Flow naamopties gemarkeerd.

  4. Selecteer Maken+ Nieuwe stap.

  5. Voer kustoin het zoekvak in en selecteer Azure Data Explorer.

    Schermopname van Een actie-optie kiezen, met het zoekvak en Azure Data Explorer gemarkeerd.

Stroomacties

Wanneer u de connector Azure Data Explorer, zijn er drie mogelijke acties die u aan uw stroom kunt toevoegen. In deze sectie worden de mogelijkheden en parameters voor elke actie beschreven.

Schermopname van Azure Data Explorer connectoracties.

Besturingsopdracht uitvoeren en resultaten visualiseren

Gebruik deze actie om een besturingsopdracht uit te voeren.

  1. Geef de cluster-URL op. Bijvoorbeeld https://clusterName.eastus.kusto.windows.net.
  2. Voer de naam van de database in.
  3. Geef de besturingsopdracht op:
    • Selecteer dynamische inhoud in de apps en connectors die in de stroom worden gebruikt.
    • Voeg een expressie toe om waarden te openen, te converteren en te vergelijken.
  4. Als u de resultaten van deze actie per e-mail wilt verzenden als een tabel of grafiek, geeft u het grafiektype op. Dit kan zijn:
    • Een HTML-tabel.
    • Een cirkeldiagram.
    • Een tijddiagram.
    • Een staafdiagram.

Schermopname van de opdracht Besturingselement uitvoeren en resultaten visualiseren in het deelvenster Terugkeerpatroon.

Belangrijk

Voer in het veld Clusternaam de cluster-URL in.

Query uitvoeren en resultaten opvragen

Notitie

Als uw query begint met een punt (wat betekent dat het een besturingsopdracht is),gebruikt u de opdracht Besturingselement uitvoeren en visualiseert u de resultaten.

Met deze actie wordt een query naar het Kusto-cluster verzendt. De acties die later worden toegevoegd, worden over elke regel van de resultaten van de query heen uitgevoerd.

In het volgende voorbeeld wordt elke minuut een query uitgevoerd en wordt er een e-mailbericht verzonden op basis van de queryresultaten. De query controleert het aantal regels in de database en verzendt vervolgens alleen een e-mailbericht als het aantal regels groter is dan 0.

Schermopname van Query uitvoeren en resultatenlijst.

Notitie

Als de kolom meerdere regels heeft, wordt de connector uitgevoerd voor elke regel in de kolom.

Query uitvoeren en resultaten visualiseren

Notitie

Als uw query begint met een punt (wat betekent dat het een besturingsopdracht is),gebruikt u de opdracht Besturingselement uitvoeren en visualiseert u de resultaten.

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

In dit voorbeeld worden de resultaten van de query geretourneerd als een HTML-tabel.

Schermopname van Query uitvoeren en resultaten visualiseren.

Belangrijk

Voer in het veld Clusternaam de cluster-URL in.

Kusto-queryresultaten per e-mail verzenden

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

  1. Selecteer + Nieuwe stap om een nieuwe stap aan uw stroom toe te voegen.
  2. Typ in het zoekvak Office 365 en selecteer Office 365 Outlook.
  3. Selecteer Een e-mail verzenden (V2).
  4. Voer het e-mailadres in waarop 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 Hoofdgebied en selecteer Dynamische inhoud toevoegen.
  8. Selecteer BodyHtml. Schermopname van het dialoogvenster Een e-mail verzenden, met het veld Body en BodyHtml gemarkeerd.
  9. Selecteer Geavanceerde opties weergeven.
  10. Selecteer onder Naam bijlagen -1de optie Naam van bijlage.
  11. Selecteer bijlageinhoud onder Inhoudvan bijlagen.
  12. Voeg indien nodig meer bijlagen toe.
  13. Stel zo nodig het belangniveau in.
  14. Selecteer Opslaan.

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

Controleer of de stroom is geslaagd

Als u wilt controleren of de stroom is geslaagd, raadpleegt u de geschiedenis van de stroom:

  1. Ga naar Microsoft Power Automate home page de .

  2. Selecteer Mijn stromen in het hoofdmenu.

    Schermopname van Microsoft <span class=Power Automate Screenshot of Microsoft <span class= hoofdmenu, met Mijn stromen gemarkeerd' />

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

    Schermopname van het tabblad Mijn stromen, met De geschiedenis van de run gemarkeerd.

    Alle stroom runs worden weergegeven, met informatie over de begintijd, duur en status. Schermopname van de pagina met resultaten van de rungeschiedenis.

    Selecteer bij Mijn stromen de stroom die u wilt onderzoeken voor volledige informatie over de stroom.

    Schermopname van de pagina volledige resultaten van de rungeschiedenis.

Selecteer de begintijd van de run om te zien waarom een run is mislukt. De stroom wordt weergegeven en de stap van de mislukte stroom wordt aangegeven door 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 pagina stroomfout.

Time-outuitzonderingen

Uw stroom kan mislukken en een uitzondering 'RequestTimeout' retourneren als deze langer dan 90 seconden wordt uitgevoerd.

Schermopname van de uitzonderingsfout met de time-out van de stroomaanvraag.

Als u een time-outprobleem wilt oplossen, maakt u uw query efficiënter zodat deze sneller wordt uitgevoerd of scheidt u deze in segmenten. Elk segment kan worden uitgevoerd op een ander deel van de query. Zie Best practices voor query's voor meer informatie.

Dezelfde query kan worden uitgevoerd in Azure Data Explorer, waarbij de tijd niet beperkt is en kan worden gewijzigd.

Beperkingen

  • Resultaten die naar de client worden geretourneerd, zijn beperkt tot 500.000 records. Het totale geheugen voor deze records mag niet groter zijn dan 64 MB en een tijd van 90 seconden om uit te voeren.
  • De connector biedt geen ondersteuning voor operators die niet worden ondersteund door de operator. De operators fork,faceten evaluate worden bijvoorbeeld niet ondersteund.
  • Flow werkt het beste op Microsoft Edge en Google Chrome.

Volgende stappen

Meer informatie over de Azure Kusto Logic App-connector.Dit is een andere manier om Kusto-query's en -opdrachten automatisch uit te voeren als onderdeel van een geplande of geactiveerde taak.