Wat zijn Databricks SQL-waarschuwingen?

Artikel
05/03/2024

Databricks SQL-waarschuwingen voeren periodiek query's uit, evalueren gedefinieerde voorwaarden en meldingen verzenden als aan een voorwaarde wordt voldaan. U kunt waarschuwingen instellen om uw bedrijf te bewaken en meldingen te verzenden wanneer gerapporteerde gegevens buiten de verwachte limieten vallen. Als u een waarschuwing plant, wordt de onderliggende query uitgevoerd en worden de waarschuwingscriteria gecontroleerd. Dit is onafhankelijk van een schema dat kan bestaan in de onderliggende query.

Belangrijk

Waarschuwingen die gebruikmaken van query's met parameters gebruiken de standaardwaarde die is opgegeven in de SQL-editor voor elke parameter.

Waarschuwingen weergeven en organiseren

Gebruik een van de volgende opties voor toegang tot waarschuwingen:

Klik op de werkruimte in de zijbalk om waarschuwingen weer te geven in de map Start , waar ze standaard worden opgeslagen. Gebruikers kunnen waarschuwingen organiseren in mappen in de werkruimtebrowser, samen met andere Databricks-objecten.
Klik op de waarschuwingen in de zijbalk om de pagina met waarschuwingen weer te geven.

Objecten worden standaard in omgekeerde chronologische volgorde gesorteerd. U kunt de volgorde van de lijst wijzigen door op de kolomkoppen te klikken. Klik op het tabblad Alle waarschuwingen boven aan het scherm om alle waarschuwingen in de werkruimte weer te geven. Klik op het tabblad Mijn waarschuwingen om waarschuwingen weer te geven waar u de eigenaar bent.

In de kolom Naam wordt de naam van de waarschuwing weergegeven als een tekenreeks.
In de kolom Status wordt de status van de waarschuwing vermeld: TRIGGERED, OKof UNKNOWN.
Laatst bijgewerkt toont de laatst bijgewerkte tijd of datum.
Gemaakt op de datum en tijd waarop de waarschuwing is gemaakt.
- TRIGGERED betekent dat bij de meest recente uitvoering de kolom Value in de doelquery heeft voldaan aan de voorwaarde (Condition) en drempel (Threshold) die u hebt geconfigureerd. Als uw waarschuwing controleert of 'katten' hoger is dan 1500, wordt de waarschuwing geactiveerd wanneer 'katten' hoger is dan 1500.
- OK betekent dat bij de meest recente uitvoering van de query de kolom Value niet heeft voldaan aan de voorwaarde (Condition) en drempel (Threshold) die u hebt geconfigureerd. Dit betekent niet dat de waarschuwing niet eerder is geactiveerd. Als de waarde 'katten' nu 1470 is, wordt uw waarschuwing weergegeven als OK.
- UNKNOWN betekent dat Databricks SQL niet voldoende gegevens heeft om de waarschuwingscriteria te evalueren. U ziet deze status direct nadat u de waarschuwing hebt gemaakt en totdat de query is uitgevoerd. Deze status wordt ook weergegeven als het queryresultaat geen gegevens bevat of als het meest recente queryresultaat niet de kolom Value bevat die u hebt geconfigureerd.

Een waarschuwing maken

Volg deze stappen om een waarschuwing te maken voor één kolom van een query.

Voer een van de volgende stappen uit:
- Klik op Nieuw in de zijbalk en selecteer Waarschuwing.
- Klik op Waarschuwingen in de zijbalk en klik op de knop + Nieuwe waarschuwing.
- Klik op Werkruimte in de zijbalk en klik op + Waarschuwing maken.
- Klik ophetmenu in de rechterbovenhoek van een opgeslagen query en klik op + Waarschuwing maken.
Zoek in het veld Query naar een doelquery.

Als u meerdere kolommen wilt waarschuwen, moet u uw query wijzigen. Zie Waarschuwingsaggregaties.
Configureer de waarschuwing in het veld Voorwaarde activeren.
- De vervolgkeuzelijst Waardekolom bepaalt welk veld van het queryresultaat wordt geëvalueerd. Waarschuwingsvoorwaarden kunnen worden ingesteld op de eerste waarde van een kolom in het queryresultaat, of u kunt ervoor kiezen om een aggregatie in te stellen voor alle rijen van één kolom, zoals SOM of GEMIDDELDE.
- De vervolgkeuzelijst Operator bepaalt de logische bewerking die moet worden toegepast.
- De tekstinvoer drempelwaarde wordt vergeleken met de kolom Waarde met behulp van de voorwaarde die u opgeeft.
Klik op Preview-waarschuwing om een voorbeeld van de waarschuwing te bekijken en te testen of de waarschuwing wordt geactiveerd met de huidige gegevens.
Selecteer in het veld Wanneer de waarschuwing wordt geactiveerd het meldingsveld verzenden hoeveel meldingen worden verzonden wanneer uw waarschuwing wordt geactiveerd:
- Slechts één keer: een melding verzenden wanneer de waarschuwingsstatus verandert van OK in TRIGGERED.
- Telkens wanneer een waarschuwing wordt geëvalueerd: een melding verzenden wanneer de waarschuwingsstatus TRIGGERED ongeacht de status van de vorige evaluatie is.
- Maximaal elk: een melding verzenden wanneer de waarschuwingsstatus een specifiek interval heeft TRIGGERED . Met deze keuze kunt u spammeldingen voorkomen voor waarschuwingen die vaak worden geactiveerd.
Ongeacht welke meldingsinstelling u kiest, ontvangt u een melding wanneer de status van OK of TRIGGEREDTRIGGERED naar .OK De planningsinstellingen zijn van invloed op het aantal meldingen dat u ontvangt als de status van de ene uitvoering naar de volgende blijft TRIGGERED . Zie Meldingsfrequentie voor meer informatie.
Kies een sjabloon in de vervolgkeuzelijst Sjabloon :
- Standaardsjabloon gebruiken: Waarschuwingsmelding is een bericht met koppelingen naar het scherm Waarschuwingsconfiguratie en het queryscherm.
- Aangepaste sjabloon gebruiken: waarschuwingsmelding bevat meer specifieke informatie over de waarschuwing.
  1. Een vak wordt weergegeven, bestaande uit invoervelden voor onderwerp en hoofdtekst. Elke statische inhoud is geldig en u kunt ingebouwde sjabloonvariabelen opnemen:
    - ALERT_STATUS: de geëvalueerde waarschuwingsstatus (tekenreeks).
    - ALERT_CONDITION: de operator voor waarschuwingsvoorwaarde (tekenreeks).
    - ALERT_THRESHOLD: de waarschuwingsdrempel (tekenreeks of getal).
    - ALERT_COLUMN: de kolomnaam van de waarschuwing (tekenreeks).
    - ALERT_NAME: de naam van de waarschuwing (tekenreeks).
    - ALERT_URL: de URL van de waarschuwingspagina (tekenreeks).
    - QUERY_NAME: de naam van de gekoppelde query (tekenreeks).
    - QUERY_URL: De url van de gekoppelde querypagina (tekenreeks).
    - QUERY_RESULT_TABLE: De HTML-tabel (tekenreeks) van het queryresultaat.
    - QUERY_RESULT_VALUE: De queryresultaatwaarde (tekenreeks of getal).
    - QUERY_RESULT_ROWS: De rijen met queryresultaten (waardematrix).
    - QUERY_RESULT_COLS: De kolommen met queryresultaten (tekenreeksmatrix).
    Een voorbeeldonderwerp kan bijvoorbeeld zijn: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.
  2. U kunt HTML gebruiken om berichten in een aangepaste sjabloon op te maken. De volgende tags en kenmerken zijn toegestaan in sjablonen:
    - Tags: <a>, <abbr>, <acronym>, <b>, , <blockquote>, <body>, <br>, <code>, <div>, <em>, <h1>, <h3><i><h2><h4><h5><h6><head><hr><html><li><ol><p><span><strong><table><tbody><td><th><tr><ul>
    - Kenmerken: href (voor <a>), titel (voor <a>, <abbr>, <acronym>)
  3. Klik op de wisselknop Voorbeeld om een voorbeeld van het weergegeven resultaat te bekijken.
    
    Belangrijk
    
    Het voorbeeld is handig om te controleren of sjabloonvariabelen correct worden weergegeven. Het is geen nauwkeurige weergave van de uiteindelijke inhoud van meldingen, omdat elke meldingsbestemming meldingen anders kan weergeven.
  4. Klik op de knop Wijzigingen opslaan .
Klik op Waarschuwing maken.
Klik op Planning toevoegen.
- Gebruik de vervolgkeuzelijstkiezers om de frequentie, periode, begintijd en tijdzone op te geven. Schakel desgewenst het selectievakje Cron-syntaxis weergeven in om het schema in Kwarts Cron-syntaxis te bewerken.
- Kies Meer opties om optionele instellingen weer te geven. U kunt ook het volgende kiezen:
  - Een naam voor de planning.
  - Een SQL-warehouse om de query uit te voeren. Standaard wordt het SQL-warehouse dat wordt gebruikt voor ad-hocquery-uitvoering ook gebruikt voor een geplande taak. Gebruik deze optionele instelling om een ander magazijn te selecteren om de geplande query uit te voeren.
Klik op het tabblad Bestemmingen in het dialoogvenster Planning toevoegen.
- Gebruik de vervolgkeuzelijst om een beschikbare meldingsbestemming te selecteren. U kunt ook een gebruikersnaam typen om personen toe te voegen.
Belangrijk

Als u deze stap overslaat, ontvangt u geen melding wanneer de waarschuwing wordt geactiveerd.
Klik op Create. De opgeslagen waarschuwings- en meldingsgegevens worden weergegeven op het scherm.
Deel het schema.
- Kies aan de rechterkant van de vermelde planning het resourcemenu en selecteer Machtigingen voor planning bewerken.
- Kies een gebruiker of groep in de vervolgkeuzelijst in het dialoogvenster.
- Kies uit de volgende planningsmachtigingen:
  - GEEN MACHTIGINGEN: er zijn geen machtigingen verleend. Gebruikers zonder machtigingen kunnen niet zien dat het schema bestaat, zelfs als ze abonnees zijn of zijn opgenomen in vermelde meldingsbestemmingen.
  - KAN WEERGEVEN: verleent toestemming om geplande uitvoeringsresultaten weer te geven.
  - KAN UITVOEREN BEHEREN: verleent toestemming om geplande uitvoeringsresultaten weer te geven.
  - KAN BEHEREN: verleent machtigingen voor het weergeven, wijzigen en verwijderen van schema's. Deze machtiging is vereist om wijzigingen aan te brengen in het uitvoeringsinterval, de lijst met abonnees bij te werken en de planning te onderbreken of op te heffen.
  - IS EIGENAAR: verleent alle machtigingen van CAN MANAGE. Daarnaast worden de referenties van de eigenaar van de planning gebruikt om dashboardquery's uit te voeren. Alleen een werkruimtebeheerder kan de eigenaar wijzigen.
Belangrijk

Machtigingen voor waarschuwingen en planningen zijn gescheiden. Verwijs gebruikers en groepen in de lijst met meldingen naar bestemmingen, zodat ze de geplande uitvoeringsresultaten kunnen bekijken.
Deel de waarschuwing.
- Klik rechtsboven op de pagina.
- Voeg gebruikers of groepen toe die toegang moeten hebben tot de waarschuwing.
- Kies het juiste machtigingsniveau en klik vervolgens op Toevoegen.

Belangrijk

CAN MANAGE verleent machtigingen voor het weergeven, wijzigen en verwijderen van schema's. Deze machtiging is vereist om wijzigingen aan te brengen in het uitvoeringsinterval, de lijst met meldingsbestemmingen bij te werken en de planning te onderbreken of op te heffen.

Zie Waarschuwingen-ACL's voor meer informatie over machtigingsniveaus voor waarschuwingen.

Waarschuwingsaggregaties

Een aggregatie voor een waarschuwing werkt door de oorspronkelijke SQL-query van de Databricks SQL-query te wijzigen die is gekoppeld aan de waarschuwing. De waarschuwing verpakt de oorspronkelijke querytekst in een algemene tabelexpressie (CTE) en voert er een terugloopaggregatiequery op uit om het queryresultaat samen te voegen.

Een aggregatie van een waarschuwing die is gekoppeld aan een query met tekst SELECT 1 AS column_name betekent bijvoorbeeld SUM dat wanneer de waarschuwing wordt vernieuwd, de gewijzigde SQL die wordt uitgevoerd: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q

Dit betekent dat het oorspronkelijke queryresultaat (vooraf geaggregeerd) niet kan worden weergegeven in een aangepaste hoofdtekst van een waarschuwing (met parameters zoals QUERY_RESULT_ROWS en QUERY_RESULT_COLS) wanneer er een aggregatie voor een waarschuwing is. In plaats daarvan worden in deze variabelen alleen het uiteindelijke resultaat van de query na aggregatie weergegeven.

Notitie

Alle triggervoorwaarden met betrekking tot aggregaties worden niet ondersteund door de API.

Waarschuwing voor meerdere kolommen

Als u een waarschuwing wilt instellen op basis van meerdere kolommen van een query, kan uw query de waarschuwingslogica implementeren en een booleaanse waarde retourneren waarmee de waarschuwing wordt geactiveerd. Voorbeeld:

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

Deze query retourneert 1 wanneer drafts_count > 10000 and archived_count > 5000. Vervolgens kunt u de waarschuwing zo configureren dat deze wordt geactiveerd wanneer de waarde is 1.

Frequentie van meldingen

Databricks SQL verzendt meldingen naar de gekozen meldingsbestemmingen wanneer wordt gedetecteerd dat de waarschuwingsstatus is gewijzigd van OK of TRIGGERED omgekeerd. Bekijk dit voorbeeld waarin een waarschuwing is geconfigureerd voor een query die eenmaal per dag moet worden uitgevoerd. De dagelijkse status van de waarschuwing wordt weergegeven in de volgende tabel. Vóór maandag was OKde waarschuwingsstatus.

Dag	Waarschuwingsstatus
maandag	OK
Dinsdag	OK
woensdag	GEACTIVEERD
donderdag	GEACTIVEERD
Vrijdag	GEACTIVEERD
Zaterdag	GEACTIVEERD
Zondag	OK

Als de meldingsfrequentie is ingesteld op Just Once, verzendt Databricks SQL een melding op woensdag wanneer de status is gewijzigd van OKTRIGGERED en opnieuw op zondag wanneer deze terugschakelt. Er worden geen waarschuwingen verzonden op donderdag, vrijdag of zaterdag, tenzij u dit specifiek configureert omdat de waarschuwingsstatus op die dagen niet is gewijzigd tussen uitvoeringen.

Waarschuwingsmachtigingen configureren en het eigendom van waarschuwingen overdragen

U moet ten minste de machtiging CAN MANAGE voor een query hebben om query's te delen. Zie Waarschuwingen-ACL's voor meer informatie over machtigingsniveaus voor waarschuwingen.

Klik in de zijbalk op Waarschuwingen.
Klik op een waarschuwing.
Klik op de knop rechtsboven om het dialoogvenster Delen te openen.
Zoek en selecteer de groepen en gebruikers en wijs het machtigingsniveau toe.
Klik op Toevoegen.

Eigendom van een waarschuwing overdragen

Wanneer u een waarschuwing opslaat, wordt u de eigenaar van de waarschuwing. Als de eigenaar van een waarschuwing uit een werkruimte wordt verwijderd, heeft de waarschuwing geen eigenaar meer. Een gebruiker van een werkruimtebeheerder kan het eigendom van een waarschuwing overdragen aan een andere gebruiker. Aan service-principals en -groepen kan het eigendom van een waarschuwing niet worden toegewezen. U kunt het eigendom ook overdragen met behulp van de Machtigingen-API.

Meld u als werkruimtebeheerder aan bij uw Azure Databricks-werkruimte.
Klik in de zijbalk op Waarschuwingen.
Klik op een waarschuwing.
Klik op de knop Delen rechtsboven om het dialoogvenster Delen te openen.
Klik op het tandwielpictogram rechtsboven en klik op Nieuwe eigenaar toewijzen.
Selecteer de gebruiker waaraan u het eigendom wilt toewijzen.
Klik op Bevestigen.

Delen via