監視已排程查詢
Adobe Experience Platform透過UI改善所有查詢作業的狀態可見性。 從排程查詢索引標籤,您現在可以找到有關查詢執行的重要資訊,包括狀態、排程詳細資料,以及失敗時的錯誤訊息/代碼。 您也可以透過排程查詢索引標籤,針對這些查詢透過UI的任一查詢,根據查詢的狀態訂閱查詢警示。
已排程的查詢
排程查詢索引標籤會提供您所有排程的CTAS和ITAS查詢的概觀。 您可以找到所有已排程查詢的執行詳細資料,以及任何失敗查詢的錯誤代碼和訊息。
若要瀏覽至排程查詢索引標籤,請從左側瀏覽列選取 查詢,接著選取 排程查詢
下表說明每個可用的欄。
Run once
和Scheduled
。Success
、Failed
、In progress
和No runs
。排定查詢的目前狀態。 有6個可能的值: 正在登入、作用中、非作用中、已刪除、連字型大小及已隔離。
- Registering 狀態表示系統仍在處理建立查詢的新排程。 請注意,您無法在註冊時停用或刪除排定的查詢。
- 作用中 狀態表示排定的查詢有 個尚未通過 完成日期和時間。
- 非使用中 狀態表示排定的查詢已 通過 其完成日期和時間,或已被使用者標籤為非使用中狀態。
- 已刪除 狀態表示查詢排程已刪除。
- 連字型大小表示排定的查詢是單次、非循環的查詢。
- 隔離 狀態表示查詢已連續十次執行失敗,需要您的介入才能執行任何進一步的執行。
自訂排程查詢的表格設定 customize-table
您可以根據自己的需求調整排程查詢索引標籤上的資料行。 若要開啟自訂表格設定對話方塊並編輯可用的欄,請選取設定圖示( )。
切換相關的核取方塊以移除或新增表格欄。 接著,選取 套用 以確認您的選擇。
使用內嵌動作管理排程查詢 inline-actions
已排程的查詢檢視提供各種內嵌動作,讓您從一個位置管理所有已排程的查詢。 每列都會以省略符號指出內嵌動作。 選取您要管理的排程查詢省略符號,以在快顯功能表中檢視可用選項。 可用的選項包括停用排程或啟用排程、刪除排程、訂閱以查詢警示,以及啟用或停用隔離。
停用或啟用排定的查詢 disable
若要停用排程查詢,請針對您要管理的排程查詢選取省略符號,然後從快顯功能表的選項中選取 停用排程。 畫面會顯示一個對話方塊,確認您的動作。 選取 停用 以確認您的設定。
停用排定的查詢後,您就可以透過相同的程式啟用排程。 選取省略符號,然後從可用選項中選取 啟用排程。
刪除排定的查詢 delete
若要刪除排定的查詢,請為您要管理的排定查詢選取省略符號,然後從快顯功能表的選項中選取 刪除排程。 畫面會顯示一個對話方塊,確認您的動作。 選取 刪除 以確認您的設定。
刪除排定的查詢後,它 不會 從排定的查詢清單中移除。 省略符號提供的內嵌動作會被移除,並以灰色的加入警報訂閱圖示取代。 您無法訂閱已刪除排程的警示。 該列保留在UI中,以提供排程查詢過程中所執行的執行的資訊。
如果您想要排程該查詢範本的執行,請從適當的列選取範本名稱,以瀏覽至「查詢編輯器」,然後依照指示將排程新增至查詢,如檔案所述。
訂閱警報 alert-subscription
若要訂閱排程查詢執行的警示,請選取...
(省略符號)或警示訂閱圖示(
)管理排定的查詢。 內嵌動作下拉式功能表隨即顯示。 接著,從可用選項中選取 訂閱。
警示對話方塊開啟。 警示對話方塊會為您訂閱UI通知和電子郵件警示。 有數個可用的警示訂閱選項: start
、success
、failure
、quarantine
和delay
。 核取適當的方塊並選取 儲存 以訂閱。
下表說明支援的查詢警示型別:
start
success
failed
quarantine
delay
如需詳細資訊,請參閱警示訂閱API檔案。
檢視查詢詳細資料 query-details
選取資訊圖示( ),以檢視查詢的詳細資料面板。 詳細資訊面板包含查詢的所有相關資訊,超出已排程查詢表格中所包含的事實範圍。 其他資訊包括查詢ID、上次修改日期、查詢的SQL、排程ID和目前設定的排程。
隔離的查詢 quarantined-queries
註冊隔離功能後,任何連續十次執行失敗的排程查詢都會自動置於隔離狀態。 具有此狀態的查詢會變成非使用中,且不會以其排定的步調執行。 之後,您需要介入才能進行任何進一步的執行。 這樣可保護系統資源,因為您必須先檢閱並修正SQL的問題,才能進一步執行。
若要啟用隔離功能的排程查詢,請從出現的下拉式選單中選取省略符號(...
),然後選取啟用隔離。
在排程建立過程中,您也可以在隔離功能中註冊查詢。 如需詳細資訊,請參閱查詢排程檔案。
查詢執行延遲 query-run-delay
設定查詢延遲的警示,控制您的運算時間。 您可以監視查詢績效,並在特定期間後查詢狀態保持不變時接收通知。 如果查詢在特定時段後繼續處理而未完成,請使用'查詢執行延遲'警示通知。
當您訂閱排程查詢執行的警示時,可用的警示之一是查詢執行延遲。 此警報需要您設定執行時間的臨界值,此時您會收到處理延遲的通知。
若要選擇觸發通知的臨界值持續時間,請在文字輸入欄位中輸入數字,或使用向上和向下箭頭增加一分鐘。 由於臨界值是以分鐘為單位設定,因此觀察查詢執行延遲的最長持續時間為1440分鐘(24小時)。 執行延遲的預設時段為150分鐘。
請參閱訂閱警示區段以瞭解如何訂閱查詢執行延遲警示。
篩選查詢 filter
您可以根據執行頻率來篩選查詢。 從排程查詢索引標籤中,選取篩選圖示( )以開啟篩選側欄。
若要根據查詢的執行頻率來篩選查詢清單,請選取 已排程 或 執行一次 篩選核取方塊。
啟用篩選條件後,請選取 隱藏篩選器 以關閉篩選器面板。
查詢執行排程詳細資料 query-runs
若要開啟排程詳細資訊頁面,請從排程查詢索引標籤中選取查詢名稱。 此檢視提供排定查詢執行的所有執行清單。 提供的資訊包括開始和結束時間、狀態和使用的資料集。
此資訊會以五欄表格提供。 每一列代表查詢執行。
Success
、Failed
、In progress
或Quarantined
。可在屬性面板中看到正在排程的查詢詳細資料。 此面板包括初始查詢ID、使用者端型別、範本名稱、查詢SQL和排程的步調。
選取查詢執行ID以切換作業選項至「執行詳細資料」頁面,並檢視查詢資訊。
查詢執行概觀 query-run-overview
查詢執行總覽提供此排定查詢的個別執行資訊,以及執行狀態的更詳細劃分。 此頁面也包含使用者端資訊,以及可能導致查詢失敗的任何錯誤的詳細資訊。
若查詢失敗,查詢狀態區段會提供錯誤代碼和錯誤訊息。
您可以從此檢視將查詢SQL複製到剪貼簿。 若要複製查詢,請選取SQL程式碼片段右上角的復製圖示。 會出現快顯訊息,確認已復製程式碼。
使用匿名區塊執行查詢的詳細資料 anonymous-block-queries
使用匿名區塊來組成其SQL陳述式的查詢會分隔成其個別的子查詢。 子查詢的劃分可讓您個別檢查每個查詢區塊的執行詳細資訊。
匿名區塊是透過在查詢前使用$$
首碼來表示。 若要進一步瞭解查詢服務中的匿名區塊,請參閱匿名區塊檔案。
匿名區塊子查詢的執行狀態左側有標籤。 選取索引標籤以顯示執行詳細資料。
如果匿名區塊查詢失敗,您可以透過此UI找到該特定區塊的錯誤代碼。
選取 查詢 以返回排程詳細資訊畫面,或選取 排程查詢 以返回排程查詢索引標籤。