查詢排程

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

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

已排程查詢的帳戶需求 technical-account-user-requirements

為協助排程查詢可靠地執行,Adobe建議管理員布建技術帳戶(使用OAuth伺服器對伺服器認證)以建立排程查詢。 排定的查詢也可以使用個人使用者帳戶建立,但如果該使用者的存取權被移除或停用,則以這種方式建立的查詢將停止執行。

如需設定技術帳戶和指派必要許可權的詳細資訊,請參閱認證指南必要條件API驗證

有關建立和設定技術帳戶的其他指引,請參閱:

如果您只使用查詢服務UI,請確保您擁有必要許可權,或請和管理技術帳戶的管理員進行協調。 任何已排程的查詢都會新增至Scheduled queries索引標籤中的清單,您可在此監視所有已排程查詢工作的狀態、排程詳細資料和錯誤訊息,以及訂閱警示。 如需有關監視和管理查詢的詳細資訊,請參閱監視排定的查詢檔案

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

NOTE
使用技術帳戶以確保排程查詢即使使用者離開組織或其角色變更也能繼續執行。 儘可能選擇一個技術帳戶,以實現不中斷的查詢自動化。

建立查詢排程 create-schedule

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

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

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

已反白顯示View schedule和Add schedule的查詢編輯器。

選取​ Add schedule ​以瀏覽至排程詳細資料頁面

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

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

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

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

新增排程詳細資料 schedule-details

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

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

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

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

您可以為​ Frequency ​選擇下列選項:

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

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

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

選取​ Create and append into new dataset ​在您第一次執行查詢時建立資料集。 後續執行會繼續將資料插入該資料集。 最後,提供資料集的名稱和說明。

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

包含資料集詳細資訊和醒目提示Create and append into new dataset選項的「排程」詳細資料面板。

或者,選取​Append into existing dataset,然後選取資料集圖示( 資料集圖示。 )。

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

Select output dataset​對話方塊隨即顯示。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

計算工作層級的時數 compute-hours

追蹤在查詢執行層級使用您的CTAS/ITAS批次查詢的計算時數。 此功能可提供運算使用情形的深入分析,協助您最佳化資源配置並改善查詢效能。

AVAILABILITY
「計算時數」功能是已購買Data Distiller SKU的使用者專屬的功能。 請聯絡您的 Adobe 代表以取得更多資訊。

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

下表提供詳細資訊區段中可用的每個資料欄的說明,其中列出已排程的查詢執行。

欄標題
說明
Query Run ID
顯示每個查詢回合的唯一識別碼,可讓您追蹤和參考已排程查詢的個別執行。
Query Run Start
表示查詢執行的開始日期和時間,協助您監視每次執行的開始時間。
Query Run Complete
顯示查詢執行的完成日期和時間,以提供insight的執行期間和狀態。
Status
顯示查詢執行的目前狀態,例如Completed, Running,Failed,,以快速評估結果。
Datasets
列出查詢執行中使用的資料集,以顯示與執行有關的資料來源。
Compute Hours
顯示用於每次查詢執行的運算時間(以小時為單位)。 這有助於追蹤資源使用情況並最佳化查詢效能。
NOTE
運算時數資料可從2024年8月15日取得。 此日期之前的資料會顯示為「無法使用」。

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

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

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

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

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

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

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

刪除停用的查詢

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

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

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

停用排程確認對話方塊。

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

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

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

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