Databricks SQL-riasztások

Fontos

Ez a funkció nyilvános előzetes verzióban van.

Ez a lap részletes útmutatást nyújt a Databricks SQL-riasztások engedélyezéséhez és használatához a lekérdezések végrehajtásának automatizálásához, az egyéni feltételek kiértékeléséhez és az értesítések kézbesítéséhez a feltételek teljesülése esetén. Riasztásokkal proaktív módon figyelheti üzleti adatait, és időben értesülhet arról, hogy a jelentett értékek túllépik a várt küszöbértékeket. Amikor ütemez egy riasztást, a társított lekérdezés lefut, és a rendszer ellenőrzi a riasztási feltételeket, függetlenül az alapul szolgáló lekérdezés meglévő ütemezésétől. Emellett hozzáférhet egy riasztási előzményhez a korábbi riasztási értékelések eredményeinek áttekintéséhez.

Ha meg szeretné tudni, hogyan használhatja inkább az örökölt riasztásokat, olvassa el a Mik azok az örökölt riasztások? című témakört.

Riasztások engedélyezése a munkaterületen

A munkaterület rendszergazdái az Előnézetek lapon szabályozhatják a munkaterület hozzáférését ehhez az előnézethez. Az előzetes verzió engedélyezése nem befolyásolja a meglévő riasztásokat; ezeket és az örökölt riasztásokat is használhatja párhuzamosan.

Riasztások megtekintése és rendszerezése

A riasztások listaoldalának megnyitásához kattintson az oldalsávban található Alerts.

• A Riasztások lap alapértelmezés szerint meg van nyitva, és megjeleníti a munkaterület összes riasztását. A név alapján történő szűréshez beírhatja a kívánt nevet. A Csak a saját riasztások elemre kattintva csak a tulajdonosként megadott riasztásokat jelenítheti meg.

• Az Örökölt riasztások lap az előző riasztási rendszer használatával létrehozott riasztásokat jeleníti meg.

• Az egyes riasztások neve a Név oszlopban olvasható.

• Az állapot azt mutatja, hogy a riasztás állapota TRIGGERED, OKvagy ERROR.

• Az ütemezés az utolsó frissített időpontot vagy dátumot jeleníti meg.

• A tulajdonos megjeleníti annak a személynek a felhasználónevét, aki a riasztás tulajdonosa.

• A riasztás létrehozásának dátumát és időpontját jeleníti meg.

  • TRIGGERED Azt jelenti, hogy a legutóbbi végrehajtás során a cél lekérdezés Érték oszlopa megfelelt a konfigurált feltételnek és küszöbértéknek . Ha a riasztás ellenőrzi, hogy a "macskák" 1500 felett van-e, a riasztás mindaddig aktiválódik, amíg a "macskák" érték meghaladja az 1500-as értéket.
  • OK Azt jelenti, hogy a legutóbbi lekérdezés végrehajtása során az Érték oszlop nem felelt meg a konfigurált feltételnek és küszöbértéknek . Ez nem jelenti azt, hogy a riasztás korábban nem aktiválódott. Ha a "macskák" értéke most 1470, a riasztás a következőképpen jelenik meg: OK.
  • ERROR azt jelzi, hogy hiba történt a riasztás kiértékelése során.

Riasztás létrehozása

Az ebben a szakaszban ismertetett lépések végigvezetik az alábbi képen látható riasztás létrehozásának módján. A címkék és magyarázatok segítségével megismerheti az egyes összetevőket.

1. Lekérdezésszerkesztő: Írja meg és tesztelje a riasztáshoz használni kívánt lekérdezést.

2. Menetrend: Állítson be rendszeres ütemezést a riasztás futtatásához.

3. Feltétel: Válassza ki azt az értékküszöböt, amely riasztásértesítést indít el. A lekérdezés futtatásával tesztelheti a feltételt ebből a szakaszból.

4. Értesítések: Adja meg, hogy mely felhasználókat vagy értesítési célhelyeket kell értesíteni, ha a küszöbérték túllépi a várt tartományt.

5. Haladó: Speciális beállítások használatával riasztást jeleníthet meg a speciális értékekről és feltételekről.

Fontos

A nyilvános előzetes verzió időszakában a riasztások nem támogatják a paraméterekkel rendelkező lekérdezéseket. Lásd : Mik azok az örökölt riasztások?.

A következő lépésekkel hozhat létre riasztást:

1. Kattintson a ikonriasztásokra az oldalsávon, és kattintson a Riasztás létrehozása parancsra.

2. Másolja és illessze be a következő lekérdezést a lekérdezésszerkesztőbe. Kattintson a Összes futtatása (1000) gombra. Ha többet szeretne megtudni az SQL-szerkesztővel való munkáról, olvassa el a Lekérdezések írása és az adatok feltárása az új SQL-szerkesztőben című témakört.

   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. A Feltétel mezőben adja meg a riasztást aktiváló feltételeket.

   

   Alkalmazza a következő beállításokat az ábrán látható módon:

   • Válassza az Összeg lehetőséget az ellenőrizni kívánt adatértékként. A riasztási feltételek beállíthatók egy oszlop első értékére a lekérdezés eredményében, vagy beállíthatja az összesítést egyetlen oszlop összes sorában, például SZUM vagy ÁTLAG.
   • Jelölje ki az összeget az ellenőrizni kívánt oszlopként.
   • Válassza ki > (nagyobb, mint) logikai operátorként.
   • Állítsa a küszöbértéket 4000 értékre Static value . A statikus érték alapértelmezés szerint ki van jelölve. Írja be a 4000 értéket az értékmezőbe.

4. A Tesztfeltétel elemre kattintva megtekintheti a riasztás előnézetét, és tesztelheti, hogy a riasztás aktiválódik-e az aktuális adatokkal. A megadott beállításoknak aktiválnia kell a riasztást. A küszöbértéket a további teszteléshez módosíthatja.

5. Az Értesítések szakaszban keresse meg a felhasználónevet, és kattintson rá, amikor megjelenik.

6. Kattintson a A naptár ikonra kattintva nyissa meg az Ütemezés szerkesztése párbeszédpanelt. A legördülő menükkel beállíthatja a riasztást, hogy 5 percenként fusson az óra 0 percétől kezdve. Kattintson a Mentés lehetőségre. Ha szeretné, jelölje be a Cron szintaxis megjelenítése jelölőnégyzetet az ütemezés szerkesztéséhez Quartz Cron Szintaxis.

7. Kattintson a Riasztás megtekintése gombra.

A riasztás mentésre került, és a megadott ütemezés szerint fut. Az ebben a példában használt adatok statikusak, ezért ha a tesztfeltételaktiváltként jelenik meg, akkor a következő futtatáskor újra megjelennek. Riasztásként e-mail-értesítést kap. Ha a tesztfeltételrendben van, a rendszer nem küld értesítést.

Riasztás részleteinek áttekintése

Megnyílik egy oldal a riasztás részleteinek megjelenítéséhez. Emellett megjelenik egy riasztási előzmény a kiértékelési előzmények részleteivel. A Futtatás gombra kattintva azonnal futtathatja a riasztási lekérdezést, és visszaadhatja az eredményt ezen a képernyőn.

A riasztás szerkesztésének folytatásához kattintson a lap jobb felső sarkában található Szerkesztés gombra.

Speciális beállítások

A Speciális beállítások elemre kattintva alkalmazza a következő beállításokat:

• Értesítés küldése siker esetén: Értesítés küldése, ha a riasztás így tér vissza: OK.
• Értesítés gyakorisága: Rendszeresen küldjön értesítéseket egy riasztásról, amíg az állapot vissza nem tér OK.
• Üres eredményállapot: Állítson be egy speciális állapotot, amely akkor ad vissza, ha a lekérdezés nem ad vissza eredményt.
• Sablon: Dönthet úgy, hogy az alapértelmezett sablonnal vagy egyéni sablonnal küld értesítéseket. Az alábbi lista ismerteti az egyes sablontípusokat:
  • Alapértelmezett sablon használata: A riasztási értesítés egy üzenet, amely a Riasztás konfigurációs képernyőjére és a Lekérdezés képernyőre mutató hivatkozásokat tartalmaz.
  • Egyéni sablon használata: A riasztási értesítés pontosabb információkat tartalmaz a riasztásról.

    1. Megjelenik egy mező, amely a tárgy és a törzs beviteli mezőiből áll. Bármely statikus tartalom érvényes, és beépített sablonváltozókat is beépíthet:

       • ALERT_STATUS: A kiértékelt riasztás állapota (sztring).
       • ALERT_CONDITION: A riasztási feltétel operátora (sztring).
       • ALERT_THRESHOLD: A riasztás küszöbértéke (sztring vagy szám).
       • ALERT_COLUMN: A riasztási oszlop neve (karakterlánc).
       • ALERT_NAME: A riasztás neve (sztring).
       • ALERT_URL: A riasztási oldal URL-címe (sztring).
       • QUERY_RESULT_TABLE: A lekérdezés eredménye HTML-tábla (sztring). Az eredmények az első 100 sorra korlátozódnak. Csak az e-mail-értesítések célhelyei jeleníthetnek meg HTML-t.
       • QUERY_RESULT_VALUE: A lekérdezés eredményének értéke (sztring vagy szám).
       • QUERY_RESULT_ROWS: A lekérdezés eredménysorai (értéktömb).
       • QUERY_RESULT_COLS: A lekérdezés eredményoszlopai (sztringtömb).

       Példa tárgya például a következő lehet: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

    2. A HTML használatával formázhatja az üzeneteket egy egyéni sablonban. Csak az e-mail-értesítések célhelyei jeleníthetnek meg HTML-t. A sablonokban a következő címkék és attribútumok engedélyezettek:

       • Engedélyezett címkék: <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>

       • Engedélyezett attribútumok:

         Attribútum	Támogatott címkék
         href	<a>
         title	<img>
         target	<a>
         alt	<img>
         src	<img>
         start	<b>, <blockquote>, <code>, <del><em>, <hr>, <i>, , <pre><u>

    3. Kattintson az Előnézet váltógombra a renderelt eredmény előnézetének megtekintéséhez.

       Fontos

       Az előzetes verzió hasznos annak ellenőrzéséhez, hogy a sablonváltozók megfelelően vannak-e renderelve. Ez nem a végleges értesítési tartalom pontos ábrázolása, mivel minden értesítési cél eltérően jelenítheti meg az értesítéseket.

A munkaterület rendszergazdái új értesítési célhelyeket állíthatnak be. Lásd: Értesítési célhelyek kezelése.

Riasztások összesítése

A riasztások összesítése a riasztáshoz csatolt Databricks SQL-lekérdezés eredeti SQL-jének módosításával működik. A riasztás egy közös táblakifejezésben (CTE) körbefuttatja az eredeti lekérdezés szövegét, és egy sortöréses összesítő lekérdezést hajt végre rajta a lekérdezés eredményének összesítéséhez.

Például egy SUM lekérdezéshez csatolt, szöveggel SELECT 1 AS column_name ellátott riasztás összesítése azt jelenti, hogy a riasztás frissítésekor a futtatott módosított SQL a következő lesz: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q.

Ez azt jelenti, hogy az eredeti lekérdezési eredmény (előre összesítve) nem jeleníthető meg egy riasztás egyéni törzsében (olyan paraméterekkel, mint a QUERY_RESULT_ROWS és a QUERY_RESULT_COLS), amikor egy riasztás összesítése történik. Ehelyett ezek a változók csak a végső, összesítés utáni lekérdezés eredményét jelenítik meg.

Riasztás több oszlop esetén

Ha egy lekérdezés több oszlopa alapján szeretne riasztást beállítani, a lekérdezés megvalósíthatja a riasztási logikát, és visszaadhat egy logikai értéket, ami a riasztást kiváltja. Példa:

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

Ez a lekérdezés akkor ad 1 vissza, ha drafts_count > 10000 and archived_count > 5000. Ezután konfigurálhatja a riasztást úgy, hogy aktiválja az értéket 1.

Riasztás a metrika nézetekhez

Mivel a metrikanézetek az alapvető üzleti metrikák nyomon követésére és mérésére szolgálnak, jól párosíthatók a riasztásokkal, így automatikusan értesítést kaphat, ha egy metrika a várt tartományon kívül esik. A metrikák nézeteire vonatkozó riasztások ugyanúgy működnek, mint bármely más adathalmazra vonatkozó riasztások. Amikor a lekérdezést a lekérdezés konfigurálásához írja, használja a figyelni kívánt metrikanézet teljes nevét.

A Git-integráció működése riasztásokkal

A Databricks Git-mappákkal nyomon követheti és kezelheti a riasztások módosításait. A riasztások Gittel való nyomon követéséhez helyezze őket egy Databricks Git mappába. Az újonnan klónozott riasztások csak akkor jelennek meg a riasztások listaoldalán vagy API-jában, ha egy felhasználó interakcióba lép velük. Az ütemezéseket szüneteltették, és a felhasználóknak kifejezetten újraindítaniuk kell őket.

A Databricks Git-mappák központosított módot biztosítanak a riasztások és más munkaterület-objektumok általános Git-műveleteinek kezelésére. További információért lásd: Azure Databricks Git-mappák.

Különbségek az örökölt riasztásoktól

A Databricks SQL-riasztások legújabb verziója néhány kulcsfontosságú módon másképp viselkedik, mint az örökölt riasztások:

• Feladatok integrációja: A legújabb verzió még nem támogatja a riasztásokra való közvetlen hivatkozásokat a Feladatok folyamatban. Ez a funkció hamarosan elérhető lesz. Az örökölt riasztások támogatják a "Riasztási feladattípus" funkciót a feladatok részeként.
• Lekérdezések újrafelhasználása: Egy meglévő mentett SQL-lekérdezés nem használható újra riasztás létrehozásakor. Minden riasztás rendelkezik a lekérdezésdefiníciójával, amely közvetlenül az új riasztásszerkesztőben hozható létre.
• Riasztási állapotértékek: A riasztási állapotok egyszerűbbek, és a riasztások már nem támogatják az UNKNOWN örökölt riasztások állapotát. A kiértékelések az egyikre oldódnak fel: OK, TRIGGERED, vagy ERROR.

Átmenet során továbbra is használhatja a legújabb és az örökölt riasztásokat egymás mellett.

Riasztási engedélyek konfigurálása és a riasztás tulajdonjogának átadása

A riasztási jogosultsági szintekről a Riasztások ACL-jei című témakörben olvashat.

1. Az oldalsávon kattintson a Riasztások elemre.

2. Kattintson egy riasztásra.

3. Kattintson a Megosztás gombra a riasztás részletei lap jobb felső sarkában a Megosztás párbeszédpanel megnyitásához.

   

4. Keresse meg és jelölje ki a csoportokat és a felhasználókat, és rendelje hozzá az engedélyszintet.

5. Kattintson a Hozzáadás gombra.

Riasztás tulajdonjogának átadása

A riasztások mentésekor ön lesz a riasztás tulajdonosa. Ha egy riasztás tulajdonosa el lett távolítva egy munkaterületről, a riasztásnak már nincs tulajdonosa. A munkaterület-rendszergazdai felhasználók átadhatják a riasztások tulajdonjogát egy másik felhasználónak. A tulajdonjogot az Engedélyek API-val is átadhatja.

1. Munkaterület-rendszergazdaként jelentkezzen be az Azure Databricks-munkaterületre.

2. Az oldalsávon kattintson a Riasztások elemre.

3. Kattintson egy riasztásra.

4. A Megosztás párbeszédpanel megnyitásához kattintson a jobb felső sarokban található Megosztás gombra.

5. Kattintson a fogaskerék ikonra a jobb felső sarokban, és kattintson az Új tulajdonos hozzárendelése parancsra.

   

6. Válassza ki azt a felhasználót, akihez tulajdonost szeretne hozzárendelni.

7. Kattintson a Megerősítés gombra.