Udostępnij za pośrednictwem

Alerty SQL usługi Databricks

Ważne

Ta funkcja jest dostępna w wersji beta.

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. Podczas planowania alertu skojarzone z nim zapytanie jest uruchamiane, a kryteria alertu są sprawdzane niezależnie od istniejących harmonogramów w zapytaniu źródłowym. 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

W przypadku większości klientów administratorzy obszarów roboczych mogą kontrolować dostęp obszaru roboczego do tej wersji zapoznawczej ze strony Podglądy. Jeśli ta wersja alertów nie jest widoczna w obszarze roboczym, skontaktuj się z zespołem ds. kont usługi Databricks.

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 ikonę alertów na pasku bocznym, aby otworzyć stronę listy alertów.

Strona 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 UNKNOWN.

  • 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 wartość w polu „Koty” jest wyższa niż 1500, zostanie wyzwolony, jeśli wartość w polu „Koty” będzie wyższa niż 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.
    • UNKNOWN wskazuje, że usługa Databricks SQL nie ma wystarczającej ilości danych, aby ocenić kryteria alertu. Ten stan jest wyświetlany natychmiast po utworzeniu alertu i pozostaje do momentu uruchomienia zapytania. Ten stan jest również używany, jeśli w wyniku zapytania nie było żadnych danych lub jeśli najnowszy wynik zapytania nie zawiera skonfigurowanej kolumny wartości .
    • 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.

Interfejs użytkownika tworzenia alertu jest wyświetlany z numerowaną etykietą identyfikującą różne części.

  1. Zestaw danych: Napisz i przetestuj zapytanie, względem którego chcesz otrzymywać alerty.
  2. Warunek: Wybierz próg wartości, który powinien wyzwolić powiadomienie o alercie. Zapytanie można uruchomić, aby przetestować warunek z tej sekcji.
  3. Harmonogram: Ustaw okresowy harmonogram uruchamiania alertu.
  4. Powiadomienia: Określ, czy użytkownicy lub miejsca docelowe powiadomień powinny otrzymywać alerty, gdy wartość progowa wykracza poza oczekiwany zakres.
  5. Zaawansowany: Użyj ustawień zaawansowanych, aby otrzymywać alerty dotyczące wartości specjalnych i warunków.

Ważne

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

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

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

  2. Skopiuj i wklej następujące zapytanie w edytorze zestawu danych .

    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.

    Pole warunku z zastosowanymi ustawieniami, zgodnie z poniższym tekstem.

    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. Użyj menu rozwijanych Harmonogram , aby ustawić alert, aby był uruchamiany co 5minut od 0 minut po godzinie. Opcjonalnie zaznacz pole wyboru Pokaż składnię cron, aby edytować harmonogram w składni Cron w Quartz.

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

  7. Kliknij pozycję Utwórz.

Alert zostanie zapisany i zostanie 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_NAME: skojarzona nazwa zapytania (ciąg).
        • QUERY_URL: skojarzony adres URL strony zapytania (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:

        • Tagi: <a>, <abbr><acronym><b><blockquote><body><br><code><div><em><h1><h2><h3><h4><h5><h6><head><hr><html><i><li><ol><p><span><strong><table><tbody><td><th><tr><ul>
        • Atrybuty: href (dla <a>), tytuł (dla <a>, <abbr>, <acronym>)

      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 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 integracja Git dla folderów Git w Databricks.

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 .

    Zarządzanie uprawnieniami alertów

  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. Jednostki usługi i grupy nie mogą mieć przypisanej własności alertu. 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.

    Przypisywanie nowego właściciela

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

  7. Kliknij przycisk Potwierdź.