Upozornění SQL služby Databricks

Důležité

Tato funkce je ve verzi Public Preview.

Tato stránka obsahuje podrobné pokyny k povolení a používání upozornění SQL služby Databricks k automatizaci spouštění dotazů, vyhodnocování vlastních podmínek a doručování oznámení při splnění těchto podmínek. Díky upozorněním můžete proaktivně monitorovat obchodní data a dostávat včasná oznámení, kdykoli hlášené hodnoty spadají mimo očekávané prahové hodnoty. Když naplánujete upozornění, spustí se přidružený dotaz a kritéria upozornění se kontrolují bez ohledu na všechny existující plány podkladového dotazu. Kromě toho můžete získat přístup k historii upozornění a zkontrolovat výsledky předchozích vyhodnocení výstrah.

Informace o tom, jak místo toho pracovat se staršími upozorněními, najdete v tématu Co jsou starší upozornění?

Povolení upozornění ve vašem pracovním prostoru

Správci pracovních prostorů můžou řídit přístup k tomuto náhledu ze stránky Previews. Povolení této verze Preview nemá vliv na vaše stávající výstrahy; Tato i starší upozornění můžete dál používat paralelně.

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

Kliknutím na na bočním panelu otevřete stránku s výpisem výstrah.

• Ve výchozím nastavení je otevřená karta Upozornění a zobrazí se všechna upozornění v pracovním prostoru. Můžete zadat filtrování podle názvu. Kliknutím na Jenom moje výstrahy zobrazíte jenom výstrahy, ve kterých jste vlastníkem.

• Karta Starší výstrahy zobrazuje výstrahy vytvořené pomocí předchozího systému upozornění.

• Název zobrazuje název řetězce každé výstrahy.

• Stav zobrazuje, zda je TRIGGEREDstav výstrahy , OKnebo ERROR.

• Plán zobrazuje čas nebo datum poslední aktualizace.

• Vlastník zobrazí uživatelské jméno osoby, která výstrahu vlastní.

• Vytvořeno při zobrazení data a času vytvoření výstrahy.

  • TRIGGERED znamená, že při posledním spuštění sloupec Hodnota v cílovém dotazu splnil podmínku aprahovou hodnotu , kterou jste nakonfigurovali. Pokud vaše výstraha kontroluje, zda hodnota "kočky" překročí 1500, upozornění se spustí, kdykoli hodnota "kočky" překročí 1500.
  • OK znamená, že při posledním spuštění dotazu sloupec Hodnota nesplní nakonfigurovanou podmínku a prahovou hodnotu . To neznamená, že se upozornění neaktivovalo dříve. Pokud je hodnota "cats" nyní 1470, zobrazí se upozornění jako OK.
  • ERROR značí, že během vyhodnocení výstrahy došlo k chybě.

Vytvoření upozornění

Kroky v této části vás provedou postupem vytvoření výstrahy zobrazené na následujícím obrázku. Popisky a vysvětlení použijte k pochopení jednotlivých komponent.

1. Editor dotazů: Napište a otestujte dotaz, na který chcete upozornit.

2. Naplánovat: Nastavte pravidelný plán spuštění výstrahy.

3. Podmínka: Vyberte prahovou hodnotu hodnoty, která by měla aktivovat oznámení výstrahy. Můžete spustit dotaz a otestovat podmínku v této části.

4. Upozornění: Uveďte, kteří uživatelé nebo cíle oznámení mají být upozorněni, když prahová hodnota spadá mimo očekávaný rozsah.

5. Pokročilý: Upřesňující nastavení slouží k upozorňování na zvláštní hodnoty a podmínky.

Důležité

Během období Public Preview upozornění nepodporují dotazy s parametry. Podívejte se, co jsou původní upozornění.

K vytvoření výstrahy použijte následující postup:

1. Klikněte v postranním panelu na Upozornění a potom klikněte na Vytvořit upozornění.

2. Zkopírujte a vložte následující dotaz do editoru dotazů. Klikněte na Spustit vše (1000). Další informace o práci s editorem SQL najdete v tématu Psaní dotazů a zkoumání dat v novém editoru 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. V poli Podmínka nastavte podmínky, které by měly aktivovat výstrahu.

   

   Použijte následující nastavení, jak je znázorněno:

   • Vyberte Součet jako hodnotu dat, kterou chcete zkontrolovat. 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.
   • Vyberte hodnotu jako sloupec, který chcete zkontrolovat.
   • Vyberte > (větší než) jako logický operátor, který chcete použít.
   • Nastavte prahovou hodnotu na Static value 4000. Ve výchozím nastavení je vybraná statická hodnota. Do pole hodnoty zadejte hodnotu 4000.

4. Kliknutím na testovací podmínku zobrazíte náhled výstrahy a otestujete, jestli se výstraha aktivuje s aktuálními daty. Poskytnutá nastavení by měla aktivovat výstrahu. Prahovou hodnotu můžete změnit na další testování.

5. V části Oznámení vyhledejte svoje uživatelské jméno a klikněte na něj, až se zobrazí.

6. Klikněte na Kliknutím na ikonu kalendáře otevřete dialogové okno Upravit plán . Pomocí rozevíracích nabídek nastavte upozornění tak, aby se spustilo každých 5minutod 0 minut po hodině. Klikněte na Uložit. Volitelně můžete zaškrtnout políčko Zobrazit syntaxi cron, abyste upravili plán v syntaxi Quartz Cron.

7. Klikněte na Zobrazit upozornění.

Vaše upozornění se uloží a spustí podle plánu, který jste zadali. Data použitá v tomto příkladu jsou statická, takže pokud se podmínka testu vrátí jako aktivovaná, při příštím spuštění se znovu spustí. Obdržíte e-mailové oznámení jako upozornění. Pokud testovací podmínka vrátila OK, není odesláno žádné oznámení.

Kontrola podrobností výstrahy

Otevře se stránka s podrobnostmi o upozornění. Kromě toho se zobrazí historie upozornění s podrobnostmi o historii vyhodnocení. Kliknutím na tlačítko Spustit hned spustíte dotaz upozornění a vrátíte výsledek na této obrazovce.

Kliknutím na Upravit v pravém horním rohu stránky pokračujte v úpravách výstrahy.

Rozšířené nastavení

Chcete-li použít následující nastavení, klikněte na Upřesnit nastavení :

• Upozornit na OK: Odeslat oznámení, když se výstraha vrátí jako OK.

• Frekvence oznámení: Pravidelně odesílat oznámení o upozornění, dokud se stav nevrátí do OK.

• Prázdný stav výsledku: Nastavte zvláštní stav, který se má vrátit, když dotaz nevrátí žádné výsledky.

• Šablona: Oznámení můžete odesílat pomocí výchozí šablony nebo vlastní šablony. Každý typ šablony je vysvětlený v následujícím seznamu:

  • 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_RESULT_TABLE: Tabulka HTML výsledku dotazu (řetězec). Výsledky jsou omezeny na prvních 100 řádků. Pouze cílová umístění pro e-mailová oznámení mohou vykreslit HTML.
       • 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. Pouze cílová umístění pro e-mailová oznámení mohou vykreslit HTML. V šablonách jsou povoleny následující značky a atributy:

       • Povolené značky: <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>

       • Povolené atributy:

         Atribut	Podporované značky
         href	<a>
         title	<img>
         target	<a>
         alt	<img>
         src	<img>
         start	<b>, <blockquote>, , <code><del><em><hr><i>, , <pre><u>

    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ě.

Správci pracovního prostoru můžou nastavit nové cíle oznámení. Viz Správa cílů oznámení.

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 tabulkového výrazu (CTE) a provede na něm agregační dotaz k agregaci výsledku 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í: SELECT 1 AS column_name.WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q

To znamená, že původní výsledek dotazu (předem agregovaný) se nedá zobrazit ve vlastním textu výstrahy (s parametry, jako jsou QUERY_RESULT_ROWS a QUERY_RESULT_COLS), kdykoli 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.

Upozornění na více 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 .

Upozornění na metrické zobrazení

Vzhledem k tomu, že zobrazení metrik jsou navržená tak, aby sledovala a měří základní obchodní metriky, dobře se spárují s upozorněními, takže můžete být automaticky upozorněni, když metrika spadá mimo očekávaný rozsah. Upozornění na zobrazení metrik fungují stejným způsobem jako upozornění na jakoukoli jinou datovou sadu. Při psaní dotazu ke konfiguraci dotazu použijte plně kvalifikovaný název zobrazení metrik, které chcete monitorovat.

Jak integrace Gitu funguje s upozorněními

Pomocí složek Git Databricks můžete sledovat a spravovat změny výstrah. Pokud chcete sledovat upozornění pomocí Gitu, umístěte je do složky Git Databricks. Nově naklonované výstrahy se zobrazí jenom na stránce se seznamem upozornění nebo rozhraní API poté, co s nimi uživatel pracuje. Pozastavili plány a uživatelé je musí explicitně obnovit.

Složky Gitu Databricks poskytují centralizovaný způsob správy běžných operací Gitu pro výstrahy a další objekty pracovního prostoru. Další informace najdete ve složkách Git v Azure Databricks.

Rozdíly oproti starším upozorněním

Nejnovější verze upozornění v rámci Databricks SQL se chová odlišně od starších upozornění několika klíčovými způsoby:

• Integrace úloh: Nejnovější verze zatím nepodporuje přímé odkazování na výstrahu v kanálu Úlohy. Tato funkce bude brzy k dispozici. Starší upozornění podporují typ úlohy Výstrahy v úlohách.
• Opakované použití dotazu: Při vytváření výstrahy nelze znovu použít existující uložený dotaz SQL. Každá výstraha vlastní definici dotazu, kterou lze vytvořit přímo v novém editoru upozornění.
• Hodnoty stavu upozornění: Stavy upozornění jsou zjednodušené a výstrahy už nepodporují UNKNOWN stav starších upozornění. Vyhodnocení se přeloží na OK, TRIGGERED nebo ERROR.

Během přechodu můžete dál používat nejnovější výstrahy i starší výstrahy.

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

Úrovně oprávnění pro výstrahy najdete v tématu Seznamy ACL výstrah.

1. Na bočním panelu klikněte na Upozornění.

2. Klikněte na výstrahu.

3. Kliknutím na Sdílet v pravém horním rohu stránky s podrobnostmi výstrahy otevřete dialogové okno Sdílení .

   

4. Vyhledejte a vyberte skupiny a uživatele a přiřaďte úroveň oprávnění.

5. 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. Vlastnictví můžete také převést pomocí rozhraní API pro oprávnění.

1. Jako správce pracovního prostoru se přihlaste k pracovnímu prostoru Azure Databricks.

2. Na bočním panelu klikněte na Upozornění.

3. Klikněte na výstrahu.

4. Kliknutím na tlačítko Sdílet v pravém horním rohu otevřete dialogové okno Sdílení .

5. Klikněte na ikonu ozubeného kola v pravém horním rohu a klikněte na Přiřadit nového vlastníka.

   

6. Vyberte uživatele, kterému chcete přiřadit vlastnictví.

7. Klikněte na tlačítko Potvrdit.