Een waarschuwing maken

Deze pagina leidt u door het maken van een Databricks SQL-waarschuwing van begin tot eind. Het behandelt de waarschuwingseditor, de zelfstudie voor het maken van waarschuwingen, het controleren van evaluatiedetails en de geavanceerde instellingen en meldingssjablonen die u kunt configureren.

De waarschuwingseditor verkennen

De stappen in deze sectie helpen u bij het maken van de waarschuwing die wordt weergegeven in de volgende afbeelding. Gebruik de labels en uitleg om elk onderdeel te begrijpen.

1. Query-editor: schrijf en test de query waarop u een waarschuwing wilt toepassen.
2. Compute: Kies het SQL-warehouse waarop de waarschuwingsquery wordt uitgevoerd. De statusindicator geeft aan of het geselecteerde magazijn actief is. Zie Een SQL-warehouse kiezen voor een waarschuwing voor aanbevelingen voor de grootte van een warehouse en het gedrag bij uitvoering op geplande tijdstippen.
3. Planning: stel een periodiek schema in voor de waarschuwing die moet worden uitgevoerd.
4. Delen: Stel machtigingen in waarmee wordt gedefinieerd hoe anderen in uw werkruimte met uw waarschuwing kunnen werken.
5. Voorwaarde: Selecteer de waardedrempel die een waarschuwingsmelding moet activeren. U kunt de query uitvoeren om de voorwaarde in deze sectie te testen.
6. Meldingen: Geef aan welke gebruikers of meldingsbestemmingen moeten worden gewaarschuwd wanneer de drempelwaarde buiten het verwachte bereik valt. U kunt desgewenst een meldingsfrequentie instellen om meldingen te herhalen totdat de waarschuwing terugkeert naar OK.
7. Geavanceerd: Gebruik geavanceerde instellingen om waarschuwingen te geven over speciale waarden en voorwaarden.

Een waarschuwing maken

Gebruik de volgende stappen om een waarschuwing te maken:

1. Klik op in de zijbalk en klik op Waarschuwing maken.

2. Kopieer en plak de volgende query in de queryeditor. Klik op Alles uitvoeren (1000). Zie Query's schrijven en gegevens verkennen in de nieuwe SQL-editor voor meer informatie over het werken met de SQL-editor.

   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. Klik op de rekenkiezer en klik vervolgens op een magazijn in de lijst om op te geven welke rekenresource de waarschuwing uitvoert.

   

4. Stel in het veld Voorwaarde de voorwaarden in die de waarschuwing moeten activeren.

   

   Pas de volgende instellingen toe zoals wordt weergegeven:

   • Selecteer Som als de gegevenswaarde die u wilt controleren. U kunt een waarschuwingsvoorwaarde instellen 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.
   • Selecteer het bedrag als de kolom die u wilt controleren.
   • Selecteer > (groter dan) als de logische operator die u wilt toepassen.
   • Stel de drempelwaarde in op Static value 4000. Statische waarde is standaard geselecteerd. Voer 4000 in het waardeveld in.

5. Klik op Testvoorwaarde om een voorbeeld van de waarschuwing te bekijken en te testen of de waarschuwing wordt geactiveerd met de huidige gegevens. De opgegeven instellingen moeten de waarschuwing activeren. U kunt de drempelwaarde wijzigen om verder te testen.

6. Zoek in de sectie Meldingen naar uw gebruikersnaam en klik erop wanneer deze wordt weergegeven.

7. Klik op Het agendapictogram om het dialoogvenster Planning bewerken te openen. Gebruik de vervolgkeuzelijsten om de melding in te stellen, zodat deze elke 5minuten actief is vanaf 0 minuten over het uur. Klik op Opslaan. Schakel desgewenst het selectievakje 'Cron-syntaxis weergeven' in om de planning te bewerken in Quartz Cron-syntaxis.

8. Klik op Waarschuwing weergeven.

Uw waarschuwing wordt opgeslagen en uitgevoerd volgens het schema dat u hebt opgegeven. De gegevens die in dit voorbeeld worden gebruikt, zijn statisch, dus als uw testvoorwaarde wordt geretourneerd als geactiveerd, wordt deze opnieuw geactiveerd wanneer deze de volgende keer wordt uitgevoerd. U ontvangt een e-mailmelding als waarschuwing. Als de testvoorwaardeOK retourneert, wordt er geen melding verzonden.

Waarschuwingsdetails bekijken

Er wordt een pagina geopend om uw waarschuwingsgegevens weer te geven. Op de pagina wordt ook een waarschuwingsgeschiedenis met evaluatiedetails weergegeven. Klik op de knop Nu uitvoeren om de waarschuwingsquery direct uit te voeren en het resultaat op deze pagina te retourneren.

Klik op Bewerken in de rechterbovenhoek van de pagina om door te gaan met het bewerken van de waarschuwing.

Geavanceerde instellingen

Klik op Geavanceerde instellingen om de volgende instellingen toe te passen:

• Melden bij OK: Stuur een melding wanneer de waarschuwing weer de status OK krijgt.
• Status voor leeg resultaat: stel een speciale status in die wordt geretourneerd wanneer de query geen resultaten oplevert.
• Sjabloon: Configureer de meldingssjabloon. Zie Meldingssjablonen.

Werkruimtebeheerders kunnen nieuwe meldingsbestemmingen instellen. Zie Meldingsbestemmingen beheren.

Meldingssjablonen

Meldingen gebruiken de standaardsjabloon, tenzij u ze aanpast. Als u het onderwerp en de hoofdtekst wilt aanpassen, selecteert u Sjabloon aanpassen. Er zijn twee editors beschikbaar: de standaardeditor en de Markdown-editor. Klik op de onderstaande tabbladen om ze te vergelijken.

Standaardeditor

In de standaardeditor verwijzen we naar variabelen in het onderwerp en de hoofdtekst met {{VARIABLE_NAME}}. De volgende variabelen worden ondersteund:

• ALERT_STATUS: de geëvalueerde waarschuwingsstatus (tekenreeks).
• ALERT_CONDITION: De operator voor de waarschuwingsconditie (tekenreeks).
• ALERT_THRESHOLD: de waarschuwingsdrempel (tekenreeks of getal).
• ALERT_COLUMN: De naam van de kolom voor waarschuwingen (tekenreeks).
• ALERT_NAME: de naam van de waarschuwing (tekenreeks).
• ALERT_URL: de URL van de waarschuwingspagina (tekenreeks).
• QUERY_RESULT_TABLE: de HTML-tabel (tekenreeks) van het queryresultaat. De resultaten zijn beperkt tot de eerste 100 rijen. Alleen bestemmingen voor e-mailmeldingen kunnen HTML weergeven.
• QUERY_RESULT_VALUE: De queryresultaatwaarde (tekenreeks of getal).
• QUERY_RESULT_ROWS: De rijen met queryresultaten (waardematrix).
• QUERY_RESULT_COLS: de kolommen met queryresultaten (tekenreeksmatrix).

Bijvoorbeeld: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

De standaardeditor ondersteunt ook HTML voor opmaak. Alleen bestemmingen voor e-mailmeldingen kunnen HTML weergeven. De volgende HTML-tags zijn toegestaan: <a>, <b>, <blockquote>, <br>, <code>, <del>, <div>, <em>, <h1>, <h2>, <h3>, <h4>, <h5>, <h6>, <hr>, <i>, <img>, <li>, <ol>, <p>, <pre>, <span>, <table>, <thead>, <tbody>, <td>, <th>, <tr>, <u>, <ul>.

De volgende kenmerken zijn toegestaan voor de vermelde tags:

Klik op de wisselknop Voorbeeld om een voorbeeld van het weergegeven resultaat te bekijken.

Markdown-editor

Schakel Markdown Editor in om de hoofdtekst te schrijven met markdown. De Markdown-editor heeft een opmaakwerkbalk en een weergegeven voorbeeld.

Verwijs in de Markdown-editor naar variabelen met @VARIABLE_NAME. Typ @ in de hoofdtekst om de variabelenkiezer te openen. De Markdown-editor ondersteunt ALERT_NAME, , ALERT_STATUSALERT_CONDITION, ALERT_THRESHOLD, , ALERT_COLUMNen ALERT_URLQUERY_RESULT_TABLE.