Co jsou upozornění SQL služby Databricks?

Článek
07/11/2024

Upozornění SQL služby Databricks pravidelně spouštějí dotazy, vyhodnocují definované podmínky a odesílají oznámení, pokud je splněna podmínka. Můžete nastavit upozornění pro monitorování vaší firmy a odesílání oznámení, když hlášená data spadají mimo očekávané limity. Plánování výstrahy provede základní dotaz a zkontroluje kritéria upozornění. To je nezávislé na jakémkoli plánu, který může existovat v podkladovém dotazu.

Důležité

Výstrahy využívající dotazy s parametry používají výchozí hodnotu zadanou v editoru SQL pro každý parametr.

Zobrazení a uspořádání upozornění

Pro přístup k upozorněním použijte jednu z následujících možností:

Kliknutím na pracovní prostor na bočním panelu zobrazíte výstrahy ve složce Domů, kde jsou ve výchozím nastavení uloženy. Uživatelé můžou upozornění uspořádat do složek v prohlížeči pracovního prostoru spolu s dalšími objekty Databricks.
Kliknutím na výstrahy na bočním panelu zobrazte stránku s výpisem výstrah.

Ve výchozím nastavení jsou objekty seřazené v obráceném chronologickém pořadí. Uspořádání seznamu můžete změnit kliknutím na záhlaví sloupce. Kliknutím na kartu Všechny výstrahy v horní části obrazovky zobrazíte všechna upozornění v pracovním prostoru. Kliknutím na kartu Moje upozornění zobrazíte výstrahy, ve kterých jste vlastníkem.

Název zobrazuje název řetězce každé výstrahy.
Stav ukazuje, zda je stav výstrahy TRIGGERED, OK nebo UNKNOWN.
Poslední aktualizace zobrazuje čas nebo datum poslední aktualizace.
Vytvořeno při zobrazení data a času vytvoření výstrahy.
- TRIGGERED znamená, že při posledním spuštění sloupec hodnoty v cílovém dotazu splnil konfigurovanou podmínku a prahovou hodnotu. Pokud vaše výstraha kontroluje, zda je hodnota „kočky“ vyšší než 1500, vaše výstraha se aktivuje, pokud je hodnota „kočky“ vyšší než 1500.
- OK znamená, že při posledním spuštění dotazu sloupec hodnoty nesplnil konfigurovanou podmínku a prahovou hodnotu. To neznamená, že se upozornění neaktivovalo dříve. Pokud je hodnota "kočky" nyní 1470, zobrazí se upozornění jako OK.
- UNKNOWN znamená, že Databricks SQL nemá dostatek dat k vyhodnocení kritérií upozornění. Tento stav se zobrazí okamžitě po vytvoření výstrahy a až do provedení dotazu. Tento stav se zobrazí také v případě, že ve výsledku dotazu nejsou žádná data nebo pokud poslední výsledek dotazu neobsahuje nakonfigurovaný Sloupec hodnoty.

Vytvoření upozornění

Podle těchto kroků vytvořte upozornění na jeden sloupec dotazu.

Proveďte některou z následujících akcí:
- Na bočním panelu klikněte na Nový a vyberte Výstraha.
- Na bočním panelu klikněte na Upozornění a klikněte na tlačítko + Nové upozornění.
- Na bočním panelu klikněte na Pracovní prostor a klikněte na + Vytvořit upozornění.
- Klikněte na nabídku kebab v pravém horním rohu uloženého dotazu a klikněte na + Vytvořit upozornění.
V poli Dotaz vyhledejte cílový dotaz.

Pokud chcete upozorňovat na více sloupců, musíte upravit dotaz. Viz Agregace výstrah.
V poli Podmínka aktivační události nakonfigurujte výstrahu.
- Rozevírací seznam Sloupec Hodnota určuje, které pole výsledku dotazu se vyhodnotí. Podmínky upozornění se dají nastavit na první hodnotu sloupce ve výsledku dotazu nebo můžete nastavit agregaci napříč všemi řádky jednoho sloupce, jako je SUMA nebo PRŮMĚR.
- Rozevírací seznam Operátor řídí logickou operaci, která se má použít.
- Textové zadání prahové hodnoty se porovná se sloupcem Hodnota pomocí zadané podmínky.
Kliknutím na náhled upozornění zobrazíte náhled výstrahy a otestujete, jestli se výstraha aktivuje s aktuálními daty.
V poli Při aktivaci upozornění vyberte, kolik oznámení se odešle při aktivaci upozornění:
- Jen jednou: Odešlete oznámení, když se stav výstrahy změní na OK TRIGGERED.
- Při každém vyhodnocení výstrahy odešlete oznámení vždy, když je TRIGGERED stav výstrahy bez ohledu na jeho stav v předchozím vyhodnocení.
- Ve většině případů: Pošlete oznámení vždy, když je TRIGGERED stav výstrahy v určitém intervalu. Tato volba vám umožní vyhnout se spamu oznámení pro upozornění, která se často aktivují.
Bez ohledu na to, které nastavení oznámení zvolíte, obdržíte oznámení vždy, když stav přejde z OK nebo TRIGGERED do OKTRIGGERED . Nastavení plánu ovlivňuje, kolik oznámení obdržíte, pokud stav zůstane TRIGGERED z jednoho spuštění na další. Podrobnosti najdete v tématu Četnost oznámení.
V rozevíracím seznamu Šablona zvolte šablonu:
- Použít výchozí šablonu: Oznámení výstrahy je zpráva s odkazy na obrazovku Konfigurace upozornění a na obrazovku Dotaz.
- Použít vlastní šablonu: Oznámení výstrahy obsahuje konkrétnější informace o upozornění.
  1. Zobrazí se pole skládající se ze vstupních polí pro předmět a text. Jakýkoli statický obsah je platný a můžete začlenit předdefinované proměnné šablony:
    - ALERT_STATUS: Vyhodnocený stav výstrahy (řetězec).
    - ALERT_CONDITION: Operátor podmínky upozornění (řetězec).
    - ALERT_THRESHOLD: Prahová hodnota upozornění (řetězec nebo číslo).
    - ALERT_COLUMN: Název sloupce upozornění (řetězec).
    - ALERT_NAME: Název výstrahy (řetězec).
    - ALERT_URL: Adresa URL stránky upozornění (řetězec).
    - QUERY_NAME: Přidružený název dotazu (řetězec).
    - QUERY_URL: Přidružená adresa URL stránky dotazu (řetězec).
    - QUERY_RESULT_TABLE: Tabulka HTML (řetězec) výsledku dotazu.
    - QUERY_RESULT_VALUE: Hodnota výsledku dotazu (řetězec nebo číslo).
    - QUERY_RESULT_ROWS: Řádky výsledků dotazu (pole hodnot).
    - QUERY_RESULT_COLS: Sloupce výsledků dotazu (pole řetězců).
    Příklad předmětu může být například: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.
  2. K formátování zpráv ve vlastní šabloně můžete použít HTML. V šablonách jsou povoleny následující značky a atributy:
    - Tagy: <a>, <abbr>, , <acronym>, <blockquote><body><em><b><div><code><br>, , <html><i><hr>><head<li>><h6<ol><table><strong><tbody><span><td><th><h2><h4><tr><h3><h5><p><h1><ul>
    - Atributy: href (for <a>), title (for <a>, <abbr>, <acronym>)
  3. Kliknutím na přepínač Náhled zobrazíte náhled vykresleného výsledku.
    
    Důležité
    
    Náhled je užitečný k ověření správného vykreslení proměnných šablony. Nejedná se o přesnou reprezentaci obsahu konečného oznámení, protože každý cíl oznámení může zobrazovat oznámení odlišně.
  4. Klikněte na tlačítko Uložit změny .
Klikněte na Vytvořit upozornění.
Klikněte na Přidat plán.
- Pomocí rozevíracích výběrů určete frekvenci, období, počáteční čas a časové pásmo. Volitelně můžete zaškrtnout políčko Zobrazit syntaxi cron a upravit plán v syntaxi Quartz Cron.
- Pokud chcete zobrazit volitelná nastavení, zvolte Další možnosti . Můžete také zvolit:
  - Název plánu.
  - SQL Warehouse k napájení dotazu. Ve výchozím nastavení se pro naplánovanou úlohu používá také SQL Warehouse sloužící k provádění ad hoc dotazů. Pomocí tohoto volitelného nastavení můžete vybrat jiný sklad pro spuštění naplánovaného dotazu.
V dialogovém okně Přidat plán klikněte na kartu Cíle.
- Pomocí rozevíracího seznamu vyberte dostupný cíl oznámení. Nebo začněte psát uživatelské jméno pro přidání jednotlivců.
Důležité

Pokud tento krok přeskočíte, při aktivaci upozornění nebudete upozorněni.
Klikněte na Vytvořit. Na obrazovce se zobrazí vaše uložené upozornění a podrobnosti oznámení.
Sdílejte plán.
- Napravo od uvedeného plánu zvolte nabídku kebab a vyberte Upravit oprávnění plánu.
- V rozevírací nabídce v dialogovém okně zvolte uživatele nebo skupinu.
- Vyberte si z následujících oprávnění plánu:
  - ŽÁDNÁ OPRÁVNĚNÍ: Nebyla udělena žádná oprávnění. Uživatelé bez oprávnění nevidí, že plán existuje, i když jsou předplatiteli nebo zahrnuti do uvedených cílů oznámení.
  - CAN VIEW: Uděluje oprávnění k zobrazení plánovaných výsledků spuštění.
  - MŮŽE SPRAVOVAT SPUŠTĚNÍ: Uděluje oprávnění k zobrazení plánovaných výsledků spuštění.
  - MŮŽE SPRAVOVAT: Uděluje oprávnění k zobrazení, úpravám a odstraňování plánů. Toto oprávnění se vyžaduje, aby bylo možné provádět změny intervalu spuštění, aktualizovat seznam odběratelů a pozastavit nebo zrušit pozastavení plánu.
  - IS OWNER: Uděluje všechna oprávnění MŮŽE SPRAVOVAT. Přihlašovací údaje vlastníka plánu se navíc použijí ke spouštění dotazů na řídicí panely. Vlastníka může změnit jenom správce pracovního prostoru.
Důležité

Oprávnění pro výstrahy a plány jsou oddělená. Udělte uživatelům a skupinám v seznamu cílů oznámení přístup, aby mohli zobrazit naplánované výsledky spuštění.
Sdílejte upozornění.
- Klikněte poblíž pravého horního rohu stránky.
- Přidejte uživatele nebo skupiny, kteří mají mít k upozornění přístup.
- Zvolte odpovídající úroveň oprávnění a potom klikněte na Přidat.

Důležité

CAN MANAGE uděluje oprávnění k zobrazení, úpravám a odstraňování plánů. Toto oprávnění se vyžaduje, aby bylo možné provádět změny intervalu spuštění, aktualizovat cílový seznam oznámení a pozastavit nebo zrušit pozastavení plánu.

Další informace o úrovních oprávnění výstrah najdete v tématu Seznamy ACL výstrah.

Agregace výstrah

Agregace výstrahy funguje úpravou původního sql dotazu SQL Databricks připojeného k upozornění. Výstraha zabalí původní text dotazu do společného výrazu tabulky (CTE) a provede na něm zalamovací agregační dotaz, který agreguje výsledek dotazu.

Například agregace výstrahy připojené k dotazu s textem znamená, SUM že při každé aktualizaci výstrahy bude změněný SQL, který se spustí: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q.SELECT 1 AS column_name

To znamená, že původní výsledek dotazu (předem agregovaný) se nedá zobrazit ve vlastním textu výstrahy (s parametry, jako QUERY_RESULT_ROWS jsou a QUERY_RESULT_COLS) vždy, když je u výstrahy agregace. Místo toho tyto proměnné zobrazí pouze konečný výsledek dotazu po agregaci.

Poznámka:

Rozhraní API nepodporuje všechny podmínky triggeru související s agregacemi.

Výstrahy pro několik sloupců

Pokud chcete nastavit výstrahu na základě více sloupců dotazu, může váš dotaz implementovat logiku upozornění a vrátit logickou hodnotu, pro kterou se má upozornění aktivovat. Příklad:

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

Tento dotaz vrátí 1 , když drafts_count > 10000 and archived_count > 5000. Výstrahu pak můžete nakonfigurovat tak, aby se aktivovala, když je 1hodnota .

Četnost oznámení

Databricks SQL odesílá oznámení do vybraných cílů oznámení, kdykoli zjistí, že se stav upozornění změnil z OK TRIGGERED nebo naopak. Podívejte se na tento příklad, kdy je pro dotaz, který je naplánovaný tak, aby se spouštěl jednou denně, nakonfiguroval upozornění. Denní stav výstrahy se zobrazí v následující tabulce. Před pondělím byl stav výstrahy OK.

Den	Stav výstrahy
Pondělí	OK
Úterý	OK
Středa	AKTIVOVANÝ
Čtvrtek	AKTIVOVANÝ
Pátek	AKTIVOVANÝ
Sobota	AKTIVOVANÝ
Neděle	OK

Pokud je frekvence oznámení nastavená na Just Once, Odešle SQL databricks oznámení ve středu, když se stav změní na OK TRIGGERED a znovu v neděli, když se přepne zpět. Neodesílá výstrahy ve čtvrtek, pátek nebo sobotu, pokud ji výslovně nenakonfigurujete, protože se stav výstrahy v těchto dnech nezměnil.

Konfigurace oprávnění upozornění a přenos vlastnictví upozornění

Abyste mohli sdílet dotazy, musíte mít alespoň oprávnění KE SPRÁVĚ dotazu. Úrovně oprávnění pro výstrahy najdete v tématu Seznamy ACL výstrah.

Na bočním panelu klikněte na Upozornění.
Klikněte na výstrahu.
Kliknutím na tlačítko v pravém horním rohu otevřete dialogové okno Sdílení .
Vyhledejte a vyberte skupiny a uživatele a přiřaďte úroveň oprávnění.
Klikněte na tlačítko Přidat.

Převod vlastnictví výstrahy

Když upozornění uložíte, stanete se vlastníkem výstrahy. Pokud je vlastník upozornění z pracovního prostoru odebrán, upozornění už nemá vlastníka. Uživatel správce pracovního prostoru může převést vlastnictví výstrahy jinému uživateli. Instanční objekty a skupiny nelze přiřadit vlastnictví výstrahy. Vlastnictví můžete také převést pomocí rozhraní API pro oprávnění.

Jako správce pracovního prostoru se přihlaste k pracovnímu prostoru Azure Databricks.
Na bočním panelu klikněte na Upozornění.
Klikněte na výstrahu.
Kliknutím na tlačítko Sdílet v pravém horním rohu otevřete dialogové okno Sdílení .
Klikněte na ikonu ozubeného kola v pravém horním rohu a klikněte na Přiřadit nového vlastníka.
Vyberte uživatele, kterému chcete přiřadit vlastnictví.
Klikněte na tlačítko Potvrdit.

Sdílet prostřednictvím