Azure Data Explorer konektoru do Power Automate (Preview)

Konektor Azure Data Explorer Power Automate (dříve Microsoft Flow) umožňuje Azure Data Explorer využívat funkce toku Microsoft Power Automate služby . Dotazy a příkazy Kusto můžete spouštět automaticky v rámci naplánované nebo aktivované úlohy.

Další možnosti:

  • Odesílání denních sestav obsahujících tabulky a grafy
  • Nastavte oznámení na základě výsledků dotazu.
  • Plánování řídicích příkazů v clusterech.
  • Export a import dat mezi Azure Data Explorer a jinými databázemi.

Další informace naleznete v tématu Azure Data Explorer Power Automate connector usage examples.

Přihlásit se

  1. Při prvním připojení se zobrazí výzva k přihlášení.

  2. Vyberte Přihlásit sea zadejte své přihlašovací údaje.

Snímek obrazovky Azure Data Explorer výzva k přihlášení

Authentication

Ověřování můžete provést pomocí přihlašovacích údajů uživatele nebo pomocí Azure Active Directory (Azure AD).

Poznámka

Ujistěte se, že vaše aplikace je aplikace Azure ADa že má oprávnění spouštět dotazy ve vašem clusteru.

  1. V části Spustit řídicí příkaz a vizualizovatvýsledky vyberte tři tečky v pravém horním rohu konektoru toku.

    Snímek obrazovky s řídicím příkazem Spustit a vizualizací výsledků

  2. Vyberte Add new connectionPřipojení with Service Principal (Přidat nové připojení Připojení pomocí objektu služby).

    Snímek obrazovky Azure Data Explorer výzvou k přihlášení s možností Připojení instančního objektu

  3. Zadejte požadované informace:

    • Connection Name (Název připojení): Popisný a smysluplný název nového připojení.
    • ID klienta: ID vaší aplikace.
    • Tajný klíč klienta: Klíč aplikace.
    • Tenant: ID adresáře služby Azure AD, ve kterém jste vytvořili aplikaci.

    Snímek obrazovky Azure Data Explorer ověřování aplikace

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

Snímek obrazovky s dokončenou ověřováním aplikace

Od této strany se tento tok spustí pomocí těchto přihlašovacích údajů aplikace.

Vyhledání konektoru Azure Kusto

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

  1. Vytvořte nový toknebo na domovské stránce Microsoftu vyberte Moje toky+ Nový.

    Snímek obrazovky s domovskou Power Automate Microsoftu a zvýrazněnou stránkou Moje toky a Nový

  2. Vyberte Naplánované – z prázdné.

    Snímek obrazovky s dialogem Nový a zvýrazněnou vlastností Naplánované z prázdné

  3. V části Build a scheduled flow (Sestavit naplánovanýtok) zadejte požadované informace.

    Snímek obrazovky se stránkou Sestavit naplánovaný tok Flow zvýrazněné možnosti názvu

  4. Vyberte Vytvořita nový krok.

  5. Do vyhledávacího pole zadejte Kustoa vyberte Azure Data Explorer.

    Snímek obrazovky s možnostmi akce s vyhledávacím polem Azure Data Explorer zvýrazněnou možností

Akce toku

Když otevřete konektor Azure Data Explorer, můžete do toku přidat tři možné akce. Tato část popisuje možnosti a parametry pro jednotlivé akce.

Snímek obrazovky Azure Data Explorer akcích konektoru

Spuštění řídicího příkazu a vizualizace výsledků

Tuto akci použijte ke spuštění řídicího příkazu.

  1. Zadejte adresu URL clusteru. Například, https://clusterName.eastus.kusto.windows.net.
  2. Zadejte název databáze.
  3. Zadejte řídicí příkaz:
    • Vyberte dynamický obsah z aplikací a konektorů používaných v toku.
    • Přidejte výraz pro přístup k hodnotám, jejich převodu a porovnání.
  4. Pokud chcete výsledky této akce odeslat e-mailem jako tabulku nebo graf, zadejte typ grafu. Může to být:
    • Tabulka HTML.
    • Výsečový graf
    • Časový graf
    • Pruhový graf

Snímek obrazovky s řídicím příkazem Spustit a vizualizací výsledků v podokně opakování

Důležité

Do pole Název clusteru zadejte adresu URL clusteru.

Spuštění dotazu a zobrazení seznamu výsledků

Poznámka

Pokud dotaz začíná tečkou (to znamená, že se jedná o řídicí příkaz),použijte příkaz Spustit a vizualizujte výsledky.

Tato akce odešle dotaz do clusteru Kusto. Akce, které se následně přidávají, iterují přes každý řádek výsledků dotazu.

Následující příklad aktivuje dotaz každou minutu a odešle e-mail na základě výsledků dotazu. Dotaz zkontroluje počet řádků v databázi a odešle e-mail pouze v případě, že je počet řádků větší než 0.

Snímek obrazovky s výsledky spuštění dotazu a seznamu

Poznámka

Pokud má sloupec několik řádků, konektor se spustí pro každý řádek ve sloupci.

Spuštění dotazu a vizualizace výsledků

Poznámka

Pokud dotaz začíná tečkou (to znamená, že se jedná o řídicí příkaz),použijte příkaz Spustit a vizualizujte výsledky.

Pomocí této akce můžete vizualizovat výsledek dotazu Kusto jako tabulku nebo graf. Pomocí tohoto toku můžete například dostávat denní sestavy e-mailem.

V tomto příkladu se výsledky dotazu vrátí jako tabulka HTML.

Snímek obrazovky se spuštěním dotazu a vizualizací výsledků

Důležité

Do pole Název clusteru zadejte adresu URL clusteru.

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. Vyberte + Nový krok a přidejte do toku 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 sestavu e-mailu 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. Snímek obrazovky s dialogovým oknem Odeslat e-mail se zvýrazněnou polem Text a textem BodyHtml
  9. Vyberte Zobrazit pokročilé možnosti.
  10. V části Název přílohy -1vyberte Název přílohy.
  11. V části Obsah přílohyvyberte 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. Vyberte Uložit.

Snímek obrazovky s dialogovým oknem odeslat e-mail s názvem přílohy, obsahem příloh a zvýrazněným uložením

Ověření úspěšného toku

Pokud chcete zjistit, jestli tok proběhl úspěšně, podívejte se na historii spuštění toku:

  1. Přejít na Microsoft Power Automate home page .

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

    snímek obrazovky aplikace Microsoft <span class =Power Automate Screenshot of Microsoft <span class= hlavní nabídku s zvýrazněnými toky "/>

  3. Na řádku toku, který chcete prozkoumat, vyberte ikonu Další příkazy a pak vyberte Spustit historii.

    Snímek obrazovky s kartou moje toky s zvýrazněnou historií spuštění

    V seznamu jsou uvedeny všechny běhy toku s informacemi o počátečním čase, době trvání a stavu. Snímek obrazovky se stránkou výsledků historie spuštění.

    Chcete-li zobrazit všechny podrobnosti o toku, vyberte v části Moje tokytok, který chcete prozkoumat.

    Snímek obrazovky se stránkou historie spuštění s úplnými výsledky

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

Snímek obrazovky s chybovou stránkou Flow

Výjimky časového limitu

Tok může selhat a vrátit výjimku "RequestTimeout", pokud běží déle než 90 sekund.

Snímek obrazovky s chybou vypršení časového limitu požadavku na tok

Pokud chcete opravit problém s časovým limitem, vyřešte ho efektivněji, aby běžel rychleji nebo aby se rozdělují do bloků dat. Každý blok může běžet v jiné části dotazu. Další informace najdete v tématu osvědčené postupy pro dotazování.

Stejný dotaz může úspěšně běžet v Azure Průzkumník dat, kde čas není omezený a může být změněn.

Omezení

  • Výsledky vrácené klientovi jsou omezeny na 500 000 záznamů. Celková paměť pro tyto záznamy nemůže být větší než 64 MB a v čase 90 sekund spustit.
  • Konektor nepodporuje operátory, které nejsou podporovány operátorem. Například operátory rozvětvení, omezující vlastnostia vyhodnocení nejsou podporovány.
  • Flow fungují nejlépe v Microsoft Edge a Google Chrome.

Další kroky

přečtěte si o Konektor aplikace logice Azure Kusto, což je jiný způsob, jak automaticky spouštět dotazy Kusto a příkazy v rámci naplánované nebo aktivované úlohy.