Łącznik usługi Azure Data Explorer dla firmy MicrosoftPower Automate

Ważne

Tego łącznika można używać w analizie czasu rzeczywistego w usłudze Microsoft Fabric. Skorzystaj z instrukcji w tym artykule z następującymi wyjątkami:

• W razie potrzeby utwórz bazy danych, korzystając z instrukcji w temacie Tworzenie bazy danych KQL.
• W razie potrzeby utwórz tabele, korzystając z instrukcji w temacie Tworzenie pustej tabeli.
• Pobierz identyfikatory URI zapytań lub pozyskiwania, korzystając z instrukcji w temacie Copy URI (Kopiowanie identyfikatora URI).
• Uruchamianie zapytań w zestawie zapytań KQL.

Łącznik usługi Azure Data Explorer dla Power Automate usługi (wcześniej Microsoft Flow) umożliwia organizowanie i planowanie przepływów, wysyłanie powiadomień i alertów w ramach zaplanowanego lub wyzwalanego zadania.

Możesz:

• Wysyłaj powiadomienia i alerty na podstawie wyników zapytania, na przykład gdy progi przekraczają określone limity.
• Wysyłaj regularne, takie jak codziennie lub co tydzień, raporty zawierające tabele i wykresy.
• Planowanie regularnych zadań przy użyciu poleceń zarządzania w klastrach. Na przykład skopiuj dane z jednej tabeli do innej przy użyciu .set-or-append polecenia .
• Eksportowanie i importowanie danych między usługą Azure Data Explorer i innymi bazami danych.

Aby uzyskać więcej informacji, zobacz Przykłady użycia łącznika usługi Azure Data ExplorerPower Automate.

Uwaga

Aby łącznik mógł Power Automate uzyskać dostęp do klastra chronionego przez sieć, należy dodać wychodzące adresy IP skojarzone z regionem łącznika do listy dozwolonych zapory. Aby uzyskać więcej informacji, zobacz Zarządzanie publicznym dostępem do klastra usługi Azure Data Explorer.

Tworzenie nowego przepływu przy użyciu łącznika usługi Azure Data Explorer

Aby użyć łącznika, należy najpierw dodać wyzwalacz. Wyzwalacz można zdefiniować w oparciu o okres cykliczny lub jako odpowiedź na poprzednią akcję przepływu.

1. Zaloguj się do witryny Power Automate.

2. Utwórz nowy przepływ lub na stronie głównej Power Automate wybierz przepływ Moje przepływy>+ Nowy.

   

3. Wybierz pozycję Zaplanowany przepływ chmury.

   

4. W obszarze Tworzenie zaplanowanego przepływu chmury wprowadź wymagane informacje.

   

5. Wybierz pozycję Utwórz>+ Nowy krok.

6. W polu wyszukiwania wprowadź ciąg Kusto lub Azure Data Explorer, a następnie wybierz pozycję Azure Data Explorer.

   

7. Wybierz akcję z listy. Aby zapoznać się z wyjaśnieniem poszczególnych akcji i sposobu ich konfigurowania, zobacz Akcje przepływu.

   Ważne

   Aby można było uruchomić przepływ, musisz mieć prawidłowe połączenie usługi Azure Data Explorer. Aby uzyskać informacje na temat tworzenia połączenia, zobacz Create an Azure Data Explorer connection in .Power Automate

   

Akcje przepływu

Po wybraniu łącznika usługi Azure Data Explorer możesz wybrać jedną z następujących akcji, które mają zostać dodane do przepływu:

• Uruchamianie zapytania KQL
• Uruchamianie zapytania KQL i renderowanie wykresu
• Uruchamianie polecenia zarządzania asynchronicznego
• Uruchamianie polecenia zarządzania i renderowanie wykresu
• Uruchom polecenie pokaż zarządzanie

W tej sekcji opisano możliwości i parametry dla każdej akcji oraz przedstawiono przykład sposobu dodawania akcji wiadomości e-mail do dowolnego przepływu.

Uruchamianie zapytania KQL

Uwaga

Jeśli zapytanie rozpoczyna się od kropki, jest to polecenie zarządzania. Użyj polecenia Uruchom zarządzanie asynchroniczne.

Użyj tej akcji, aby wysłać zapytanie do określonego klastra. Akcje dodawane następnie iterują po każdym wierszu wyników zapytania.

Jeśli uruchomienie zapytania trwa dłużej niż 8 minut, niepowodzenie zakończy się niepowodzeniem z wyjątkiem "RequestTimeout". Aby zapobiec temu problemowi, zoptymalizuj zapytanie lub podziel je na mniejsze części. Aby uzyskać więcej informacji, zobacz Najlepsze rozwiązania dotyczące zapytań.

Przykład

Poniższy przepływ wyzwala zapytanie co minutę. Zapytanie sprawdza liczbę rekordów w tabeli, a następnie wysyła wiadomość e-mail tylko wtedy, gdy liczba rekordów jest większa niż 0.

Uruchamianie zapytania KQL i renderowanie wykresu

Uwaga

Jeśli zapytanie rozpoczyna się od kropki, jest to polecenie zarządzania. Użyj polecenia Uruchom zarządzanie i renderuj wykres.

Użyj tej akcji, aby zwizualizować wynik zapytania KQL jako tabelę lub wykres. Na przykład użyj tego przepływu, aby otrzymywać codzienne raporty pocztą e-mail.

Jeśli uruchomienie zapytania trwa dłużej niż 8 minut, niepowodzenie zakończy się niepowodzeniem z wyjątkiem "RequestTimeout". Aby zapobiec temu problemowi, zoptymalizuj zapytanie lub podziel je na mniejsze części. Aby uzyskać więcej informacji, zobacz Najlepsze rozwiązania dotyczące zapytań.

Przykład

Poniższy przepływ przedstawi wyniki zapytania jako schemat czasu.

Uruchamianie polecenia zarządzania asynchronicznego

Użyj tej akcji, aby uruchomić polecenie zarządzania asynchronicznie, co oznacza, że będzie nadal działać w tle. Akcja zwraca identyfikator, stan i stan. Aby sprawdzić stan i szczegóły polecenia asynchronicznego, użyj polecenia .show operations z identyfikatorem zwróconym przez tę akcję.

Jeśli uruchomienie polecenia zarządzania asynchronicznego trwa dłużej niż 60 minut, zakończy się niepowodzeniem z wyjątkiem "RequestTimeout".

Przykład

Poniższy przepływ wyzwala polecenie asynchroniczne w celu skopiowania 10 rekordów z tabeli "TransformedSysLogs" do tabeli "TargetTable". Pamiętaj, że słowo kluczowe "async" jest wymagane w zapytaniu.

Uruchamianie polecenia zarządzania i renderowanie wykresu

Użyj tej akcji, aby uruchomić polecenie zarządzania i wyświetlić wynik jako wykres. Opcje wykresu obejmują tabelę HTML, wykres kołowy, wykres czasowy i wykres słupkowy.

Jeśli uruchomienie polecenia zarządzania trwa dłużej niż 8 minut, zakończy się niepowodzeniem z wyjątkiem "RequestTimeout".

Uruchom polecenie pokaż zarządzanie

Ta akcja uruchamia polecenie pokaż zarządzanie i zwraca wynik, który można użyć w następujących łącznikach.

Jeśli uruchomienie polecenia zarządzania trwa dłużej niż 8 minut, zakończy się niepowodzeniem z wyjątkiem "RequestTimeout".

Przykład

Poniższy przepływ uruchamia polecenie .show operation , aby znaleźć stan polecenia asynchronicznego przy użyciu identyfikatora operacji zwróconego przez wykonanie polecenia asynchronicznego.

Email wyniki zapytania Kusto

Możesz dołączyć krok do dowolnego przepływu w celu wysyłania raportów pocztą e-mail na dowolny adres e-mail.

1. Wybierz pozycję + Nowy krok , aby dodać nowy krok do przepływu.
2. W polu wyszukiwania wprowadź Office 365 i wybierz pozycję Office 365 Outlook.
3. Wybierz pozycję Wyślij wiadomość e-mail (wersja 2).
4. Wprowadź adres e-mail, na który ma zostać wysłany raport e-mail.
5. Wprowadź temat wiadomości e-mail.
6. Wybierz pozycję Widok kodu.
7. Umieść kursor w polu Treść i wybierz pozycję Dodaj zawartość dynamiczną.
8. Wybierz pozycję BodyHtml.
9. Wybierz pozycję Pokaż opcje zaawansowane.
10. W obszarze Nazwa załączników -1 wybierz pozycję Nazwa załącznika.
11. W obszarze Zawartość załączników wybierz pozycję Zawartość załącznika.
12. W razie potrzeby dodaj więcej załączników.
13. W razie potrzeby ustaw poziom ważności.
14. Wybierz pozycję Zapisz.

Tworzenie połączenia usługi Azure Data Explorer

Aby uruchomić przepływ zawierający łącznik usługi Azure Data Explorer, należy użyć prawidłowego połączenia usługi Azure Data Explorer. Możesz utworzyć i uwierzytelnić nowe połączenie w okienku po lewej Power Automate stronie, wybrać pozycjęPołączeniadanych> lub z przepływu, wybierając menu > łącznika usługi Azure Data Explorer Dodaj nowe połączenie.

W poniższych krokach pokazano, jak utworzyć połączenie z poziomu przepływu.

1. W obszarze Uruchom zapytanie KQL wybierz trzy kropki w prawym górnym rogu łącznika usługi Power Automate.

   

2. Wybierz pozycję Dodaj nowe połączenie. Po pierwszym nawiązaniu połączenia zostanie wyświetlony monit o zalogowanie się w celu uwierzytelnienia połączenia.

   

Authentication

Możesz uwierzytelnić się przy użyciu poświadczeń użytkownika lub aplikacji Microsoft Entra. Aby uwierzytelnić się przy użyciu poświadczeń, wybierz pozycję Zaloguj się i wprowadź swoje poświadczenia.

Aby uwierzytelnić się za pomocą jednostki usługi:

1. Wybierz pozycję Połącz z jednostką usługi.

2. Wypełnij formularz, używając poniższych informacji:

   • Nazwa połączenia: opisowa i zrozumiała nazwa nowego połączenia. W tym przykładzie użyto polecenia "MyApplication".
   • Identyfikator klienta: Identyfikator aplikacji.
   • Klucz tajny klienta: klucz aplikacji.
   • Dzierżawa: identyfikator katalogu Microsoft Entra, w którym utworzono aplikację.

   Uwaga

   Upewnij się, że aplikacja jest aplikacją Microsoft Entra i jest autoryzowana do uruchamiania zapytań w klastrze.

   

   Po zakończeniu uwierzytelniania sprawdź, czy przepływ używa nowego połączenia.

   

   Po ustawieniu połączenia przepływ jest uruchamiany przy użyciu poświadczeń aplikacji.

Testowanie przepływu

Aby sprawdzić, czy przepływ działa, sprawdź historię przebiegów przepływu:

1. Przejdź do strony głównejPower Automate.

2. Z menu głównego wybierz pozycję Moje przepływy.

   

3. W wierszu przepływu, który chcesz zbadać, wybierz ikonę więcej poleceń, a następnie wybierz pozycję Historia uruchamiania.

   

   Zostaną wyświetlone wszystkie uruchomienia przepływu z informacjami o czasie rozpoczęcia, czasie trwania i stanie.

   Aby uzyskać szczegółowe informacje o przepływie, w obszarze Moje przepływy wybierz przepływ, który chcesz zbadać.

   

Aby zobaczyć, dlaczego przebieg zakończył się niepowodzeniem, wybierz czas rozpoczęcia przebiegu. Zostanie wyświetlony przepływ, a krok przepływu, który zakończył się niepowodzeniem, jest wskazywany przez czerwony wykrzyknik. Rozwiń krok niepowodzenia, aby wyświetlić jego szczegóły. Okienko Szczegóły po prawej stronie zawiera informacje o niepowodzeniu, aby można było rozwiązać ten problem.

Ograniczenia

• Maksymalna liczba rekordów na żądanie wynosi 50 000, a maksymalny rozmiar danych na żądanie wynosi 32 MB. Nie można zmienić tych limitów.
• Żądania synchroniczne mają limit czasu 8 minut.
• Żądania asynchroniczne mają limit czasu 60 minut.
• Łącznik nie obsługuje operatorów, które nie są obsługiwane przez getschema operatora. Na przykład operatory rozwidlenia, aspektu i oceny nie są obsługiwane.
• Przepływy działają najlepiej w przeglądarce Microsoft Edge i Google Chrome.

Zawartość pokrewna

• Łącznik aplikacji logiki Usługi Azure Kusto umożliwia uruchamianie zapytań i poleceń usługi Kusto w ramach zaplanowanego lub wyzwalanego zadania.