警報

類返回的字段時,警報將通知您計劃查詢滿足一個閾值。使用警報來監視您的業務,或將它們與工具集成,以啟動工作流,如用戶登陸或支持票。警報是計劃查詢的補充,但每次執行後都要檢查它們的條件。

重要的

  • 利用查詢的警報參數使用SQL編輯器中為每個參數指定的默認值。

查看和組織警報

可以通過以下兩種方式查看警報:

  • 現在可以通過單擊在工作區瀏覽器中查看新的警報工作空間的圖標工作空間在側邊欄。中的這些警報在默認情況下是可見的< >強首頁文件夾中。用戶可以將警報與其他Databricks對象一起組織到工作區瀏覽器中的文件夾中。要在工作區瀏覽器中查看和組織當前存在的警報,用戶(或管理員)必須將它們遷移到工作區瀏覽器中。有關Databricks SQL工作區瀏覽器(包括遷移)的信息,請參見Databricks SQL Workspace瀏覽器

  • 所有警報,無論創建時間或遷移狀態如何,都可以通過單擊查看警告圖標警報在側邊欄。

默認情況下,對象按時間倒序排序。您可以通過單擊列標題對列表進行重新排序。

  • 的名字顯示每個警報的字符串名稱。

  • 狀態顯示告警狀態是否為觸發好吧,或未知的

  • 最後一次更新顯示最近更新的時間或日期。

  • 在創建顯示創建警報的日期和時間。

    • 觸發意味著在最近的執行中,目標查詢中的Value列滿足您配置的條件和閾值。如果你的警報檢查“cats”是否高於1500,隻要“cats”高於1500,你的警報就會被觸發。

    • 好吧表示在最近的查詢執行中,“值”列不滿足您配置的“條件”和“閾值”。這並不意味著警報之前沒有被觸發。如果您的“cats”值現在是1470,您的警報將顯示為好吧

    • 未知的意味著Databricks SQL沒有足夠的數據來評估警報標準。您將在創建Alert後立即看到此狀態,直到查詢執行完畢。如果查詢結果中沒有數據,或者最近的查詢結果不包含< em >值列你配置。

警報列表

創建一個警報

按照以下步驟在查詢的單個列上創建警報。

  1. 做以下任何一件事:

    • 點擊新圖標在側邊欄中選擇< >強警報.

    • 點擊警告圖標警報,並單擊< >強+新的警報按鈕。

    • 點擊工作空間的圖標工作空間,然後單擊< >強+創建警報.

  2. 搜索目標查詢。

    目標查詢

    要對多個列發出警報,需要修改查詢。看到多個列上的警報

  3. 在< >強觸發時字段,配置警報。

    • 的< >強值列下拉菜單控製對查詢結果的哪個字段進行計算。

    • 的< >強條件下拉菜單控製要應用的邏輯操作。

    • 的< >強閾值文本輸入使用指定的條件與值列進行比較。

    提醒設置

    請注意

    如果目標查詢返回多個記錄,Databricks SQL警報將對第一個記錄起作用。當您更改Value列設置時,頂部行中該字段的當前值將顯示在其下方。

  4. 在< >強觸發時,發送通知字段,選擇觸發警報時發送的通知數量:

    • 隻有一次:事件發生時發送通知警戒狀態改變從好吧觸發

    • 對每個時間警報進行評估:當告警狀態為時,發送通知觸發不管它在之前的評估中的地位如何。

    • 最多每:當告警狀態為時,發送通知觸發在特定的時間間隔內。這種選擇使您可以避免經常觸發的警報的通知垃圾郵件。

    無論您選擇哪個通知設置,隻要狀態從哪裏消失,您就會收到通知好吧觸發或從觸發好吧.如果狀態保持不變,計劃設置將影響您將收到多少通知觸發從一個執行到下一個。有關詳細信息,請參見通知頻率

  5. 在< >強模板下拉菜單,選擇模板:

    • 使用默認模板:告警通知是一種消息,帶有到告警配置界麵和查詢界麵的鏈接。

    • 使用自定義模板:告警通知包含關於該告警的更具體的信息。

      1. 顯示一個框,由主題和主體的輸入字段組成。任何靜態內容都是有效的,你可以合並內置的模板變量:

        • ALERT_STATUS:評估的警報狀態(字符串)。

        • ALERT_CONDITION:警告條件操作符(字符串)。

        • ALERT_THRESHOLD:告警閾值(字符串或數字)。

        • ALERT_NAME:告警名稱(字符串)。

        • ALERT_URL:告警頁麵URL(字符串)。

        • QUERY_NAME:關聯查詢名稱(字符串)。

        • QUERY_URL:關聯查詢頁麵URL(字符串)。

        • QUERY_RESULT_VALUE:查詢結果值(字符串或數字)。

        • QUERY_RESULT_ROWS:查詢結果行(值數組)。

        • QUERY_RESULT_COLS:查詢結果列(字符串數組)。

        例如,一個示例主題可以是:警報“{{ALERT_NAME}}”改變了狀態{{ALERT_STATUS}}

      2. 可以使用HTML在自定義模板中格式化消息。模板中允許使用以下標簽和屬性:

        • 標簽:<一><方法><縮略詞>< b >< blockquote >身體< >< br ><代碼>< div >< em ><字體><標題>< h2 >< h3 >< h4 >< h5>,<代替>,<頭>,<人力資源>< html ><我><李>< ol >< p >< span >< >強<時尚><表>tbody > << td >< th >< tr >< ul >

        • 屬性:style, href (for<一>)、標題(<一><方法><縮略詞>

      3. 單擊< >強預覽切換按鈕預覽呈現的結果。

        重要的

        預覽對於驗證模板變量是否被正確呈現非常有用。它不是最終通知內容的準確表示,因為每個警報目的地顯示通知的方式不同。

      4. 單擊< >強保存更改按鈕。

  6. 在< >強刷新,設置刷新計劃。警報的刷新計劃獨立於查詢的刷新計劃。

    • 如果查詢是a< >強作為所有者運行查詢時,該查詢在警報的刷新計劃上使用查詢所有者的憑據運行。

    • 如果查詢是a< >強作為觀眾運行查詢時,該查詢在警報的刷新計劃上使用警報創建者的憑據運行。

  7. 點擊< >強創建警報.

  8. 選擇一個警報的目的地

    重要的

    如果你跳過這一步,你就會< em >不會當警報觸發時通知。

    警報的目的地

多個列上的警報

要基於查詢的多個列設置警報,查詢可以實現警報邏輯並返回要觸發的警報的布爾值。例如:

選擇情況下drafts_count>10000archived_count>5000然後1其他的0結束選擇總和情況下is_archived然後1其他的0結束作為archived_count總和情況下is_draft然後1其他的0結束作為drafts_count查詢數據

這個查詢返回1drafts_count>10000而且archived_count>5000.然後可以將警報配置為當值為時觸發1

通知頻率

Databricks SQL在檢測到警報狀態從更改時向所選警報目的地發送通知好吧觸發反之亦然。考慮這個示例,其中在計劃每天運行一次的查詢上配置了一個Alert。告警的每日狀態如下表所示。周一之前的警報狀態為好吧

一天

警戒狀態

周一

好吧

周二

好吧

周三

觸發

周四

觸發

星期五

觸發

周六

觸發

周日

好吧

如果通知頻率設置為隻是一次, Databricks SQL將在星期三發送通知,當狀態從好吧觸發周日又會換回來。它不會在周四、周五或周六發送警報,除非您專門將其配置為這樣做,因為Alert狀態在這些天的執行之間不會改變。

配置警報權限

要配置誰可以管理和運行警報,請參見警報的訪問控製

轉移警報的所有權

當您保存警報時,您將成為警報的所有者。如果警報的所有者從工作空間中刪除,則警報不再具有所有者。管理員用戶可以將警報的所有權轉讓給其他用戶。使用Databricks SQL UI轉移所有權:

  1. 打開警報。

  2. 點擊< >強分享.

  3. 選擇一個用戶,然後選擇< >強可以管理.

  4. 閱讀提示。如果您同意,請單擊< >強確認.

要通過使用REST API轉移所有權,請參見轉移警報的所有權

如果警報以前擁有所有者,則該用戶不再擁有< >強可以管理的權限,以及您授予的用戶< >強可以管理權限現在是所有者。