警報

使用SQL編輯器定義警報通知你什麼時候返回的字段計劃查詢滿足一個閾值。您可以使用警報監視您的業務或警報等工具開始工作流集成用戶新員工培訓或支持的票。警報補充計劃查詢,但是他們的標準檢查每次執行。

重要的

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

視圖和組織警報

警報可以以兩種方式之一:

  • 新的警報在工作空間瀏覽器現在可以被點擊工作空間的圖標工作空間在側邊欄。這些警報是看得見的,默認情況下,在<強>家文件夾中。用戶可以在瀏覽器工作區警報組織到文件夾中連同其他磚對象。視圖和組織目前現有的警報在工作區中瀏覽器,用戶(或管理員)必須遷移到工作空間瀏覽器。磚SQL的工作空間瀏覽器的信息,包括遷移,明白了工作空間瀏覽器

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

重要的

7月10日開始,2023年,磚將force-migrate磚SQL的所有內容(儀表板、查詢、提醒)工作空間瀏覽器。訪問<強>我的提醒尋找任何un-migrated警報,將左邊的複選框。當一個盒子檢查,<強>遷移按鈕就會出現,讓你一次遷移多個資產。如果不采取行動,你的提醒將移動到您的用戶文件夾中。工作空間管理員應確保對象沒有一個有效的積極的主人有一個更新。9月10日,2023年開始,我們將刪除所有已遷移對象沒有一個有效的所有者。

默認情況下,對象是倒序排序。你可以重新排序通過單擊列標題列表。

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

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

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

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

    • 觸發意味著最近執行,值列在你的目標的查詢符合條件和閾值配置。如果你提醒檢查是否“貓”是1500以上,你的提醒將被觸發,隻要“貓”是1500年以上。

    • 好吧意味著在最近的查詢執行,列值不符合條件和閾值配置。這並不意味著警報並不是之前觸發。如果你的“貓”值是1470,你的提醒將顯示好吧

    • 未知的意味著磚SQL沒有足夠的數據來評估預警標準。你會看到這個狀態後立即創建警報和直到查詢執行。你也會看到這個狀態如果沒有查詢結果中的數據或者最近的查詢結果不包括的< em >值列你配置。

創建一個警報

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

  1. 做下列之一:

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

    • 點擊警告圖標警報在側邊欄,然後點擊<強>+新的警報按鈕。

    • 點擊工作空間的圖標工作空間在側邊欄,然後單擊<強>+創建警報。

  2. 尋找一個目標查詢。

    目標查詢

    提醒在多個列,您需要修改您的查詢。看到警報聚合

  3. 在<強>觸發條件領域,配置警報。

    • 的<強>值列下拉控製哪個字段的查詢結果評估。警報條件上可以設置查詢結果中的第一個值的列,或者你可以選擇設置一個聚合所有單個列的行,比如SUM或平均。

      警報聚合
    • 的<強>操作符下拉控製應用的邏輯操作。

    • 的<強>閾值比較文本輸入和使用您所指定的條件值列。

    提醒設置
  4. 點擊<強>預覽警報預覽警報和測試警報是否會觸發與當前數據。

  5. 在<強>當觸發時,發送通知字段中,選擇多少通知發送警報觸發時:

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

    • 每一次警報評估:發送一個通知每當警戒狀態觸發無論其地位在前麵的評價。

    • 最多每:發送一個通知每當警戒狀態觸發在特定的時間間隔。這個選擇可以讓你避免垃圾郵件通知警報觸發。

    無論你選擇哪個通知設置,隻要地位從你收到一個通知好吧觸發或從觸發好吧。時間表的設置影響你將收到多少通知如果狀態仍然存在觸發從一個執行下一個。有關詳細信息,請參見通知頻率

  6. 在<強>模板下拉,選擇一個模板:

    • 使用默認模板:警報通知消息和警報配置屏幕的鏈接查詢屏幕。

    • 使用自定義模板:警報通知包括更具體的預警信息。

      1. 將顯示一個框,輸入字段為主題和正文組成。任何靜態內容是有效的,你可以把內置模板變量:

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

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

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

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

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

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

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

        • QUERY_RESULT_TABLE:查詢結果表。

        • 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 >

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

      3. 單擊<強>預覽切換按鈕來預覽渲染的結果。

        重要的

        預覽是用於驗證模板變量是正確地呈現。這不是一個最終的準確表示通知內容,因為每個通知目的地可以顯示不同的通知。

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

  7. 在<強>刷新,設定一個刷新進度。警報的刷新時間獨立於查詢刷新進度。

    • 如果查詢是一個<強>作為所有者運行查詢,查詢運行使用查詢所有者憑證警惕的刷新進度。

    • 如果查詢是一個<強>作為觀眾運行查詢,查詢運行使用警報創造者的憑據警惕的刷新進度。

  8. 點擊<強>創建警報。

  9. 選擇一個通知目的地

    重要的

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

    通知目的地

警報聚合

聚合在警報通過修改原始SQL的磚SQL查詢的警報。警報來包裝原始查詢文本在一個公共表表達式(CTE)和執行包裝聚合查詢聚合查詢結果。

作為一個例子,一個總和聚合與文本警報附加到一個查詢選擇1作為column_name意味著隻要刷新提醒,修改後的SQL將運行:作為(選擇1作為column_name)選擇總和(column_name)

這意味著最初的查詢結果()進行聚合不能顯示在警報定義的身體(等參數QUERY_RESULT_ROWSQUERY_RESULT_COLS)隻要有一個聚合在一個警告。相反,這些變量隻會顯示最後,事後的查詢結果。

請注意

所有觸發條件不支持聚合相關的API。

警報在多個列

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

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

這個查詢返回1drafts_count>10000年archived_count>5000年。然後您可以配置警戒值時觸發1

通知頻率

磚SQL將通知發送給您選擇的通知目的地時檢測到警戒狀態發生了變化好吧觸發反之亦然。考慮一下這個例子,警報配置在一個查詢,將每天運行一次。警報的日常狀態出現在下麵的表。周一前警戒狀態好吧

一天

警戒狀態

周一

好吧

周二

好吧

周三

觸發

周四

觸發

星期五

觸發

周六

觸發

周日

好吧

如果通知頻率設置隻是一次周三,磚SQL發送一個通知當狀態改變好吧觸發再一次周日時開關。它不發送警報周四,周五或周六,除非你特別配置它因為執行之間的警戒狀態並未改變。

配置警報權限

配置誰能管理和運行警報,請參閱警報的訪問控製

所有權轉移的一個警告

當您保存一個警告,你變得警覺的主人。如果警報的主人從工作區中刪除,警報不再有一個所有者。工作區管理用戶可以警報的所有權轉移到一個不同的用戶。通過使用磚SQL的UI:所有權轉移

  1. 打開警報。

  2. 點擊<強>分享。

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

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

轉移所有權通過使用REST API,明白了所有權轉移的一個警告

如果警報之前一個所有者,用戶不再有<強>可以管理用戶許可警惕,你給了誰<強>可以管理現在業主許可。