Azure Data Explorer anslutning till Power Automate (förhandsversion)

Med Azure Data Explorer Power Automate (tidigare Microsoft Flow) kan Azure Data Explorer använda flödesfunktionerna i Microsoft Power Automate . Du kan köra Kusto-frågor och kommandon automatiskt som en del av en schemalagd eller utlöst uppgift.

Du kan:

  • Skicka dagliga rapporter som innehåller tabeller och diagram.
  • Ange meddelanden baserat på frågeresultat.
  • Schemalägg kontrollkommandon i kluster.
  • Exportera och importera data mellan Azure Data Explorer och andra databaser.

Mer information finns i Azure Data Explorer Power Automate connector usage examples.

Logga in

  1. När du ansluter för första gången uppmanas du att logga in.

  2. Välj Logga inoch ange dina autentiseringsuppgifter.

Skärmbild av Azure Data Explorer inloggningsfråga.

Autentisering

Du kan autentisera med användarautentiseringsuppgifter eller med ett Azure Active Directory-program (Azure AD).

Anteckning

Kontrollera att programmet är ett Azure AD-programoch har behörighet att köra frågor i klustret.

  1. I Kör kontrollkommando och visualisera resultatväljer du de tre punkterna längst upp till höger i flödesanslutningen.

    Skärmbild av kommandot Kör kontroll och visualisera resultat.

  2. Välj Lägg till ny Anslutmed tjänstens huvudnamn.

    Skärmbild av Azure Data Explorer inloggning med alternativet Anslut tjänstens huvudnamn.

  3. Ange nödvändig information:

    • Anslutningsnamn: Ett beskrivande och beskrivande namn för den nya anslutningen.
    • Klient-ID: Ditt program-ID.
    • Klienthemlighet: Din programnyckel.
    • Klientorganisation: ID:t för den Azure AD-katalog där du skapade programmet.

    Skärmbild Azure Data Explorer dialogrutan för programautentisering.

När autentiseringen är klar ser du att ditt flöde använder den nyligen tillagda anslutningen.

Skärmbild av slutförd programautentisering.

Från och med nu körs det här flödet med dessa programautentiseringsuppgifter.

Hitta Azure Kusto-anslutningsappen

Om du vill Power Automate använda anslutningsappen måste du först lägga till en utlösare. Du kan definiera en utlösare baserat på en återkommande tidsperiod eller som ett svar på en tidigare flödesåtgärd.

  1. Skapa ett nytt flöde,eller välj Mina flöden + Ny på Microsofts startsida.

    Skärmbild av Startsidan för Microsoft Power Automate med Mina flöden och Ny markerade.

  2. Välj Schemalagd – från tom.

    Skärmbild av dialogrutan Ny med Schemalagd från tom markerad.

  3. I Skapa ett schemalagt flödeanger du nödvändig information.

    Skärmbild av sidan Skapa ett schemalagt flöde med Flow alternativ för namn markerade.

  4. Välj Skapa+ Nytt steg.

  5. I sökrutan anger du Kustooch väljer Azure Data Explorer.

    Skärmbild av Välj åtgärdsalternativ med sökrutan och Azure Data Explorer markerade.

Flödesåtgärder

När du öppnar Azure Data Explorer finns det tre möjliga åtgärder som du kan lägga till i ditt flöde. I det här avsnittet beskrivs funktionerna och parametrarna för varje åtgärd.

Skärmbild av åtgärder Azure Data Explorer anslutningsappen.

Kör kontrollkommandot och visualisera resultat

Använd den här åtgärden för att köra ett kontrollkommando.

  1. Ange klustrets URL. Till exempel https://clusterName.eastus.kusto.windows.net.
  2. Ange namnet på databasen.
  3. Ange kontrollkommandot:
    • Välj dynamiskt innehåll från de appar och anslutningsappar som används i flödet.
    • Lägg till ett uttryck för att komma åt, konvertera och jämföra värden.
  4. Om du vill skicka resultatet av den här åtgärden via e-post som en tabell eller ett diagram anger du diagramtypen. Detta kan vara:
    • En HTML-tabell.
    • Ett cirkeldiagram.
    • Ett tidsdiagram.
    • Ett stapeldiagram.

Skärmbild av kommandot Kör kontroll och visualisera resultat i upprepningsfönstret.

Viktigt

I fältet Klusternamn anger du klustrets URL.

Köra fråga och lista resultat

Anteckning

Om frågan börjar med en punkt (vilket innebär att det är ett kontrollkommando)använder du Kommandot Kör kontroll och visualiserar resultatet.

Den här åtgärden skickar en fråga till Kusto-klustret. De åtgärder som läggs till itererar efteråt över varje rad i frågans resultat.

I följande exempel utlöses en fråga varje minut och ett e-postmeddelande skickas baserat på frågeresultatet. Frågan kontrollerar antalet rader i databasen och skickar sedan ett e-postmeddelande endast om antalet rader är större än 0.

Skärmbild av Kör fråga och lista resultat.

Anteckning

Om kolumnen har flera rader körs anslutningsappen för varje rad i kolumnen.

Köra frågor och visualisera resultat

Anteckning

Om frågan börjar med en punkt (vilket innebär att det är ett kontrollkommando)använder du Kommandot Kör kontroll och visualiserar resultatet.

Använd den här åtgärden för att visualisera ett Kusto-frågeresultat som en tabell eller ett diagram. Använd till exempel det här flödet för att ta emot dagliga rapporter via e-post.

I det här exemplet returneras resultatet av frågan som en HTML-tabell.

Skärmbild av Kör fråga och visualisera resultat.

Viktigt

I fältet Klusternamn anger du klustrets URL.

Skicka kusto-frågeresultat via e-post

Du kan inkludera ett steg i ett flöde för att skicka rapporter via e-post till valfri e-postadress.

  1. Välj + Nytt steg för att lägga till ett nytt steg i flödet.
  2. I sökrutan anger du Office 365 och väljer Office 365 Outlook.
  3. Välj Skicka ett e-postmeddelande (V2).
  4. Ange den e-postadress som du vill att e-postrapporten ska skickas till.
  5. Ange ämnet för e-postmeddelandet.
  6. Välj Kodvy.
  7. Placera markören i fältet Brödtext och välj Lägg till dynamiskt innehåll.
  8. Välj BodyHtml. Skärmbild av dialogrutan Skicka ett e-postmeddelande med fältet Brödtext och BodyHtml markerat.
  9. Välj visa avancerade alternativ.
  10. Under Attachments Name -1 (Namn på bilagor -1)väljer du Attachment Name (Namn på bifogad fil).
  11. Under Innehåll i bifogade filerväljer du Bifogat innehåll.
  12. Om det behövs lägger du till fler bifogade filer.
  13. Om det behövs anger du prioritetsnivån.
  14. Välj Spara.

Skärmbild av dialogrutan Send an email (Skicka ett e-postmeddelande) med Attachments Name (Namn på bifogade filer) och Attachments Content (Bifogat innehåll) och Save (Spara) markerade.

Kontrollera om ditt flöde har lyckats

Information om hur du kontrollerar om ditt flöde har lyckats finns i flödets körningshistorik:

  1. Gå till Microsoft Power Automate home page .

  2. Välj Mina flöden på huvudmenyn.

    Skärmbild av Microsoft <span class= Power AutomateScreenshot of Microsoft <span class= huvudmenyn, med Mina flöden markerade" />

  3. På raden för det flöde som du vill undersöka väljer du ikonen fler kommandon och sedan Körningshistorik.

    Skärmbild av fliken Mina flöden med Körningshistorik markerat.

    Alla flödeskörningar visas med information om starttid, varaktighet och status. Skärmbild av resultatsidan körningshistorik.

    Om du vill ha fullständig information om flödet går du till Minaflöden och väljer det flöde som du vill undersöka.

    Skärmbild av sidan med fullständiga resultat för körningshistorik.

Om du vill se varför en körning misslyckades väljer du starttiden för körningen. Flödet visas och steget i flödet som misslyckades indikeras med ett rött utropstecken. Expandera det misslyckade steget för att visa information om det. Fönstret Information till höger innehåller information om felet så att du kan felsöka det.

Skärmbild av flödesfelsidan.

Tidsgränsundantag

Ditt flöde kan misslyckas och returnera ett "RequestTimeout"-undantag om det körs i mer än 90 sekunder.

Skärmbild av undantagsfelet för timeout för flödesbegäran.

Du kan åtgärda ett timeout-problem genom att göra frågan effektivare så att den körs snabbare eller dela upp den i segment. Varje segment kan köras på olika delar av frågan. Mer information finns i Metodtips för frågor.

Samma fråga kan köras i Azure Data Explorer, där tiden inte är begränsad och kan ändras.

Begränsningar

  • Resultat som returneras till klienten är begränsade till 500 000 poster. Det totala minnet för dessa poster får inte överstiga 64 MB och körningstiden är 90 sekunder.
  • Anslutningsappen stöder inte operatorer som inte stöds av operatorn. Till exempel stöds inte operatorernaför för- , fasett- och utvärdering.
  • Flow fungerar bäst på Microsoft Edge och Google Chrome.

Nästa steg

Lär dig mer om Azure Kusto Logic Anslutningsverktyg, vilket är ett annat sätt att köra Kusto-frågor och kommandon automatiskt som en del av en schemalagd eller utlöst uppgift.