Konektor Azure Data Exploreru pro Microsoft Power Automate

Důležité

Tento konektor se dá použít v sadě Microsoft Fabric v reálném čase. Postupujte podle pokynů v tomto článku s následujícími výjimkami:

• V případě potřeby vytvořte databáze pomocí pokynů v části Vytvoření databáze KQL.
• V případě potřeby vytvořte tabulky podle pokynů v části Vytvoření prázdné tabulky.
• Pomocí pokynů v identifikátoru URI pro kopírování získejte identifikátory URI pro dotazy nebo příjem dat.
• Spouštění dotazů v sadě dotazů KQL

Konektor Azure Data Exploreru pro Power Automate (dříve Microsoft Flow) umožňuje orchestrovat a plánovat toky, odesílat oznámení a výstrahy jako součást naplánované nebo aktivované úlohy.

Můžete provádět následující akce:

• Odesílat oznámení a upozornění na základě výsledků dotazů, například když prahové hodnoty překročí určité limity.
• Umožňuje posílat pravidelné sestavy obsahující tabulky a grafy, například každý den nebo týdně.
• Naplánujte pravidelné úlohy pomocí příkazů pro správu v clusterech. Pomocí příkazu například zkopírujte data z jedné tabulky do druhé .set-or-append .
• Export a import dat mezi Azure Data Explorerem a dalšími databázemi

Další informace najdete v příkladech použití konektoru Azure Data ExploreruPower Automate.

Poznámka:

Aby Power Automate konektor měl přístup ke clusteru chráněnému sítí, musíte přidat odchozí IP adresy přidružené k oblasti vašeho konektoru do seznamu povolených bran firewall. Další informace najdete v tématu Správa veřejného přístupu ke clusteru Azure Data Exploreru.

Vytvoření nového toku pomocí konektoru Azure Data Exploreru

Pokud chcete konektor použít, musíte nejprve přidat trigger. Trigger můžete definovat na základě opakovaného časového období nebo jako odpověď na předchozí akci toku.

1. Přihlaste se na Power Automate.

2. Vytvořte nový tok nebo na Power Automate domovské stránce vyberte Moje toky>+ Nový tok.

   

3. Vyberte Naplánovaný tok cloudu.

   

4. V části Sestavení plánovaného toku cloudu zadejte požadované informace.

   

5. Vyberte Vytvořit>+ Nový krok.

6. Do vyhledávacího pole zadejte Kusto nebo Azure Data Explorer a vyberte Azure Data Explorer.

   

7. Ze seznamu vyberte akci. Vysvětlení jednotlivých akcí a jejich konfigurace najdete v tématu Akce toku.

   Důležité

   Abyste mohli tok spustit, musíte mít platné připojení Azure Data Exploreru. Informace o vytvoření připojení najdete v tématu Vytvoření připojení Azure Data Exploreru v Power Automatetématu .

   

Akce toku

Když vyberete konektor Azure Data Exploreru, můžete do toku přidat jednu z následujících akcí:

• Spuštění dotazu KQL
• Spuštění dotazu KQL a vykreslení grafu
• Spuštění příkazu async management
• Spuštění příkazu pro správu a vykreslení grafu
• Spuštění příkazu show management

Tato část popisuje možnosti a parametry pro každou akci a poskytuje příklad, jak přidat e-mailovou akci do libovolného toku.

Spuštění dotazu KQL

Poznámka:

Pokud váš dotaz začíná tečkou, jedná se o příkaz pro správu. Použijte příkaz Spustit asynchronní správu.

Pomocí této akce můžete zadat dotaz na zadaný cluster. Akce, které se přidají později, iterují přes každý řádek výsledků dotazu.

Pokud spuštění dotazu trvá déle než 8 minut, selže s výjimkou RequestTimeout. Pokud chcete tomuto problému zabránit, optimalizujte dotaz nebo ho rozdělte na menší části. Další informace najdete v tématu Osvědčené postupy pro dotazy.

Příklad

Následující tok aktivuje dotaz každou minutu. Dotaz zkontroluje počet záznamů v tabulce a odešle e-mail pouze v případě, že je počet záznamů větší než 0.

Spuštění dotazu KQL a vykreslení grafu

Poznámka:

Pokud váš dotaz začíná tečkou, jedná se o příkaz pro správu. Použijte příkaz Pro správu spuštění a vykreslujte graf.

Pomocí této akce můžete vizualizovat výsledek dotazu KQL jako tabulku nebo graf. Tento tok můžete například použít k příjmu denních sestav e-mailem.

Pokud spuštění dotazu trvá déle než 8 minut, selže s výjimkou RequestTimeout. Pokud chcete tomuto problému zabránit, optimalizujte dotaz nebo ho rozdělte na menší části. Další informace najdete v tématu Osvědčené postupy pro dotazy.

Příklad

Následující tok zobrazí výsledky dotazu jako časový diagram.

Spuštění příkazu async management

Pomocí této akce můžete asynchronně spustit příkaz pro správu, což znamená, že se bude dál spouštět na pozadí. Akce vrátí ID, stav a stav. Pokud chcete zkontrolovat stav a podrobnosti asynchronního příkazu, použijte příkaz operace .show s ID vráceným touto akcí.

Pokud spuštění příkazu async management trvá déle než 60 minut, dojde k selhání s výjimkou RequestTimeout.

Příklad

Následující tok aktivuje asynchronní příkaz, který zkopíruje 10 záznamů z tabulky TransformedSysLogs do cílové tabulky. Všimněte si, že v dotazu se vyžaduje asynchronní klíčové slovo.

Spuštění příkazu pro správu a vykreslení grafu

Pomocí této akce spusťte příkaz pro správu a zobrazte výsledek jako graf. Mezi možnosti grafu patří tabulka HTML, výsečový graf, časový graf a pruhový graf.

Pokud spuštění příkazu pro správu trvá déle než 8 minut, dojde k selhání s výjimkou RequestTimeout.

Spuštění příkazu show management

Tato akce spustí příkaz pro správu show a vrátí výsledek, který lze použít v následujících konektorech.

Pokud spuštění příkazu pro správu trvá déle než 8 minut, dojde k selhání s výjimkou RequestTimeout.

Příklad

Následující tok spustí příkaz operace .show, který vyhledá stav asynchronního příkazu pomocí ID operace vrácené asynchronním spuštěním příkazu.

Odeslání výsledků dotazu Kusto e-mailem

Do libovolného toku můžete zahrnout krok pro odesílání sestav e-mailem na libovolnou e-mailovou adresu.

1. Pokud chcete do toku přidat nový krok, vyberte + Nový krok .
2. Do vyhledávacího pole zadejte Office 365 a vyberte Office 365 Outlook.
3. Vyberte Odeslat e-mail (V2).
4. Zadejte e-mailovou adresu, na kterou chcete e-mailovou sestavu odeslat.
5. Zadejte předmět e-mailu.
6. Vyberte zobrazení kódu.
7. Umístěte kurzor do pole Text a vyberte Přidat dynamický obsah.
8. Vyberte BodyHtml.
9. Vyberte Zobrazit rozšířené možnosti.
10. V části Název příloh -1 vyberte Název přílohy.
11. V části Obsah příloh vyberte Obsah přílohy.
12. V případě potřeby přidejte další přílohy.
13. V případě potřeby nastavte úroveň důležitosti.
14. Zvolte Uložit.

Vytvoření připojení Azure Data Exploreru

Pokud chcete spustit tok, který obsahuje konektor Azure Data Exploreru, musíte použít platné připojení Azure Data Exploreru. V levém podokně můžete vytvořit a ověřit nové připojeníPower Automate, vybrat Datová>připojení nebo v rámci toku výběrem nabídky >konektoru Azure Data Exploreru Přidat nové připojení.

Následující kroky ukazují, jak vytvořit připojení z toku.

1. V dotazu Spustit KQL vyberte tři tečky v pravém horním rohu konektoru Power Automate.

   

2. Vyberte Přidat nové připojení. Když se poprvé připojíte, zobrazí se výzva k přihlášení k ověření připojení.

   

Ověřování

Můžete se ověřit pomocí přihlašovacích údajů uživatele nebo pomocí aplikace Microsoft Entra. Pokud se chcete ověřit pomocí přihlašovacích údajů, vyberte Přihlásit se a zadejte své přihlašovací údaje.

Ověření pomocí instančního objektu:

1. Vyberte Připojit s instančním objektem.

2. Do formuláře zadejte následující informace:

   • Název připojení: Popisný a smysluplný název nového připojení. V tomto příkladu jsme použili MyApplication.
   • ID klienta: ID vaší aplikace.
   • Tajný klíč klienta: Váš klíč aplikace.
   • Tenant: ID adresáře Microsoft Entra, ve kterém jste aplikaci vytvořili.

   Poznámka:

   Ujistěte se, že vaše aplikace je aplikace Microsoft Entra a má oprávnění ke spouštění dotazů ve vašem clusteru.

   

   Po dokončení ověřování ověřte, že váš tok používá nové připojení.

   

   Po nastavení připojení se tok spustí pomocí přihlašovacích údajů aplikace.

Testování toku

Pokud chcete zkontrolovat, jestli tok funguje, zkontrolujte historii spuštění toku:

1. Přejděte na domovskou Power Automate stránku.

2. V hlavní nabídce vyberte Moje toky.

   

3. Na řádku toku, který chcete prozkoumat, vyberte ikonu dalších příkazů a pak vyberte Historii spuštění.

   

   Zobrazí se všechna spuštění toku s informacemi o čase spuštění, době trvání a stavu.

   Pokud chcete získat úplné podrobnosti o toku, vyberte v části Moje toky tok, který chcete prozkoumat.

   

Pokud chcete zjistit, proč se spuštění nezdařilo, vyberte čas spuštění. Zobrazí se tok a krok toku, který selhal, je označen červeným vykřičníkem. Rozbalte neúspěšný krok a zobrazte jeho podrobnosti. Podokno Podrobností na pravé straně obsahuje informace o selhání, abyste je mohli vyřešit.

Omezení

• Maximální počet záznamů na požadavek je 50 000 a maximální velikost dat na požadavek je 32 MB. Tato omezení nelze změnit.
• Synchronní požadavky mají časový limit 8 minut.
• Asynchronní požadavky mají časový limit 60 minut.
• Konektor nepodporuje operátory, které operátor nepodporujegetschema. Operátory forku, omezující vlastnosti a vyhodnocení se například nepodporují.
• Toky fungují nejlépe na Microsoft Edgi a Google Chrome.

Související obsah

• Pomocí Konektor aplikace logiky Azure Kusto můžete spouštět dotazy a příkazy Kusto jako součást naplánované nebo aktivované úlohy.