Wat zijn Databricks SQL-waarschuwingen?

Artikel
01/09/2025

Databricks SQL-waarschuwingen voeren periodiek query's uit, evalueren gedefinieerde voorwaarden en meldingen verzenden als aan een voorwaarde wordt voldaan. U kunt waarschuwingen set 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 de standaardwaarde gebruiken 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 het werkruimte in de zijbalk om waarschuwingen weer te geven in de map Start, where deze standaard zijn 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 list wijzigen door op de column koppen 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 where 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 waarde column in uw doelquery voldoet aan de voorwaarde en drempelwaarde 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 queryuitvoering de waarde column niet voldoet aan de voorwaarde en drempelwaarde 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. U ziet deze status ook als er geen gegevens in het queryresultaat staan of als het meest recente queryresultaat niet de waarde bevat Column die u hebt geconfigureerd.

Een waarschuwing maken

Volg deze stappen om een waarschuwing te maken voor een enkele column van een query.

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

Om op meerdere columns's te waarschuwen, moet u de query wijzigen. Zie Waarschuwingsaggregaties.
Configureer de waarschuwing in het veld Voorwaarde activeren.
- De Waarde column vervolgkeuzelijst bepaalt welk veld van het zoekopdrachtresultaat wordt geëvalueerd. Waarschuwingscondities kunnen worden set op de eerste waarde van een column in het queryresultaat, of u kunt ervoor kiezen om een aggregatie zoals SOM of GEMIDDELDE over alle rijen van één columnte set.
- De vervolgkeuzelijst Operator bepaalt de logische bewerking die moet worden toegepast.
- De drempelwaarde tekstinvoer wordt vergeleken met de waarde column 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.
In het Wanneer waarschuwing is geactiveerd, melding verzenden veld, geef aan select 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 naam van de waarschuwing column (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: Het queryresultaat HTML table (tekenreeks). De resultaten zijn beperkt tot de eerste 100 rijen.
    - QUERY_RESULT_VALUE: De queryresultaatwaarde (tekenreeks of getal).
    - QUERY_RESULT_ROWS: De rijen met queryresultaten (waardematrix).
    - QUERY_RESULT_COLS: het queryresultaat columns (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>, <h2><h3><h4><h5><h6><head><hr><html><i><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. U kunt desgewenst het selectievakje Cron-syntaxis weergeven selectievakje select om de planning te bewerken in Kwarts cron syntaxis.
- 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 de geplande query in een ander magazijn uit te voeren met select.
Klik op het tabblad Bestemmingen in het dialoogvenster Planning toevoegen.
- Gebruik de vervolgkeuzelijst om een beschikbare meldingsbestemming te select. 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 rechts van de vermelde planning het kebabmenu en selectmachtigingen 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, update de abonnee list, en om de planning te pauzeren of te hervatten.
  - IS EIGENAAR: verleent alle machtigingen van CAN MANAGE. Daarnaast wordt de credentials 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. Grant toegang tot gebruikers en groepen in de meldingenbestemmingen list 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, update de meldingsbestemming listen 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 table-expressie (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 SUM betekent bijvoorbeeld SELECT 1 AS column_name 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 waarschuwingstekst (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 bij meerdere columns

Als u een waarschuwing wilt set op basis van meerdere columns van een query, kan uw query de waarschuwingslogica implementeren en een booleaanse waarde teruggeven 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 where 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 table. 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 wordt set naar Just Once, verzendt Databricks SQL een melding op woensdag wanneer de status is gewijzigd van OK naar TRIGGERED en opnieuw op zondag wanneer deze wordt teruggeschakeld. 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 naar en select 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.
Select de gebruiker aan wie het eigendom toegewezen moet worden.
Klik op Bevestigen.

Delen via