Skapa en avisering

Den här sidan beskriver hur du skapar en Databricks SQL-avisering från slutpunkt till slutpunkt. Den omfattar aviseringsredigeraren, självstudien om att skapa aviseringar, hur du granskar utvärderingsinformation och de avancerade inställningar och aviseringsmallar som du kan konfigurera.

Utforska aviseringsredigeraren

Stegen i det här avsnittet beskriver hur du skapar aviseringen som visas i följande bild. Använd etiketterna och förklaringarna för att förstå varje komponent.

1. Frågeredigeraren: Skriv och testa frågan som du vill avisera om.
2. Beräkning: Välj det SQL-lager som kör aviseringsfrågan. Statusindikatorn visar om det valda lagret är aktivt. Information om rekommendationer för dimensionering av lager och beteende vid schemalagd körning finns i Välj ett SQL-datalager för en varning.
3. Schema: Ange ett periodiskt schema för aviseringen som ska köras.
4. Dela: Ange behörigheter som definierar hur andra på din arbetsyta kan arbeta med din avisering.
5. Villkor: Välj det värdetröskelvärde som ska utlösa ett aviseringsmeddelande. Du kan köra frågan för att testa villkoret från det här avsnittet.
6. Meddelanden: Ange vilka användare eller meddelandemål som ska aviseras när tröskelvärdet ligger utanför det förväntade intervallet. Du kan också ange en meddelandefrekvens för att upprepa meddelanden tills aviseringen återgår till OK.
7. Avancerat: Använd avancerade inställningar för att avisera om särskilda värden och villkor.

Skapa en avisering

Använd följande steg för att skapa en avisering:

1. Klicka på Ikonaviseringar i sidofältet och klicka på Skapa avisering.

2. Kopiera och klistra in följande fråga i frågeredigeraren. Klicka på Kör alla (1 000). Mer information om hur du arbetar med SQL-redigeraren finns i Skriva frågor och utforska data i den nya SQL-redigeraren.

   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. Klicka på beräkningsväljaren och klicka sedan på ett lager i listan för att ange vilken beräkningsresurs som kör aviseringen.

   

4. I fältet Villkor anger du de villkor som ska utlösa aviseringen.

   

   Använd följande inställningar enligt följande:

   • Välj Summa som det datavärde som ska kontrolleras. Du kan ange ett aviseringsvillkor för det första värdet för en kolumn i frågeresultatet, eller så kan du välja att ange en aggregering över alla rader i en enda kolumn, till exempel SUM eller AVERAGE.
   • Välj belopp som den kolumn som ska kontrolleras.
   • Välj > (större än) som den logiska operator som ska tillämpas.
   • Ange tröskelvärdet till Static value 4 000. Statiskt värde är markerat som standard. Ange 4000 i värdefältet.

5. Klicka på Testvillkor för att förhandsgranska aviseringen och testa om aviseringen skulle utlösas med aktuella data. De angivna inställningarna bör utlösa aviseringen. Du kan ändra tröskelvärdet för att testa ytterligare.

6. I avsnittet Meddelanden söker du efter ditt användarnamn och klickar på det när det visas.

7. Klicka på Kalenderikonen för att öppna dialogrutan Redigera schema . Använd de nedrullningsbara menyerna för att ange aviseringen så att den körs var 5:e minut från 0 minuter efter timmen. Klicka på Spara. Du kan också markera kryssrutan Visa cron-syntax för att redigera schemat i Quartz Cron Syntax.

8. Klicka på Visa avisering.

Aviseringen sparas och körs enligt det schema som du angav. De data som används i det här exemplet är statiska, så om testvillkoret returneras som Utlöst utlöses det igen nästa gång det körs. Du får ett e-postmeddelande som en avisering. Om testvillkoret returnerade OK skickas inget meddelande.

Granska aviseringsinformation

En sida öppnas för att visa din aviseringsinformation. Sidan visar också en aviseringshistorik med utvärderingsinformation. Klicka på knappen Kör nu för att köra aviseringsfrågan omedelbart och returnera resultatet på den här sidan.

Klicka på Redigera i det övre högra hörnet på sidan för att fortsätta redigera aviseringen.

Avancerade inställningar

Klicka på Avancerade inställningar för att tillämpa följande inställningar:

• Meddela på OK: Skicka ett meddelande när aviseringen returneras som OK.
• Tomt resultattillstånd: Ange en särskild status som ska returneras när frågan inte returnerar några resultat.
• Mall: Konfigurera meddelandemallen. Se Meddelandemallar.

Arbetsyteadministratörer kan konfigurera nya meddelandemål. Se Hantera meddelandemål.

Meddelandemallar

Meddelanden använder standardmallen om du inte anpassar dem. Om du vill anpassa ämne och brödtext väljer du Anpassa mall. Det finns två redigeringsprogram: standardredigeraren och Markdown-redigeraren. Klicka på flikarna nedan för att jämföra dem.

Standardredigerare

I standardredigeraren refererar du till variabler i ämnet och brödtexten med {{VARIABLE_NAME}}. Följande variabler stöds:

• ALERT_STATUS: Utvärderad aviseringsstatus (sträng).
• ALERT_CONDITION: Operatör för aviseringsvillkor (sträng).
• ALERT_THRESHOLD: Aviseringströskelvärdet (sträng eller nummer).
• ALERT_COLUMN: Aviseringskolumnens namn (sträng).
• ALERT_NAME: Aviseringsnamnet (textsträngen).
• ALERT_URL: URL:en för aviseringssidan (sträng).
• QUERY_RESULT_TABLE: HTML-tabellen för frågeresultat (sträng). Resultaten är begränsade till de första 100 raderna. Endast mål för e-postmeddelandeaviseringar kan rendera HTML.
• QUERY_RESULT_VALUE: Frågeresultatvärdet (sträng eller tal).
• QUERY_RESULT_ROWS: Frågeresultatrader (värdematris).
• QUERY_RESULT_COLS: Frågeresultatkolumnerna (strängmatrisen).

Till exempel: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

Standardredigeraren har också stöd för HTML-formatering. Endast mål för e-postmeddelandeaviseringar kan rendera HTML. Följande HTML-taggar tillåts: <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>

Följande attribut tillåts för de listade taggarna:

Klicka på knappen Förhandsgranska för att förhandsgranska det renderade resultatet.

Markdown-redigerare

Aktivera Markdown-redigeraren för att skriva brödtexten med Markdown. Markdown-redigeraren har ett formateringsverktygsfält och en renderad förhandsgranskning.

I Markdown-redigeraren refererar du till variabler med @VARIABLE_NAME. Skriv @ in brödtexten för att öppna variabelväljaren. Markdown-redigeraren stöder ALERT_NAME, ALERT_STATUS, ALERT_CONDITION, ALERT_THRESHOLD, ALERT_COLUMN, ALERT_URLoch QUERY_RESULT_TABLE.