Läs på engelska

Dela via


Azure Data Explorer-anslutningsprogram för MicrosoftPower Automate

Viktigt

Den här anslutningsappen kan användas i realtidsanalys i Microsoft Fabric. Följ anvisningarna i den här artikeln med följande undantag:

Med Azure Data Explorer-anslutningsappen för Power Automate (tidigare Microsoft Flow) kan du orkestrera och schemalägga flöden, skicka meddelanden och aviseringar som en del av en schemalagd eller utlöst uppgift.

Du kan:

  • Skicka meddelanden och aviseringar baserat på frågeresultat, till exempel när tröskelvärden överskrider vissa gränser.
  • Skicka vanliga rapporter, till exempel dagliga eller veckovisa, som innehåller tabeller och diagram.
  • Schemalägg vanliga jobb med hjälp av hanteringskommandon i kluster. Kopiera till exempel data från en tabell till en annan med kommandot .set-or-append .
  • Exportera och importera data mellan Azure Data Explorer och andra databaser.

Mer information finns i Användningsexempel för Azure Data Explorer-anslutningsprogramPower Automate.

Anteckning

För att en Power Automate anslutningsapp ska få åtkomst till ett nätverksskyddat kluster måste du lägga till de utgående IP-adresser som är associerade med regionen för anslutningsappen i listan över tillåtna brandväggar. Mer information finns i Hantera offentlig åtkomst till ditt Azure Data Explorer-kluster.

Skapa ett nytt flöde med azure Data Explorer-anslutningsappen

Om du vill 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. Logga in på Power Automate.

  2. Skapa ett nytt flöde eller välj flödet Mina flöden>+ Nytt på Power Automate startsidan.

    Skärmbild av Power Automate startsidan med Mina flöden och Nytt markerat.

  3. Välj Schemalagt molnflöde.

    Skärmbild av dialogrutan Ny, som visar Schemalagd från tom markerad.

  4. I Skapa ett schemalagt molnflöde anger du den information som krävs.

    Skärmbild av sidan Skapa ett schemalagt flöde med alternativen för flödesnamn markerade.

  5. Välj Skapa>+ Nytt steg.

  6. I sökrutan anger du Kusto eller Azure Data Explorer och väljer Azure Data Explorer.

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

  7. Välj en åtgärd i listan. En förklaring av varje åtgärd och hur du konfigurerar dem finns i Flödesåtgärder.

    Viktigt

    Du måste ha en giltig Azure Data Explorer-anslutning för att flödet ska kunna köras. Information om hur du skapar en anslutning finns i Skapa en Azure Data Explorer-anslutning i Power Automate.

    Skärmbild av listan Välj en åtgärd med listan över åtgärder markerad.

Flödesåtgärder

När du väljer Azure Data Explorer-anslutningsappen kan du välja någon av följande åtgärder att lägga till i ditt flöde:

Det här avsnittet beskriver funktionerna och parametrarna för varje åtgärd och innehåller ett exempel som visar hur du lägger till en e-poståtgärd i ett flöde.

Köra KQL-fråga

Anteckning

Om frågan börjar med en punkt är det ett hanteringskommando. Använd kommandot Kör asynkron hantering.

Använd den här åtgärden för att fråga det angivna klustret. De åtgärder som läggs till efteråt itererar över varje rad i frågans resultat.

Om frågan tar mer än 8 minuter att köra misslyckas den med undantaget RequestTimeout. Du kan förhindra det här problemet genom att optimera frågan eller dela upp den i mindre delar. Mer information finns i Metodtips för frågor.

Exempel

Följande flöde utlöser en fråga varje minut. Frågan kontrollerar antalet poster i tabellen och skickar sedan ett e-postmeddelande endast om antalet poster är större än 0.

Skärmbild av Azure Data Explorer-anslutningsappen med frågeåtgärden Kör KQL.

Köra KQL-fråga och rendera ett diagram

Anteckning

Om frågan börjar med en punkt är det ett hanteringskommando. Använd kommandot Kör hantering och rendera ett diagram.

Använd den här åtgärden för att visualisera ett KQL-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.

Om frågan tar mer än 8 minuter att köra misslyckas den med undantaget RequestTimeout. Du kan förhindra det här problemet genom att optimera frågan eller dela upp den i mindre delar. Mer information finns i Metodtips för frågor.

Exempel

Följande flöde visar frågeresultatet som ett tidsschema.

Skärmbild av Azure Data Explorer-anslutningsappen som visar åtgärden Kör KQL-fråga och rendera ett diagram.

Kör asynkront hanteringskommando

Använd den här åtgärden för att köra ett hanteringskommando asynkront, vilket innebär att det fortsätter att köras i bakgrunden. Åtgärden returnerar ett ID, tillstånd och status. Om du vill kontrollera status och information om ett asynkront kommando använder du kommandot .show operations med det ID som returneras av den här åtgärden.

Om det tar mer än 60 minuter att köra kommandot asynkron hantering misslyckas det med undantaget RequestTimeout.

Exempel

Följande flöde utlöser ett asynkront kommando för att kopiera 10 poster från tabellen TransformSysLogs till TargetTable. Observera att nyckelordet "async" krävs i frågan.

Skärmbild av Azure Data Explorer-anslutningsappen som visar kommandoåtgärden Kör asynkron hantering.

Kör hanteringskommandot och rendera ett diagram

Använd den här åtgärden för att köra ett hanteringskommando och visa resultatet som ett diagram. Diagramalternativen omfattar en HTML-tabell, ett cirkeldiagram, ett tidsdiagram och ett stapeldiagram.

Om det tar mer än 8 minuter att köra hanteringskommandot misslyckas det med undantaget RequestTimeout.

Skärmbild av kommandot Kör hantering och rendera ett diagram i fönstret Upprepning.

Kör kommandot show management

Den här åtgärden kör kommandot show management och returnerar resultatet som kan användas i följande anslutningsappar.

Om det tar mer än 8 minuter att köra hanteringskommandot misslyckas det med undantaget RequestTimeout.

Exempel

Följande flöde kör kommandot .show operation för att hitta status för ett asynkront kommando med hjälp av ett åtgärds-ID som returneras av en asynkron kommandokörning.

Skärmbild av Azure Data Explorer-anslutningsappen som visar kommandoåtgärden Kör visa hantering.

Email Kusto-frågeresultat

Du kan inkludera ett steg i valfritt 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 ditt flöde.
  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 Namn på bifogade filer -1 väljer du Namn på bifogad fil.
  11. Under Innehåll i bifogade filer väljer du Bifogat innehåll.
  12. Lägg till fler bifogade filer om det behövs.
  13. Ange prioritetsnivån om det behövs.
  14. Välj Spara.

Skärmbild av dialogrutan Skicka ett e-postmeddelande med Namn på bifogade filer, Innehåll på bifogade filer och Spara markerat.

Skapa en Azure Data Explorer-anslutning

Om du vill köra ett flöde som innehåller en Azure Data Explorer-anslutningsapp måste du använda en giltig Azure Data Explorer-anslutning. Du kan skapa och autentisera en ny anslutning i den Power Automate vänstra rutan, väljaDataanslutningar> eller inifrån flödet genom att välja azure Data Explorer-anslutningsappens meny >Lägg till ny anslutning.

Följande steg visar hur du skapar en anslutning inifrån ett flöde.

  1. I Kör KQL-fråga väljer du de tre punkterna längst upp till höger i power automate-anslutningsappen.

    Skärmbild av Azure Data Explorer-anslutning med autentiseringsalternativet.

  2. Välj Lägg till ny anslutning. När du ansluter för första gången uppmanas du att logga in för att autentisera anslutningen.

    Skärmbild av Azure Data Explorer-anslutning med inloggningsalternativet.

Autentisering

Du kan autentisera med användarautentiseringsuppgifter eller med ett Microsoft Entra program. Om du vill autentisera med autentiseringsuppgifter väljer du Logga in och anger dina autentiseringsuppgifter.

Så här autentiserar du med tjänstens huvudnamn:

  1. Välj Anslut med tjänstens huvudnamn.

  2. Fyll i formuläret med följande information:

    • Anslutningsnamn: Ett beskrivande och beskrivande namn för den nya anslutningen. I det här exemplet har vi använt "MyApplication".
    • Klient-ID: Ditt program-ID.
    • Klienthemlighet: Din programnyckel.
    • Klientorganisation: ID:t för den Microsoft Entra katalog där du skapade programmet.

    Anteckning

    Kontrollera att programmet är ett Microsoft Entra program och har behörighet att köra frågor på klustret.

    Skärmbild av Azure Data Explorer-anslutning som visar dialogrutan för programautentisering.

    När autentiseringen är klar kontrollerar du att ditt flöde använder den nya anslutningen.

    Skärmbild av den slutförda programautentiseringen.

    När anslutningen har angetts körs flödet med autentiseringsuppgifterna för programmet.

Testa flödet

Kontrollera om flödet fungerar genom att kontrollera flödets körningshistorik:

  1. Gå till Power Automate startsidan.

  2. På huvudmenyn väljer du Mina flöden.

    Skärmbild av Power Automate huvudmenyn med Mina flöden markerade.

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

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

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

    Om du vill ha fullständig information om flödet går du till Mina flö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 körningens starttid. Flödet visas och steget i flödet som misslyckades indikeras av ett rött utropstecken. Expandera det misslyckade steget för att visa dess information. Fönstret Information till höger innehåller information om felet så att du kan felsöka det.

Skärmbild av flödeskörning som visar ett felmeddelande.

Begränsningar

  • Det maximala antalet poster per begäran är 50 000 och den maximala datastorleken per begäran är 32 MB. Dessa gränser kan inte ändras.
  • Synkrona begäranden har en tidsgräns på 8 minuter.
  • Asynkrona begäranden har en tidsgräns på 60 minuter.
  • Anslutningsappen stöder inte operatorer som inte stöds av operatorngetschema. Till exempel stöds inte operatorerna fork, facet och evaluate .
  • Flöden fungerar bäst på Microsoft Edge och Google Chrome.