Azure Data Explorer-összekötő a Microsofthoz Power Automate

Fontos

Ez az összekötő a Microsoft Fabric Real-Time Intelligence szolgáltatásában használható. A cikkben szereplő utasításokat a következő kivételekkel használhatja:

A (korábban Microsoft Flow-hoz készült) Azure Data Explorer-összekötő Power Automate lehetővé teszi folyamatok vezénylésének és ütemezésének, értesítések és riasztások küldésének végrehajtását egy ütemezett vagy aktivált feladat részeként.

Ön megteheti:

  • Értesítések és riasztások küldése lekérdezési eredmények alapján, például ha a küszöbértékek túllépnek bizonyos korlátokat.
  • Rendszeres, például napi vagy heti jelentéseket küldhet, amelyek táblákat és diagramokat tartalmaznak.
  • Rendszeres feladatok ütemezése felügyeleti parancsokkal fürtökön. Például másolja az adatokat az egyik táblából a másikba a .set-or-append parancs használatával.
  • Adatok exportálása és importálása az Azure Data Explorer és más adatbázisok között.

További információ: Azure Data Explorer-összekötők Power Automate használati példái.

Megjegyzés:

Ahhoz, hogy egy Power Automate összekötő hozzáférjen egy védett hálózati fürthöz, hozzá kell adnia az összekötő régiójához társított kimenő IP-címeket a tűzfal engedélyezési listára. További információért lásd: Az Azure Data Explorer-fürt nyilvános hozzáférésének kezelése.

Új folyamat létrehozása az Azure Data Explorer-összekötővel

Az csatlakozó használatához először hozzá kell adnia egy trigger-t. Az eseményindítót egy ismétlődő időszak vagy egy korábbi folyamatműveletre adott válasz alapján határozhatja meg.

  1. Jelentkezzen be a(z) Power Automateplatformra.

  2. Hozzon létre egy új folyamatot, vagy a kezdőlapon Power Automate válassza a Saját folyamatok>+ Új folyamat lehetőséget.

    Képernyőkép a kezdőlapról, amelyen a Power Automate Saját folyamatok és az Új kiemelés látható.

  3. Válassza az Ütemezett felhőfolyamat lehetőséget.

    Képernyőkép az Új párbeszédpanelről, amelyen az Ütemezett üresből ki van emelve.

  4. Az Ütemezett felhőfolyamat létrehozásában adja meg a szükséges információkat.

    Képernyőkép egy ütemezett folyamat létrehozása lapról, amelyen a folyamatnév-beállítások vannak kiemelve.

  5. Válassza a Létrehozás>+ Új lépés lehetőséget.

  6. A keresőmezőbe írja be a Kusto vagy az Azure Data Explorer kifejezést, és válassza az Azure Data Explorert.

    Képernyőkép a Művelet kiválasztása ablakról, amelyen a keresőmező és az Azure Data Explorer ki van emelve.

  7. Válasszon egy műveletet a listából. Az egyes műveletek magyarázatát és konfigurálását a Flow-műveletek című témakörben találhatja meg.

    Fontos

    A folyamat futtatásához érvényes Azure Data Explorer-kapcsolattal kell rendelkeznie. További információ a kapcsolat létrehozásáról: Azure Data Explorer-kapcsolat létrehozása a következőben Power Automate: .

    Képernyőkép a Művelet kiválasztása listáról, amelyen a kiemelt műveletek listája látható.

Folyamatműveletek

Az Azure Data Explorer-összekötő kiválasztásakor az alábbi műveletek közül választhat, amelyeket hozzá szeretne adni a folyamathoz:

Ez a szakasz az egyes műveletek képességeit és paramétereit ismerteti, és bemutatja, hogyan adhat hozzá e-mail-műveletet bármely folyamathoz.

KQL-lekérdezés futtatása

Megjegyzés:

Ha a lekérdezés ponttal kezdődik, az egy felügyeleti parancs. Használja a Run async management parancsot.

Ezzel a művelettel lekérdezheti a megadott klasztert. Az ezt követően hozzáadott műveletek a lekérdezés eredményeinek minden sorában iterálnak.

Ha a lekérdezés futtatása több mint 8 percet vesz igénybe, "RequestTimeout" kivétellel meghiúsul. A probléma elkerülése érdekében optimalizálja a lekérdezést, vagy ossza kisebb részekre. További információkért tekintse meg a lekérdezés ajánlott eljárásait.

Example

Az alábbi folyamat percenként aktivál egy lekérdezést. A lekérdezés ellenőrzi a tábla rekordjainak számát, majd csak akkor küld e-mailt, ha a rekordok száma meghaladja a 0-t.

Képernyőkép az Azure Data Explorer-összekötőről, amelyen a KQL-lekérdezés futtatása művelet látható.

KQL-lekérdezés futtatása és diagram megjelenítése

Megjegyzés:

Ha a lekérdezés ponttal kezdődik, az egy felügyeleti parancs. Használja a Run management command parancsot, és rendereljen egy diagramot.

Ezzel a műveletben táblázatként vagy diagramként jeleníthet meg KQL-lekérdezési eredményt. Ezzel a folyamattal például napi jelentéseket kaphat e-mailben.

Ha a lekérdezés futtatása több mint 8 percet vesz igénybe, "RequestTimeout" kivétellel meghiúsul. A probléma elkerülése érdekében optimalizálja a lekérdezést, vagy ossza kisebb részekre. További információkért tekintse meg a lekérdezés ajánlott eljárásait.

Example

Az alábbi folyamat a lekérdezés eredményeit idődiagramként jeleníti meg.

Képernyőkép az Azure Data Explorer-összekötőről, amelyen a KQL-lekérdezés futtatása és egy diagramművelet megjelenítése látható.

Aszinkron felügyeleti parancs futtatása

Ezzel a művelettel aszinkron módon futtathat egy felügyeleti parancsot , ami azt jelenti, hogy továbbra is a háttérben fut. A művelet egy azonosítót, állapotot és státuszt ad vissza. Az aszinkron parancs állapotának és részleteinek ellenőrzéséhez használja a .show operations parancsot a művelet által visszaadott azonosítóval.

Ha az aszinkron felügyeleti parancs futtatása több mint 60 percet vesz igénybe, a "RequestTimeout" kivétellel meghiúsul.

Example

Az alábbi folyamat aktivál egy aszinkron parancsot, amely 10 rekordot másol a TransformedSysLogs táblából a TargetTable-ba. A async kulcsszóra a lekérdezésben van szükség.

Képernyőkép az Azure Data Explorer-összekötőről, amelyen az aszinkron kezelési parancsművelet látható.

Felügyeleti parancs futtatása és diagram renderelése

Ezzel a művelettel futtathat egy felügyeleti parancsot , és megjelenítheti az eredményt diagramként. A diagram beállításai közé tartozik a HTML-táblázat, a kördiagram, az idődiagram és a sávdiagram.

Ha a felügyeleti parancs futtatása több mint 8 percet vesz igénybe, a "RequestTimeout" kivétellel meghiúsul.

Képernyőkép a Futtatáskezelés parancsról, és egy diagram ábrázolása az ismétlődési ablakban.

Megjelenítés kezelés parancs futtatása

Ez a művelet futtatja a megjelenítési felügyeleti parancsot, és visszaadja az alábbi összekötőkben használható eredményt.

Ha a felügyeleti parancs futtatása több mint 8 percet vesz igénybe, a "RequestTimeout" kivétellel meghiúsul.

Example

Az alábbi folyamat a .show operation parancs futtatásával megkeresi az aszinkron parancs állapotát egy aszinkron parancs végrehajtása által visszaadott műveletazonosító használatával.

Képernyőkép az Azure Data Explorer-összekötőről, amelyen a 'show management' parancs futtatása látható.

Kusto-lekérdezés eredményeinek küldése e-mailben

Bármilyen folyamatba belefoglalhat egy lépést, a jelentések e-mailben, bármely e-mail-címre való elküldéséhez.

  1. Válassza az + Új lépés lehetőséget, ha új lépést szeretne hozzáadni a folyamathoz.
  2. A keresőmezőbe írja be az Office 365-öt , és válassza az Office 365 Outlookot.
  3. Válassza az E-mail küldése (V2) lehetőséget.
  4. Adja meg azt az e-mail-címet, amelyre az e-mail-jelentést el szeretné küldeni.
  5. Adja meg az e-mail tárgyát.
  6. Válassza a Kód nézetet.
  7. Helyezze a kurzort a Törzs mezőbe, és válassza a Dinamikus tartalom hozzáadása lehetőséget.
  8. Válassza a BodyHtml lehetőséget. Képernyőkép az E-mail küldése párbeszédpanelről, amelyen a Törzs mező és a BodyHtml ki van emelve.
  9. Válassza a Speciális beállítások megjelenítése lehetőséget.
  10. A Mellékletek neve -1 csoportban válassza a Melléklet neve lehetőséget.
  11. A Mellékletek tartalma területen válassza a Melléklet tartalma lehetőséget.
  12. Szükség esetén adjon hozzá további mellékleteket.
  13. Szükség esetén állítsa be a fontossági szintet.
  14. Válassza az Mentésgombot.

Képernyőkép az E-mail küldése párbeszédpanelről, amelyen a Mellékletek neve, a Mellékletek tartalma és a Mentés elem van kiemelve.

Azure Data Explorer-kapcsolat létrehozása

Egy Azure Data Explorer-összekötőt tartalmazó folyamat futtatásához érvényes Azure Data Explorer-kapcsolatot kell használnia. Létrehozhat és hitelesíthet egy új kapcsolatot a bal oldali panelen, kiválaszthatja az Power Automateadatkapcsolatokat> vagy a folyamaton belülről az Azure Data Explorer-összekötő > menüjét.

Az alábbi lépések bemutatják, hogyan hozhat létre kapcsolatot egy folyamaton belülről.

  1. A KQL-lekérdezés futtatásakor válassza ki az összekötő jobb Power Automate felső sarkában található három pontot.

    Képernyőkép az Azure Data Explorer-kapcsolatról, amelyen a hitelesítési lehetőség látható.

  2. Válassza az Új kapcsolat hozzáadása lehetőséget. Amikor első alkalommal csatlakozik, a rendszer kérni fogja, hogy jelentkezzen be a kapcsolat hitelesítéséhez.

    Képernyőkép az Azure Data Explorer-kapcsolatról, amelyen a bejelentkezési lehetőség látható.

Authentication

Hitelesítést felhasználói hitelesítő adatokkal vagy Microsoft Entra-alkalmazással végezhet. Hitelesítő adatokkal való hitelesítéshez válassza a Bejelentkezés lehetőséget, és adja meg a hitelesítő adatait.

Szolgáltatásazonosítóval történő hitelesítés:

  1. Válassza a Csatlakozás szolgáltatási azonosítóval lehetőséget.

  2. Töltse ki az űrlapot a következő információkkal:

    • Kapcsolat neve: Az új kapcsolat leíró és értelmezhető neve. Ebben a példában a MyApplicationt használtuk.
    • Ügyfélazonosító: Az alkalmazás azonosítója.
    • Titkos ügyfélkód: Az alkalmazáskulcs.
    • Bérlő: Az azonosítója annak a Microsoft Entra-címtárnak, amelyben létrehozta az alkalmazást.

    Megjegyzés:

    Győződjön meg arról, hogy az alkalmazás Microsoft Entra-alkalmazás , és jogosult lekérdezések futtatására a fürtön.

    Képernyőkép az Azure Data Explorer-kapcsolatról, amelyen az alkalmazáshitelesítés párbeszédpanel látható.

    Ha a hitelesítés befejeződött, ellenőrizze, hogy a folyamat az új kapcsolatot használja-e.

    Képernyőkép a befejezett alkalmazáshitelesítésről.

    A kapcsolat beállítása után a folyamat az alkalmazás hitelesítő adataival fut.

A folyamat tesztelése

A folyamat működésének ellenőrzéséhez ellenőrizze a folyamat futtatási előzményeit:

  1. Nyissa meg a Power Automate kezdőlapot.

  2. A főmenüben válassza a Saját folyamatok lehetőséget.

    Képernyőkép a főmenüről Power Automate , amelyen a Saját folyamatok kiemelése látható.

  3. A vizsgálandó folyamat sorában válassza a további parancsok ikont, majd válassza a Futtatási előzmények lehetőséget.

    Képernyőkép a Saját folyamatok lapról, amelyen a Futtatási napló ki van emelve.

    A listában minden folyamatfuttatás szerepel, a kezdési időpontra, az időtartamra és az állapotra vonatkozó információkkal. Képernyőkép a Futtatási előzmények eredményeinek oldaláról.

    A folyamat részletes részleteiért a Saját folyamatok területen válassza ki a vizsgálandó folyamatot.

    Képernyőkép a Futtatási előzmények teljes eredményoldaláról.

Ha meg szeretné tudni, hogy egy futtatás miért nem sikerült, válassza ki a futtatás kezdési időpontját. Megjelenik a folyamat, és a sikertelen folyamat lépését egy piros felkiáltójel jelzi. Nyissa meg a sikertelen lépést a részletei megtekintéséhez. A jobb oldali Részletek panel információkat tartalmaz a hibáról, hogy elháríthassa azt.

Képernyőkép a folyamatfuttatásról, amely egy hibaüzenetet jelenít meg.

Korlátozások

  • A rekordok kérésenkénti maximális száma 50 000, a kérelemenkénti adatméret pedig 32 MB. Ezek a korlátok nem módosíthatók.
  • A szinkron kérések időkorlátja 8 perc.
  • Az aszinkron kérések időtúllépése 60 perc.
  • Az összekötő nem támogatja az operátor által getschemanem támogatott operátorokat. Az elágazás, a aspektus és az értékelés operátorai például nem támogatottak.
  • A folyamatok a Microsoft Edge-ben és a Google Chrome-ban működnek a legjobban.