Alerty SQL usługi Databricks

Ważne

Ta funkcja jest dostępna w publicznej wersji testowej.

Ta strona zawiera szczegółowe wskazówki dotyczące włączania i używania alertów SQL usługi Databricks do automatyzowania wykonywania zapytań, oceniania warunków niestandardowych i dostarczania powiadomień w przypadku spełnienia tych warunków. Dzięki alertom można aktywnie monitorować dane biznesowe i otrzymywać powiadomienia terminowe, gdy zgłaszane wartości wykraczają poza oczekiwane progi. Po zaplanowaniu alertu, skojarzone z nim zapytania są uruchamiane, a kryteria alertu sprawdzane, niezależnie od istniejących harmonogramów w podstawowym zapytaniu. Ponadto możesz uzyskać dostęp do historii alertów, aby przejrzeć wyniki przeszłych ocen alertów.

Aby dowiedzieć się, jak zamiast tego pracować ze starszymi alertami, zobacz Co to są starsze alerty?.

Włączanie alertów w obszarze roboczym

Administratorzy obszaru roboczego mogą kontrolować dostęp obszaru roboczego do tej wersji zapoznawczej ze strony Podglądy. Włączenie tej wersji zapoznawczej nie ma wpływu na istniejące alerty; Możesz nadal używać zarówno tych, jak i starszych alertów równolegle.

Wyświetlanie i organizowanie alertów

Kliknij na pasku bocznym, aby otworzyć stronę listy alertów.

• Karta Alerty jest domyślnie otwarta i pokazuje wszystkie alerty w obszarze roboczym. Możesz wpisać, aby filtrować według nazwy. Kliknij pozycję Tylko moje alerty , aby wyświetlić tylko alerty, w których jesteś właścicielem.

• Karta Starsze alerty wyświetla alerty utworzone przy użyciu poprzedniego systemu alertów.

• Kolumna Nazwa zawiera nazwy poszczególnych alertów w postaci ciągu.

• Stan pokazuje, czy stan alertu to TRIGGERED, OK, czy ERROR.

• Harmonogram pokazuje czas ostatniej aktualizacji lub datę.

• Właściciel wyświetla nazwę użytkownika osoby, która jest właścicielem alertu.

• Utworzony na stronie pokazuje datę i godzinę utworzenia alertu.

  • TRIGGERED oznacza, że podczas ostatniego wykonania kolumna Value w zapytaniu docelowym spełniła skonfigurowany przez ciebie warunek i próg. Jeśli alert sprawdza, czy liczba "koty" jest powyżej 1500, alert zostanie wyzwolony, dopóki liczba "koty" jest powyżej 1500.
  • OK oznacza, że w ostatnim wykonaniu zapytania kolumna Value nie spełnia skonfigurowanego warunku i progu . Nie oznacza to, że alert nie został wcześniej wyzwolony. Jeśli wartość "cats" wynosi teraz 1470, alert będzie wyświetlany jako OK.
  • ERROR wskazuje, że wystąpił błąd podczas oceny alertu.

Tworzenie alertu

W krokach w tej sekcji przedstawiono sposób tworzenia alertu pokazanego na poniższej ilustracji. Użyj etykiet i wyjaśnień, aby zrozumieć każdy składnik.

1. Edytor zapytań: Napisz i przetestuj zapytanie, względem którego chcesz otrzymywać alerty.

2. Harmonogram: Ustaw okresowy harmonogram uruchamiania alertu.

3. Warunek: Wybierz próg wartości, który powinien wyzwolić powiadomienie o alercie. Zapytanie można uruchomić, aby przetestować warunek z tej sekcji.

4. Powiadomienia: Określ, którzy użytkownicy lub miejsca docelowe powiadomień mają być powiadamiani, gdy wartość progowa spadnie poza oczekiwany zakres.

5. Zaawansowany: Użyj ustawień zaawansowanych, aby otrzymywać alerty dotyczące wartości specjalnych i warunków.

Ważne

W okresie publicznej wersji zapoznawczej alerty nie obsługują zapytań z parametrami. Zobacz Co to są starsze alerty?.

Aby utworzyć alert, wykonaj następujące czynności:

1. Kliknij alerty na pasku bocznym, a następnie kliknij Utwórz alert.

2. Skopiuj i wklej następujące zapytanie w edytorze zapytań. Kliknij pozycję Uruchom wszystko (1000). Aby dowiedzieć się więcej na temat pracy z edytorem SQL, zobacz Pisanie zapytań i eksplorowanie danych w nowym edytorze SQL.

   SELECT
     to_date(tpep_pickup_datetime) as date,
     SUM(fare_amount) as amount
   FROM
     `samples`.`nyctaxi`.`trips`
   GROUP BY
     ALL
   ORDER BY
     1 DESC
   
   

3. W polu Warunek ustaw warunki, które powinny wyzwolić alert.

   

   Zastosuj następujące ustawienia, jak pokazano poniżej:

   • Wybierz pozycję Suma jako wartość danych, która ma być sprawdzana. Warunki alertu można ustawić na pierwszej wartości kolumny w wyniku zapytania lub można ustawić agregację we wszystkich wierszach pojedynczej kolumny, takich jak SUM lub AVERAGE.
   • Wybierz wartość jako kolumnę do sprawdzenia.
   • Wybierz operator logiczny > (większe niż), który ma być stosowany.
   • Ustaw wartość progową na Static value 4000. Wartość statyczna jest domyślnie zaznaczona. Wprowadź wartość 4000 w polu wartości.

4. Kliknij pozycję Warunek testu , aby wyświetlić podgląd alertu i sprawdzić, czy alert będzie wyzwalany przy użyciu bieżących danych. Podane ustawienia powinny wyzwolić alert. Możesz zmienić wartość progową, aby dokładniej przetestować.

5. W sekcji Powiadomienia wyszukaj nazwę użytkownika i kliknij ją po wyświetleniu.

6. Kliknij Ikona kalendarza, aby otworzyć okno dialogowe Edytowanie harmonogramu . Użyj menu rozwijanych, aby ustawić alert tak, aby był uruchamiany co 5minut od 0 minut po godzinie. Kliknij przycisk Zapisz. Opcjonalnie zaznacz pole wyboru Pokaż składnię cron, aby edytować harmonogram w składni Cron w Quartz.

7. Kliknij pozycję Wyświetl alert.

Alert zostanie zapisany i uruchomiony zgodnie z podanym harmonogramem. Dane używane w tym przykładzie są statyczne, więc jeśli warunek testu został zwrócony jako wyzwolony, po następnym uruchomieniu zostanie ponownie uruchomiony. Otrzymasz powiadomienie e-mail jako alert. Jeśli warunek testu zwrócił ok, żadne powiadomienie nie zostanie wysłane.

Przeglądanie szczegółów alertu

Zostanie otwarta strona zawierająca szczegóły alertu. Ponadto historia alertów jest wyświetlana ze szczegółami historii oceny. Kliknij przycisk Uruchom teraz , aby natychmiast uruchomić zapytanie alertu i zwrócić wynik na tym ekranie.

Kliknij przycisk Edytuj w prawym górnym rogu strony, aby kontynuować edytowanie alertu.

Ustawienia zaawansowane

Kliknij pozycję Ustawienia zaawansowane , aby zastosować następujące ustawienia:

• Powiadom w ok: Wyślij powiadomienie, gdy alert zostanie zwrócony jako OK.

• Częstotliwość powiadomień: Okresowo wysyłaj powiadomienia dotyczące alertu, dopóki stan nie powróci do OK.

• Pusty stan wyniku: Ustaw stan specjalny, który ma być zwracany, gdy zapytanie nie zwraca żadnych wyników.

• Szablon: Możesz wysyłać powiadomienia przy użyciu szablonu domyślnego lub szablonu niestandardowego. Poniższa lista zawiera opis każdego typu szablonu:

  • Użyj szablonu domyślnego: powiadomienie o alertach to komunikat z linkami do ekranu konfiguracja alertu i ekranu Zapytanie.

  • Użyj szablonu niestandardowego: powiadomienie o alertach zawiera bardziej szczegółowe informacje o alercie.

    1. Zostanie wyświetlone pole składające się z pól wejściowych dla tematu i treści. Dowolna zawartość statyczna jest prawidłowa i można uwzględnić wbudowane zmienne szablonu:

       • ALERT_STATUS: oceniany stan alertu (ciąg).
       • ALERT_CONDITION: operator warunku alertu (ciąg).
       • ALERT_THRESHOLD: Próg alertu (ciąg lub liczba).
       • ALERT_COLUMN: nazwa kolumny alertu (ciąg).
       • ALERT_NAME: nazwa alertu (ciąg).
       • ALERT_URL: adres URL strony alertu (ciąg).
       • QUERY_RESULT_TABLE: tabela HTML wyniku zapytania (ciąg). Wyniki są ograniczone do pierwszych 100 wierszy. Tylko miejsca docelowe powiadomień e-mail mogą renderować kod HTML.
       • QUERY_RESULT_VALUE: wartość wyniku zapytania (ciąg lub liczba).
       • QUERY_RESULT_ROWS: wiersze wyników zapytania (tablica wartości).
       • QUERY_RESULT_COLS: kolumny wyników zapytania (tablica ciągów).

       Przykładem tematu może być na przykład: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

    2. Kod HTML umożliwia formatowanie komunikatów w szablonie niestandardowym. Tylko miejsca docelowe powiadomień e-mail mogą renderować kod HTML. Następujące tagi i atrybuty są dozwolone w szablonach:

       • Dozwolone tagi: <a>, <b>, <blockquote>, <br>, <code>, <del>, <div>, <em>, <h1>, <h2>, <h3>, <h4>, <h5>, <h6>, <hr>, <i>, <img>, <li>, <ol>, <p>, <pre>, <span>, <table>, <thread>, <tbody>, <td>, <th>, <tr>, <u>, <ul>

       • Dozwolone atrybuty:

         Atrybut	Obsługiwane tagi
         href	<a>
         title	<img>
         target	<a>
         alt	<img>
         src	<img>
         start	<b>, <blockquote>, , <code>, <del><em>, <hr>, , <i><pre><u>

    3. Kliknij przycisk przełącznika Podgląd, aby wyświetlić podgląd renderowanego wyniku.

       Ważne

       Wersja zapoznawcza jest przydatna do sprawdzania, czy zmienne szablonu są renderowane poprawnie. Nie jest to dokładna reprezentacja zawartości powiadomienia ostatecznej, ponieważ każde miejsce docelowe powiadomień może wyświetlać powiadomienia inaczej.

Administratorzy obszaru roboczego mogą skonfigurować nowe miejsca docelowe powiadomień. Zobacz Zarządzanie miejscami docelowymi powiadomień.

Agregacje alertów

Agregacja alertu działa przez zmodyfikowanie oryginalnego kodu SQL zapytania SQL usługi Databricks dołączonego do alertu. Alert opakowuje oryginalny tekst zapytania w typowym wyrażeniu tabeli (CTE) i wykonuje na nim zapytanie agregujące, aby zagregować wynik zapytania.

Na przykład agregacja alertu dołączonego do zapytania z tekstem oznacza, SUM że za każdym razem, gdy alert zostanie odświeżony, zmodyfikowany kod SQL, który jest uruchamiany, to: SELECT 1 AS column_name.WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q

Oznacza to, że oryginalny wynik zapytania (wstępnie zagregowany) nie może być wyświetlany w treści niestandardowej alertu (z parametrami takimi jak QUERY_RESULT_ROWS i QUERY_RESULT_COLS) zawsze, gdy istnieje agregacja alertu. Zamiast tego te zmienne będą wyświetlać tylko końcowy wynik zapytania po agregacji.

Uwaga

Wszystkie warunki wyzwalacza związane z agregacjami nie są obsługiwane przez interfejs API.

Alert dotyczący wielu kolumn

Aby ustawić alert na podstawie wielu kolumn zapytania, zapytanie może zaimplementować logikę alertu i zwrócić wartość logiczną, na podstawie której nastąpi wyzwolenie alertu. Na przykład:

SELECT CASE WHEN drafts_count > 10000 AND archived_count > 5000 THEN 1 ELSE 0 END
FROM (
SELECT sum(CASE WHEN is_archived THEN 1 ELSE 0 END) AS archived_count,
sum(CASE WHEN is_draft THEN 1 ELSE 0 END) AS drafts_count
FROM queries) data

To zapytanie zwraca wartość 1 , gdy drafts_count > 10000 and archived_count > 5000. Następnie można skonfigurować alert do wyzwalania, gdy wartość to 1.

Alert dotyczący widoków metryk

Ponieważ widoki metryk są przeznaczone do śledzenia i mierzenia podstawowych metryk biznesowych, są one dobrze sparowane z alertami, aby można było automatycznie otrzymywać powiadomienia, gdy metryka znajduje się poza oczekiwanym zakresem. Alerty dotyczące widoków metryk działają w taki sam sposób, jak alert dotyczący dowolnego innego zestawu danych. Podczas pisania zapytania w celu skonfigurowania zapytania użyj w pełni kwalifikowanej nazwy widoku metryki, który chcesz monitorować.

Jak działa integracja z usługą Git z alertami

Foldery Git usługi Databricks umożliwiają śledzenie zmian alertów i zarządzanie nimi. Aby śledzić alerty za pomocą Git, umieść je w folderze Git Databricks. Nowo sklonowane alerty są wyświetlane tylko na stronie listy alertów lub interfejsie API po interakcji z nimi przez użytkownika. Wstrzymano harmonogramy i muszą zostać ręcznie wznowione przez użytkowników.

Foldery Git usługi Databricks zapewniają scentralizowany sposób zarządzania typowymi operacjami usługi Git dla alertów i innych obiektów obszaru roboczego. Aby dowiedzieć się więcej, zobacz Foldery Git usługi Azure Databricks.

Różnice w porównaniu ze starszymi alertami

Najnowsza wersja alertów SQL usługi Databricks działa inaczej niż w przypadku starszych alertów na kilka kluczowych sposobów:

• Integracja zadań: Najnowsza wersja wciąż nie obsługuje bezpośredniego odwoływania się do alertu w potoku zadań. Ta funkcja będzie dostępna wkrótce. Starsze alerty obsługują typ zadania "Alerty" w sekcji "Zadania".
• Ponowne użycie zapytania: Podczas tworzenia alertu nie można ponownie użyć istniejącego zapisanego zapytania SQL. Każdy alert jest właścicielem definicji zapytania, którą można utworzyć bezpośrednio w nowym edytorze alertów.
• Wartości stanu alertu: Stany alertów są uproszczone i alerty nie obsługują UNKNOWN już stanu starszych alertów. Oceny są rozpoznawane jako OK, TRIGGERED lub ERROR.

Podczas przechodzenia możesz nadal używać zarówno najnowszych alertów, jak i starszych alertów.

Konfigurowanie uprawnień alertu i przenoszenie własności alertów

Aby uzyskać informacje o poziomach uprawnień alertów, zobacz Listy ACL alertów.

1. Na pasku bocznym kliknij pozycję Alerty.

2. Kliknij alert.

3. Kliknij pozycję Udostępnij w prawym górnym rogu strony szczegółów alertu, aby otworzyć okno dialogowe Udostępnianie .

   

4. Wyszukaj i wybierz grupy i użytkowników, a następnie przypisz poziom uprawnień.

5. Kliknij przycisk Dodaj.

Przenoszenie własności alertu

Po zapisaniu alertu stajesz się właścicielem alertu. Jeśli właściciel alertu zostanie usunięty z obszaru roboczego, alert nie ma już właściciela. Administrator obszaru roboczego może przenieść własność alertu do innego użytkownika. Własność można również przenieść przy użyciu interfejsu API uprawnień.

1. Jako administrator obszaru roboczego zaloguj się do obszaru roboczego usługi Azure Databricks.

2. Na pasku bocznym kliknij pozycję Alerty.

3. Kliknij alert.

4. Kliknij przycisk Udostępnij w prawym górnym rogu, aby otworzyć okno dialogowe Udostępnianie.

5. Kliknij ikonę koła zębatego w prawym górnym rogu i kliknij pozycję Przypisz nowego właściciela.

   

6. Wybierz użytkownika, któremu chcesz przypisać własność.

7. Kliknij przycisk Potwierdź.