監視已排程查詢

Adobe Experience Platform透過UI改善所有查詢作業的狀態可見性。 從 排定的查詢 索引標籤中,您現在可以找到有關查詢執行的重要資訊,包括狀態、排程詳細資訊,以及失敗時的錯誤訊息/代碼。 您還可以透過UI訂閱基於查詢狀態的查詢警示,以進行任何查詢,透過 排定的查詢 標籤。

排定的查詢

此 排定的查詢 索引標籤會提供所有已排程的CTAS和ITAS查詢的概觀。 您可以找到所有已排程查詢的執行詳細資料,以及任何失敗查詢的錯誤代碼和訊息。

若要導覽至 排定的查詢 索引標籤,選取 查詢 從左側導覽列,後面接著 排定的查詢

在Queries工作區中的Scheduled Queries索引標籤中反白顯示排定的查詢和查詢。

下表說明每個可用的欄。

NOTE
警示訂閱圖示( 警示訂閱圖示。 )包含在未命名欄的每一列中。 請參閱 警示訂閱 區段以取得詳細資訊。
說明
名稱
名稱欄位是範本名稱或SQL查詢的前幾個字元。 任何透過UI使用查詢編輯器建立的查詢都會在開始時命名。 如果查詢是透過API建立的,則其名稱會變成用來建立查詢的初始SQL的片段。 若要檢視與查詢相關聯的所有執行清單,請從以下專案選取專案: 名稱 欄。 如需詳細資訊,請參閱 查詢執行排程詳細資料 區段。
範本
查詢的範本名稱。 選取範本名稱以導覽至「查詢編輯器」。 為方便起見,查詢範本會顯示在查詢編輯器中。 如果沒有範本名稱,資料列會以連字型大小標籤,且無法重新導向至查詢編輯器以檢視查詢。
SQL
SQL查詢的片段。
執行頻率
設定查詢執行的步調。 可用的值包括 Run onceScheduled.
建立者
建立查詢的使用者名稱。
已建立
建立查詢時的時間戳記,以UTC格式表示。
上次執行時間戳記
執行查詢時的最新時間戳記。 此欄著重顯示查詢是否已根據其目前排程執行。
上次執行狀態
最近查詢執行的狀態。 狀態值為: SuccessFailedIn progress、和 No runs.
排程狀態

排定查詢的目前狀態。 有六個潛在值, 正在註冊, 作用中, 非使用中, 已刪除,連字型大小,和 已隔離.

  • 正在註冊 狀態表示系統仍在處理建立查詢的新排程。 請注意,您無法在註冊時停用或刪除排定的查詢。
  • 作用中 狀態表示排定的查詢具有 尚未通過 其完成日期和時間。
  • 非使用中 狀態表示排定的查詢具有 已通過 其完成日期和時間,或已被使用者標籤為處於非使用中狀態。
  • 已刪除 狀態表示已刪除查詢排程。
  • 連字型大小表示排定的查詢是單次、非循環的查詢。
  • 已隔離 狀態表示查詢已連續十次執行失敗,並需要您的介入才能進行任何進一步的執行。
TIP
如果您導覽至「查詢編輯器」,可以選取 查詢 以返回 範本 標籤。

自訂排程查詢的表格設定 customize-table

您可以調整 排定的查詢 定位以符合您的需求。 若要開啟 自訂表格 設定對話方塊並編輯可用的欄,選取設定圖示( 設定圖示。 )。

NOTE
此 已建立 依照預設,會隱藏參考排程建立日期的欄。

「排定的查詢」標籤中反白了「自訂表格設定」圖示。

切換相關的核取方塊以移除或新增表格欄。 接下來,選取 套用 以確認您的選擇。

NOTE
透過UI建立的任何查詢都會在建立過程中成為具名範本。 範本名稱顯示在範本欄中。 如果查詢是透過API建立的,則範本欄為空白。

自訂表格設定對話方塊。

使用內嵌動作管理排程查詢 inline-actions

此 排定的查詢 「檢視」提供各種內嵌動作,讓您從一個位置管理所有已排程的查詢。 每列都會以省略符號指出內嵌動作。 選取您要管理的排程查詢省略符號,以在快顯功能表中檢視可用選項。 可用的選項包括 停用排程 或 啟用排程, 刪除排程訂閱 以查詢警示,以及 啟用或 停用隔離.

內嵌動作會省略並反白彈出式選單的「排程查詢」標籤。

停用或啟用排定的查詢 disable

若要停用排定的查詢,請選取您要管理的排定查詢的省略符號,然後選取「 」 停用排程 從躍現式選單中的選項。 畫面會顯示一個對話方塊,確認您的動作。 選取 停用 以確認您的設定。

停用排定的查詢後,您就可以透過相同的程式啟用排程。 選取省略符號,然後選取「 」 啟用排程 可用選項中的。

NOTE
如果已隔離查詢,您應該先複查範本的SQL,然後再啟用其排程。 如果範本查詢仍有問題,這可避免浪費運算時間。

刪除排定的查詢 delete

若要刪除排定的查詢,請選取您要管理的排定查詢的省略符號,然後選取「 」 刪除排程 從躍現式選單中的選項。 畫面會顯示一個對話方塊,確認您的動作。 選取 刪除 以確認您的設定。

刪除排定的查詢後,它會 已從排程查詢清單中移除。 省略符號提供的內嵌動作會被移除,並以灰色的加入警報訂閱圖示取代。 您無法訂閱已刪除排程的警示。 該列保留在UI中,以提供排程查詢過程中所執行的執行的資訊。

「排程查詢」索引標籤中會顯示已刪除的排程查詢,且醒目提示警示訂閱圖示呈現灰色。

如果您要為該查詢範本排定執行,請從適當的資料列選取範本名稱,以切換作業選項至「查詢編輯器」,然後遵循下列步驟 新增排程至查詢的指示 如檔案所述。

訂閱警示 alert-subscription

若要訂閱排程查詢執行的警示,請選取 ... (省略符號)或警報訂閱圖示( 警示訂閱圖示。 )以取得您要管理的排程查詢。 內嵌動作下拉式功能表隨即顯示。 接下來,選取 訂閱 可用選項中的。

已排程的查詢工作區具有橢圓形、警報訂閱圖示,且內嵌動作下拉式選單反白顯示。

此 警報 對話方塊開啟。 此 警報 對話方塊會讓您訂閱UI通知和電子郵件警示。 有數個警報訂閱選項可供使用: startsuccessfailurequarantine、和 delay. 勾選適當的一或多個方塊並選取 儲存 以訂閱。

警示訂閱對話方塊。

下表說明支援的查詢警示型別:

警示型別
說明
start
此警報會在排定的查詢執行起始或開始處理時通知您。
success
此警報會在排定的查詢執行成功完成時通知您,表示查詢執行時沒有任何錯誤。
failed
排定的查詢執行發生錯誤或無法成功執行時,就會觸發此警報。 它有助於您及時識別並解決問題。
quarantine
當排程的查詢執行進入隔離狀態時,此警報便會啟動。 在中註冊查詢時 隔離功能,任何連續十次執行失敗的排程查詢都會自動放入 已隔離 州別。 然後需要您的介入才能進行任何進一步的執行。
delay
此警報會通知您是否有 查詢執行結果的延遲 超過指定的臨界值。 您可以設定自訂時間,當查詢在該期間內執行時觸發警報,而不需要完成或失敗。
NOTE
若要收到查詢執行遭到隔離的通知,您必須先在中註冊排定的查詢執行 隔離功能.

請參閱 警示訂閱API檔案 以取得詳細資訊。

檢視查詢詳細資料 query-details

選取資訊圖示( 資訊圖示。 ),以檢視查詢的詳細資料面板。 詳細資訊面板包含查詢的所有相關資訊,超出已排程查詢表格中所包含的事實範圍。 其他資訊包括查詢ID、上次修改日期、查詢的SQL、排程ID和目前設定的排程。

「排程查詢」索引標籤中會顯示資訊圖示,並反白顯示詳細資訊面板。

隔離的查詢 quarantined-queries

NOTE
隔離警報不適用於「只執行一次」的臨時查詢。 隔離警報僅適用於排程批次(CTAS和ITAS)查詢。

註冊隔離功能後,任何連續十次執行失敗的排程查詢都會自動放入 已隔離 狀態。 具有此狀態的查詢會變成非使用中,且不會以其排定的步調執行。 之後,您需要介入才能進行任何進一步的執行。 這樣可保護系統資源,因為您必須先檢閱並修正SQL的問題,才能進一步執行。

若要為隔離功能啟用排程查詢,請選取省略符號(...)後接 啟用隔離 從出現的下拉式功能表中。

內嵌動作下拉式選單中反白顯示有省略符號和「啟用隔離」的已排程查詢索引標籤。

在排程建立過程中,您也可以在隔離功能中註冊查詢。 請參閱 查詢排程檔案 以取得詳細資訊。

查詢執行延遲 query-run-delay

設定查詢延遲的警示,控制您的運算時間。 您可以監視查詢績效,並在特定期間後查詢狀態保持不變時接收通知。 使用'查詢執行延遲」警報,當查詢在特定時段後繼續處理而未完成時通知。

當您 訂閱警示 對於已排程的查詢執行,可用的警報之一是 查詢執行延遲. 此警報需要您設定執行時間的臨界值,此時您會收到處理延遲的通知。

若要選擇觸發通知的臨界值持續時間,請在文字輸入欄位中輸入數字,或使用向上和向下箭頭增加一分鐘。 由於臨界值是以分鐘為單位設定,因此觀察查詢執行延遲的最長持續時間為1440分鐘(24小時)。 執行延遲的預設時段為150分鐘。

NOTE
查詢執行只能有一個執行延遲時間。 如果您變更延遲臨界值,訂閱警示的使用者和整個組織的使用者都會變更延遲臨界值。

「已排程查詢」索引標籤上的「警示」對話方塊,其查詢執行延遲輸入欄位會反白顯示。

請參閱訂閱警報一節,瞭解如何 訂閱 查詢執行延遲 警報.

篩選查詢 filter

您可以根據執行頻率來篩選查詢。 從 排定的查詢 索引標籤中,選取篩選器圖示( 篩選器圖示 )以開啟篩選器側欄。

已排程查詢索引標籤中反白了篩選圖示。

若要根據查詢的執行頻率來篩選查詢清單,請選取 已排程執行一次 篩選核取方塊。

NOTE
任何已執行但未排程的查詢都符合條件 執行一次.

帶有篩選器側欄的排程查詢索引標籤會反白顯示。

啟用篩選條件後,請選取 隱藏篩選器 以關閉篩選面板。

查詢執行排程詳細資料 query-runs

若要開啟「排程詳細資料」頁面,請從下列位置選取查詢名稱: 排定的查詢 標籤。 此檢視提供排定查詢執行的所有執行清單。 提供的資訊包括開始和結束時間、狀態和使用的資料集。

排程詳細資訊頁面。

此資訊會以五欄表格提供。 每一列代表查詢執行。

欄名稱
說明
查詢執行ID
每日執行的查詢執行識別碼。 選取 查詢執行ID 導覽至 查詢執行總覽.
查詢執行開始
執行查詢時的時間戳記。 時間戳記採用UTC格式。
查詢執行完成
查詢完成時的時間戳記。 時間戳記採用UTC格式。
狀態
最近查詢執行的狀態。 狀態值為: SuccessFailedIn progress,或 Quarantined.
資料集
執行中涉及的資料集。

欲檢視正在排程的查詢詳細資料,請參閱 屬性 面板。 此面板包括初始查詢ID、使用者端型別、範本名稱、查詢SQL和排程的步調。

排程詳細資訊頁面,其中屬性面板會反白顯示。

選取查詢執行ID以切換作業選項至「執行詳細資料」頁面,並檢視查詢資訊。

排程詳細資訊畫面中反白顯示執行ID。

查詢執行概觀 query-run-overview

此 查詢執行總覽 提供此排程查詢個別執行的相關資訊,以及執行狀態的更詳細劃分。 此頁面也包含使用者端資訊,以及可能導致查詢失敗的任何錯誤的詳細資訊。

執行詳細資訊畫面,其中總覽區段強調顯示。

若查詢失敗,查詢狀態區段會提供錯誤代碼和錯誤訊息。

執行詳細資訊畫面中反白了錯誤區段。

您可以從此檢視將查詢SQL複製到剪貼簿。 若要複製查詢,請選取SQL程式碼片段右上角的復製圖示。 會出現快顯訊息,確認已復製程式碼。

執行詳細資訊畫面,醒目提示SQL復製圖示。

使用匿名區塊執行查詢的詳細資料 anonymous-block-queries

使用匿名區塊來組成其SQL陳述式的查詢會分隔成其個別的子查詢。 子查詢的劃分可讓您個別檢查每個查詢區塊的執行詳細資訊。

NOTE
使用DROP命令的匿名區塊的執行詳細資料 將作為單獨的子查詢報告。 CTAS查詢、ITAS查詢和用作匿名區塊子查詢的COPY陳述式有個別的執行詳細資訊。 目前不支援DROP命令的執行詳細資料。

匿名區塊會使用 $$ 查詢前的字首。 若要進一步瞭解查詢服務中的匿名區塊,請參閱 匿名區塊檔案.

匿名區塊子查詢的執行狀態左側有標籤。 選取索引標籤以顯示執行詳細資料。

顯示匿名區塊查詢的查詢執行總覽。 多個查詢標籤會反白顯示。

如果匿名區塊查詢失敗,您可以透過此UI找到該特定區塊的錯誤代碼。

查詢執行總覽會顯示匿名區塊查詢,其中醒目提示單一區塊的錯誤代碼。

選取 查詢 以返回排程詳細資訊畫面,或 排定的查詢 以返回 排定的查詢 標籤。

執行詳細資訊畫面,其中反白顯示查詢。

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb