查詢排程

您可以透過建立查詢排程來自動執行查詢。 排程查詢會在自訂步調上執行,以根據頻率、日期和時間管理您的資料。 如有需要,您也可以為結果選擇輸出資料集。 已儲存為範本的查詢可以從「查詢編輯器」進行排程。

IMPORTANT
您只能將排程新增至已建立並儲存的查詢。

任何排定的查詢都會新增到排定的查詢索引標籤的清單中。 您可以從該工作區透過UI監視所有已排程查詢工作的狀態。 在已排程的查詢索引標籤上,您可以找到有關查詢執行的重要資訊並訂閱警示。 可用的資訊包括狀態、排程詳細資料,以及執行失敗時的錯誤訊息/代碼。 如需詳細資訊,請參閱監視排程查詢檔案

此工作流程涵蓋查詢服務UI中的排程程式。 若要瞭解如何使用API新增排程,請參閱排程查詢端點指南

建立查詢排程 create-schedule

若要排程查詢,請從排程查詢索引標籤的範本索引標籤或範本資料行中選取查詢範本。 選取範本名稱可將您導覽至查詢編輯器。

如果您從「查詢編輯器」存取已儲存的查詢,則可以建立查詢的排程,或從詳細資訊面板檢視查詢的排程。

TIP
選取​ 檢視排程 ​以瀏覽至排程工作區,並快速檢視任何排程的查詢執行。

具有檢視排程和新增排程的查詢編輯器已強調顯示。

選取​ 新增排程 ​以瀏覽至排程詳細資料頁面

或者,選取查詢名稱下方的​ 排程 ​索引標籤。

反白顯示[排程]索引標籤的[查詢編輯器]。

排程工作區隨即顯示。 UI會顯示與範本相關聯之任何已排程執行的清單。 選取​ 新增排程 ​以建立排程。

已反白新增排程的查詢編輯器排程工作區。

新增排程詳細資料 schedule-details

便會顯示「排程詳細資訊」頁面。 您可以在此頁面上編輯排定查詢的各種詳細資訊。 詳細資料包括排定的查詢🔗執行的頻率與工作日、開始與結束日期、要匯出結果的資料集,以及查詢狀態警示

IMPORTANT
查詢排程器UI不支援無限期或永久排程。 必須指定結束日期。 結束日期沒有上限。

醒目提示排程詳細資料面板。

排定的查詢頻率 scheduled-query-frequency

您可以為​ 頻率 ​選擇下列選項:

  • 每小時:排定的查詢將在您選取的日期期間內每小時執行一次。
  • 每日:排定的查詢將在您選取的時間和日期期間每隔X天執行一次。 請注意,選取的時間是​ UTC,而不是您的當地時區。
  • 每週:選取的查詢會在您選取的一週、時間和日期期間執行。 請注意,選取的時間是​ UTC,而不是您的當地時區。
  • 每月:選取的查詢會在您選取的日期、時間和日期期間每個月執行。 請注意,選取的時間是​ UTC,而不是您的當地時區。
  • 每年:選取的查詢每年會在您選取的日、月、時間和日期期間執行。 請注意,選取的時間是​ UTC,而不是您的當地時區。

提供資料集詳細資料 dataset-details

將資料附加至現有資料集,或建立新資料集並將資料附加至現有資料集,以管理查詢結果。

選取​ 建立並附加至新資料集,以在第一次執行查詢時建立資料集。 後續執行會繼續將資料插入該資料集。 最後,提供資料集的名稱和說明。

IMPORTANT
由於您正在使用現有資料集或建立新資料集,因此​ ​需要將INSERT INTOCREATE TABLE AS SELECT納入查詢中,因為資料集已設定。 將INSERT INTOCREATE TABLE AS SELECT加入排定的查詢將會導致錯誤。

包含資料集詳細資料的「排程」詳細資料面板,以及反白顯示的建立及附加至新資料集選項。

或者,也可以選取​ 附加至現有資料集,後面接著資料集圖示( 資料集圖示。 )。

排程詳細資料面板包含醒目提示的資料集詳細資料以及附加至現有資料集的資訊。

選取輸出資料集 ​對話方塊就會顯示。

接下來,瀏覽現有資料集或使用搜尋欄位來篩選選項。 選取要使用的資料集列。 資料集詳細資料會顯示在右側的面板中。 選取​ 完成 ​以確認您的選擇。

選取輸出資料集對話方塊中會顯示搜尋欄位、資料集列,以及反白顯示的[完成]。

如果查詢持續失敗,則將其隔離 quarantine

建立排程時,您可以在隔離功能中註冊查詢,以保護系統資源並防止潛在的中斷。 隔離功能會自動識別並隔離透過將查詢置於隔離狀態而重複失敗的查詢。 透過在連續十次失敗後隔離查詢,您可以在允許進一步執行之前介入、檢閱和修正問題。 這有助於維持您的營運效率和資料完整性。

已反白顯示查詢隔離且已選取[是]的查詢排程工作區。

在查詢註冊隔離功能後,您可以訂閱此查詢狀態變更的警報。 如果排定的查詢未註冊隔離區,它就不會在警示對話方塊上顯示為選項。

您也可以從排程查詢索引標籤的內嵌動作,將排程查詢註冊到隔離功能。 如需詳細資訊,請參閱監視器查詢檔案

設定排程查詢狀態的警示 alerts-for-query-status

您也可以訂閱查詢警示,作為排程查詢設定的一部分。 您可以進行設定,以接收各種情況的通知。 可以為隔離狀態、查詢處理延遲或查詢狀態變更設定警報。 可用的查詢狀態警報選項包括開始、成功和失敗。 警報能以快顯通知或電子郵件的形式接收。 選取核取方塊以訂閱排定查詢之狀態的警示。

標示警示選項的排程詳細資料面板。

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

警報類型
說明
start
此警報會在排定的查詢執行起始或開始處理時通知您。
success
此警報會在排定的查詢執行成功完成時通知您,表示查詢執行時沒有任何錯誤。
failed
排定的查詢執行發生錯誤或無法成功執行時,就會觸發此警報。 它有助於您及時識別並解決問題。
quarantine
當排程的查詢執行進入隔離狀態時,此警報便會啟動。 在查詢註冊隔離功能後,任何連續執行失敗的排程查詢都會自動進入隔離狀態。 然後,隔離的查詢需要您的干預,才能進行任何進一步的執行。 注意:您必須為隔離功能註冊查詢,才能訂閱隔離警報。
delay
此警示會通知您排定的查詢執行結果🔗是否有延遲超過指定的臨界值。 您可以設定自訂時間,在該期間查詢執行時觸發警報,而不完成或失敗。 預設行為會在查詢開始處理後設定150分鐘的警報。
NOTE
如果您選擇設定查詢執行延遲警報,您必須在Platform UI中設定您想要的延遲時間(以分鐘為單位)。 輸入持續時間(分鐘)。 延遲時間上限為24小時(1440分鐘)。

如需Adobe Experience Platform中警示的概觀,包括警示規則的定義結構,請參閱警示概觀。 如需在Adobe Experience Platform UI中管理警示和警示規則的指南,請參閱警示UI指南

為排程的引數化查詢設定引數 set-parameters

IMPORTANT
引數化查詢UI功能目前僅在​ 有限發行版本 ​中可用,而且不是所有客戶都可使用。 如果您無法存取引數化查詢,請繼續執行刪除或停用排程區段。

如果您要為引數化查詢建立排定的查詢,現在必須設定這些查詢執行的引數值。

排程建立工作流程的「排程詳細資料」區段,其中的「查詢引數」區段反白顯示。

確認您的排程詳細資料後,選取​ 儲存 ​以建立排程。 您會回到範本的排程標籤。 此工作區會顯示新建立排程的詳細資料,包括排程ID、排程本身以及排程的輸出資料集。

檢視排定的查詢執行 scheduled-query-runs

從範本的排程索引標籤中,選取排程ID以瀏覽至新排程查詢的查詢執行清單。

已反白新建立排程的排程工作區。

或者,若要檢視查詢範本排定的執行清單,請瀏覽至​ 排定的查詢 ​索引標籤,並從可用的清單中選取範本名稱。

反白顯示具名範本的[排程查詢]索引標籤。

該排定查詢的查詢執行清單隨即顯示。

已排程查詢工作區的詳細資訊區段,其中包含已排程查詢反白顯示的查詢執行清單。

如需有關如何透過UI監視所有查詢工作狀態的完整資訊,請參閱監視器排程查詢指南

從清單中選取​ 查詢執行ID,以瀏覽至查詢執行總覽。 如需查詢執行總覽上可用資訊的完整明細,請參閱監視器排程查詢檔案。

若要使用查詢服務API監視排定的查詢,請參閱排定的查詢執行端點指南

啟用、停用或刪除排程 delete-schedule

您可以從特定查詢的排程工作區或列出所有排程查詢的排程查詢工作區啟用、停用或刪除排程。

若要存取您所選查詢的排程索引標籤,您必須從範本索引標籤或排程查詢索引標籤中選取查詢範本的名稱。 這會導覽至該查詢的查詢編輯器。 從查詢編輯器中,選取​ 排程 ​以存取排程工作區。

從可用排程的列中選取排程,以填入詳細資訊面板。 使用切換可停用(或啟用)排定的查詢。

刪除停用的查詢

IMPORTANT
您必須先停用排程,才能刪除查詢的排程。

範本的排程清單,其詳細資料面板已反白顯示。

確認對話方塊隨即顯示。 選取​ 停用 ​以確認動作。

停用排程確認對話方塊。

選取​ 刪除排程 ​以刪除已停用的排程。

刪除排程的排程工作區已反白顯示。

或者,排程查詢索引標籤會為每個排程查詢提供內嵌動作集合。 可用的內嵌動作包括停用排程或啟用排程、刪除排程和訂閱排程查詢的警示。 如需有關如何透過排程查詢索引標籤刪除或停用排程查詢的完整指示,請參閱監視器排程查詢指南

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