Creare un avviso

Questa pagina ti guida nella procedura per creare un avviso Databricks SQL dall'inizio alla fine. Illustra l'editor di avvisi, l'esercitazione sulla creazione di avvisi, come esaminare i dettagli della valutazione e i modelli di notifica e le impostazioni avanzate che è possibile configurare.

Esplorare l'editor di avvisi

I passaggi descritti in questa sezione illustrano come creare l'avviso illustrato nell'immagine seguente. Usare le etichette e le spiegazioni per comprendere ogni componente.

1. Editor di query: scrivere e testare la query su cui si vuole inviare un avviso.
2. Calcolo: scegliere il warehouse SQL che esegue la query di avviso. L'indicatore di stato mostra se il data warehouse selezionato è attivo. Per informazioni sul dimensionamento di un SQL warehouse e sul comportamento durante l'esecuzione pianificata, vedere Scegliere un SQL warehouse per un avviso.
3. Pianificazione: impostare una pianificazione periodica per l'esecuzione dell'avviso.
4. Condivisione: impostare le autorizzazioni che definiscono il modo in cui gli altri utenti dell'area di lavoro possono usare l'avviso.
5. Condizione: selezionare la soglia del valore che deve attivare una notifica di avviso. È possibile eseguire la query per testare la condizione in questa sezione.
6. Notifiche: indicare quali utenti o destinazioni di notifica devono essere avvisati quando il valore soglia non rientra nell'intervallo previsto. Facoltativamente, impostare una frequenza di notifica per ripetere le notifiche fino a quando l'avviso non torna a OK.
7. Avanzate: usare le impostazioni avanzate per inviare avvisi su valori e condizioni speciali.

Creare un avviso

Per creare un avviso, seguire questa procedura:

1. Fare clic su Avvisi nella barra laterale e fare clic su Crea Avviso.

2. Copiare e incollare la query seguente nell'editor di query. Fare clic su Esegui tutto (1000). Per altre informazioni sull'uso dell'editor SQL, vedere Scrivere query ed esplorare i dati nel nuovo editor SQL.

   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. Fare clic sul selettore di calcolo, quindi selezionare un warehouse dall'elenco per specificare la risorsa di calcolo su cui viene eseguito l'avviso.

   

4. Nel campo Condizione impostare le condizioni che devono attivare l'avviso.

   

   Applicare le impostazioni seguenti, come illustrato:

   • Selezionare Somma come valore di dati da controllare. È possibile impostare una condizione di avviso sul primo valore di una colonna nel risultato della query oppure selezionare questa opzione per impostare un'aggregazione in tutte le righe di una singola colonna, ad esempio SUM o AVERAGE.
   • Selezionare amount come colonna da controllare.
   • Selezionare > (maggiore di) come operatore logico da applicare.
   • Impostare il valore soglia su Static value 4000. Il valore statico è selezionato per impostazione predefinita. Immettere 4000 nel campo valore.

5. Fare clic su Test condizione per visualizzare in anteprima l'avviso e verificare se l'avviso viene attivato con i dati correnti. Le impostazioni specificate devono attivare l'avviso. È possibile modificare il valore soglia per testare ulteriormente.

6. Nella sezione Notifiche cercare il nome utente e fare clic su di esso quando viene visualizzato.

7. Fare clic L'icona del calendario per aprire la finestra di dialogo Modifica pianificazione . Utilizzare i menu a discesa per impostare l'avviso in modo che venga eseguito ogni 5minuti da 0 minuti dopo l'inizio dell'ora. Fai clic su Salva. Facoltativamente, selezionare la casella di controllo Mostra sintassi cron per modificare la pianificazione utilizzando la sintassi Quartz Cron .

8. Fare clic su Visualizza avviso.

L'avviso viene salvato ed eseguito in base alla pianificazione specificata. I dati usati in questo esempio sono statici, quindi se la condizione testrestituita come attivata, viene attivata di nuovo alla successiva esecuzione. Si riceve una notifica tramite posta elettronica come avviso. Se la condizione test ha restituito OK, non viene inviata alcuna notifica.

Esaminare i dettagli dell'avviso

Verrà visualizzata una pagina per visualizzare i dettagli dell'avviso. La pagina mostra anche una cronologia degli avvisi con i dettagli di valutazione. Fare clic sul pulsante Esegui adesso per eseguire immediatamente la query di avviso e restituire il risultato in questa pagina.

Fare clic su Modifica nell'angolo superiore destro della pagina per continuare a modificare l'avviso.

Impostazioni avanzate

Fare clic su Impostazioni avanzate per applicare le impostazioni seguenti:

• Notifica su OK: inviare una notifica quando l'avviso torna allo stato OK.
• Stato risultato vuoto: impostare uno stato speciale da restituire quando la query non restituisce risultati.
• Modello: configurare il modello di notifica. Vedere Modelli di notifica.

Gli amministratori dell'area di lavoro possono configurare nuove destinazioni di notifica. Vedere Gestire le destinazioni di notifica.

Modelli di notifica

Le notifiche usano il modello predefinito a meno che non vengano personalizzate. Per personalizzare l'oggetto e il corpo, selezionare Personalizza modello. Sono disponibili due editor: l'editor standard e l'editor Markdown. Fare clic sulle schede seguenti per confrontarle.

Editor Standard

Nell'editor standard fare riferimento alle variabili nell'oggetto e nel corpo con {{VARIABLE_NAME}}. Sono supportate le variabili seguenti:

• ALERT_STATUS: stato dell'allerta valutato (stringa).
• ALERT_CONDITION: operatore della condizione di avviso (stringa).
• ALERT_THRESHOLD: soglia di avviso (stringa o numero).
• ALERT_COLUMN: nome della colonna di avviso (stringa).
• ALERT_NAME: nome dell'avviso (stringa).
• ALERT_URL: URL della pagina di avviso (stringa).
• QUERY_RESULT_TABLE: tabella HTML del risultato della query (stringa). I risultati sono limitati alle prime 100 righe. Solo le destinazioni di notifica tramite posta elettronica possono eseguire il rendering html.
• QUERY_RESULT_VALUE: valore del risultato della query (stringa o numero).
• QUERY_RESULT_ROWS: righe dei risultati della query (matrice di valori).
• QUERY_RESULT_COLS: colonne dei risultati della query (matrice di stringhe).

Ad esempio: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

L'editor standard supporta anche HTML per la formattazione. Solo le destinazioni di notifica tramite posta elettronica possono eseguire il rendering html. Sono consentiti i tag HTML seguenti: <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>

Per i tag elencati sono consentiti gli attributi seguenti:

Cliccare sul pulsante Anteprima per visualizzare il risultato finale.

Editor di Markdown

Attivare l'Editor Markdown per scrivere il corpo usando Markdown. L'editor Markdown dispone di una barra degli strumenti di formattazione e di un'anteprima di cui è stato eseguito il rendering.

Nell'editor Markdown fare riferimento alle variabili con @VARIABLE_NAME. Digita @ nel corpo del testo per aprire il selettore delle variabili. L'editor Markdown supporta ALERT_NAME, ALERT_STATUS, ALERT_CONDITIONALERT_THRESHOLD, ALERT_COLUMN, ALERT_URL, e QUERY_RESULT_TABLE.