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

Łą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.

Masz następujące możliwości:

• Wysyłaj powiadomienia i alerty na podstawie wyników zapytania, na przykład gdy progi przekraczają określone limity.
• Wysyłaj regularne, takie jak codzienne lub tygodniowe, 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 Power Automate łącznika 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ć na podstawie okresu cyklicznego lub jako odpowiedzi na poprzednią akcję przepływu.

1. Zaloguj się do Power Automate.

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

   

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 uzyskać wyjaśnienie każdej akcji i sposobu ich konfigurowania, zobacz Akcje przepływu.

   Ważne

   Aby przepływ był uruchamiany, musisz mieć prawidłowe połączenie usługi Azure Data Explorer. Aby uzyskać informacje na temat tworzenia połączenia, zobacz Tworzenie połączenia usługi Azure Data Explorer w programie Power Automate.

   

Akcje przepływu

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

• Wykonaj zapytanie w języku Kusto (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

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 ponad 8 minut, kończy się niepowodzeniem z powodu wyjątku "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

Następujący 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

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, koń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 pracy przedstawia wyniki zapytania jako wykres czasowy.

Uruchamianie polecenia zarządzania asynchronicznego

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

Jeśli polecenie zarządzania asynchronicznego trwa dłużej niż 60 minut, koń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. Słowo async kluczowe 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 czasu i wykres słupkowy.

Jeśli uruchomienie polecenia zarządzania trwa dłużej niż 8 minut, koń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, kończy się niepowodzeniem przy wyjątku "RequestTimeout".

Przykład

Poniższy przepływ uruchamia komendę .show operation, aby znaleźć stan polecenia asynchronicznego, używając identyfikatora operacji zwróconego przez wykonanie tego asynchronicznego polecenia.

Wysyłanie wiadomości e-mail do wyników 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 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łączenia danych>lub w przepływie, 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 Uruchom zapytanie KQL wybierz ikonę z trzema kropkami w prawym górnym rogu łącznika 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.

   

Uwierzytelnianie

Możesz uwierzytelnić się przy użyciu poświadczeń użytkownika lub aplikacji Firmy Microsoft Entra. Aby uwierzytelnić się przy użyciu poświadczeń, wybierz pozycję Zaloguj 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żyliśmy aplikacji 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ą firmy 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ę uruchamiania 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, który zakończył się niepowodzeniem, aby wyświetlić jego szczegóły. Okienko Szczegóły po prawej stronie zawiera informacje o niepowodzeniu, aby można było go rozwiązać.

Ograniczenia

• Maksymalna liczba rekordów na żądanie wynosi 50 000, a maksymalny rozmiar danych na żądanie wynosi 32 MB. Tych limitów nie można zmienić.
• Żą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, aspektów i oceny nie są obsługiwane.
• Przepływy działają najlepiej w przeglądarce Microsoft Edge i Google Chrome.

Powiązana zawartość

• Użyj Łącznik aplikacji logiki Usługi Azure Kusto, aby uruchamiać zapytania i polecenia usługi Kusto w ramach zaplanowanego lub wyzwalanego zadania.