查詢排程

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

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

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

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

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

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

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

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

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

建立查詢排程 create-schedule

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

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

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

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

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

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

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

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

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

新增排程詳細資料 schedule-details

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

IMPORTANT
目前有限的客戶群可支援沒有結束日期的已排程查詢。 如果您的組織已啟用此功能,您可以建立持續執行的排程查詢,而不需指定結束日期。 在某些系統回應和UI檢視中,沒有結束日期的排程可能會以遙遠的未來日期(例如31.12.9999)出現。
如果您的組織未啟用此功能,則必須指定結束日期。 結束日期沒有上限。

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

排定的查詢頻率 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
如果您選擇設定查詢執行延遲警報,您必須在Experience Platform UI中設定您想要的延遲時間(以分鐘為單位)。 輸入持續時間(分鐘)。 延遲時間上限為24小時(1440分鐘)。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

編輯排程 edit-schedule

您可以從排程查詢工作區、排程詳細資訊頁面或查詢編輯器存取排程編輯器。 您可以修改現有排程查詢的支援組態設定,而無需重新建立排程。 編輯排程只會更新排程設定。 它不會修改基礎SQL查詢定義。

IMPORTANT
編輯排程​選項只會針對符合資格的排程顯示。 無法編輯已結束、已刪除或仍在註冊的排程。

存取編輯工作流程 access-edit-workflow

使用​ 排程查詢 ​索引標籤的下列路徑之一,存取符合條件的排程查詢的編輯工作流程。

或者,選取省略符號() 針對您要修改的排程,請從內嵌動作功能表​編輯排程。 這會直接開啟排程編輯器。 如需詳細資訊,請參閱使用內嵌動作管理排定的查詢

內嵌動作的排程查詢索引標籤在快顯功能表中會省略並反白顯示編輯排程。

或者,從表格中選取排程名稱,以開啟排程詳細資訊頁面。 在排程詳細資訊頁面上,從頁面的右上角選取​ 編輯排程 ​以開啟排程編輯器。

排程詳細資訊頁面中反白顯示編輯排程按鈕。

您也可以從查詢編輯器編輯現有的合格排程。

  1. 在查詢編輯器中開啟查詢範本,並選取​檢視排程
  2. 從清單中選取排程ID以開啟排程詳細資訊頁面。
  3. 選取​編輯排程

編輯排程設定 edit-schedule-settings

使用排程編輯器來檢閱目前的排程組態並更新支援的設定。

NOTE
開始日期​和​ 開始時間 ​欄位在建立時已修正,無法修改。 若要使用不同的開始日期或開始時間,請建立新的排程

排程編輯器顯示可編輯的排程設定,包括頻率、週期日、結束日期、結束時間、查詢隔離註冊和警示訂閱。 開始日期和開始時間欄位已停用,無法修改。

可以修改下列設定:

設定
說明
頻率
查詢執行頻率。 選項包括​每小時每日每週每月​及​每年
查詢執行的天數。 選擇一或多個工作日,以每週順序執行;若您以每月或每年頻率執行,請選擇該月的特定日期。
結束日期
排定的查詢停止執行的截止日期。
結束時間
排程在指定結束日期結束的時間。
沒有結束日期
如果您的組織已啟用此選項,請將排程設定為連續執行,而不設定結束日期。
查詢隔離
從隔離功能註冊或移除查詢。 請參閱如果連續失敗則隔離查詢以取得詳細資料。
個警示
新增、移除或修改此排程查詢的警示訂閱。 請參閱設定可用警示型別之排程查詢狀態的警示

儲存排程變更 save-schedule-changes

更新排程設定後,選取​ 儲存 ​以套用變更。 當排程更新成功時,會顯示一則確認訊息。

驗證更新的排程資訊 verify-schedule-updates

儲存後,請確認更新的排程組態會出現在下列位置:

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

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

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

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

刪除停用的查詢

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

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

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

停用排程確認對話方塊。

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

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

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

recommendation-more-help
experience-platform-help-query-service