定時任務介面介紹

1.1 版本

1.2 歷史版本更新

1.3 功能簡介

本文對「資料開發」下的「定時任務」模組的介面進行詳細描述和解譯，以幫助使用者更好地瞭解該模組的功能和使用方法。

任務列表中使用者可查看和編輯所有有 權限 的定時任務。

2.1 定時任務

滑鼠點選某個定時任務右側的標籤，可修改任務名稱與描述、將任務行動到某個路徑下、將任務複製到某個路徑下、刪除任務、匯出任務、收藏任務（4.2.16.2 及之後版本支援）。如下圖所示：

說明如下：

1）複製的任務的節點/算子配置、參數設定、調度配置中的逾時限制、失敗重試、結果通知、畫布佈局都支援保留，但定時任務的「開啟調度」不保留。

2）4.1.6.5 及之後版本，支援拖曳定時任務來改變其位置：

• 所有使用者均可手動拖曳有權限的定時任務。

• 拖曳結果對所有使用者生效。

• 升級到 4.1.6.5 及之後版本後，目錄樹均初始化為「按名稱排序」的結果。

• 某使用者從上到下看到的定時任務為 5、1、7；管理者從上到下看到的定時任務為 5、6、1、9、7；該使用者將 7 挪到 5 和 1 之間，管理者側將看到 7 在 1 上面，在 6 下面；即被挪動的任務緊靠下方的那個目標節點（目標節點為 5 和 1,1為靠下的位置）。

3）「行動到」按鈕說明：該按鈕不支援改變位次，只能改變所在資料夾；在資料夾 A 中的定時任務，點選「行動到」按鈕，行動到資料夾 B ，定時任務行動後，將位於資料夾 B 的末尾；若仍然行動到 資料夾 A ，定時任務的位置不變；「行動到」效果對所有使用者生效。

4）4.1.6.5 及之後版本，「重新命名」按鈕被取代為「名稱與描述按鈕」；點選「名稱與描述按鈕」，可修改定時任務的名稱與描述。如下圖所示：

注1：任務名稱最多 60 個字元，任務描述最多 300 個字元。

注2：若升級前任務名稱已超過 60 字元，升級後，保留任務名稱，修改任務名稱時，限制 60 字元。

新增描述後，滑鼠懸浮在定時任務上，可顯示定時任務的名稱與描述。如下圖所示：

若某定時任務沒有新增描述，滑鼠懸浮在定時任務上，只顯示任務名稱。

5）建立定時任務時，可設定定時任務的位置、名稱、描述。如下圖所示：

注：任務名稱最多 60 個字元，任務描述最多 300 個字元。

2.2 資料夾

滑鼠點選某個資料夾右側的標籤，可對該資料夾做重新命名、行動到某個路徑下、刪除操作。如下圖所示：

4.1.6.5 及之後版本，資料夾支援拖曳來挪動其順序，具體說明可參見本文 2.1 節的定時任務拖曳說明。

3.1 節點基礎操作

在畫布中，支援新增節點來實現任務的設計。詳情參見文檔：節點基礎操作

3.2 畫布導航器

4.1.7.1 版本支援導航器功能，可顯示畫布內容的縮略圖；支援拖曳行動檢視表；支援點選導航器其它區域，可快速定位畫布內容，如下圖所示：

對搜尋和檢視表導航功能提供新手引導，如下圖所示：

3.3 行動設計介面畫布

在設計介面按住鍵盤空格鍵，然後拖動滑鼠游標，可以行動任務整體畫布，操作如下圖所示：

同時可以將任務無限拓展畫布區域。如下圖所示：

3.4 標籤頁

1）開啟多個定時任務時，支援左右拖曳標籤頁取代開啟順序。如下圖所示：

2）4.2.9.3 及之後版本，增加標籤頁操作。滑鼠右鍵點選標籤頁，支援：關閉、關閉其他、關閉全部。當標籤頁開啟過多，切換標籤頁時形成幹擾，可以快捷地批量關閉標籤頁。如下圖所示：

4.1 運作和終止任務

4.1.1 運作

1）設計好的定時任務可以點選工具欄的「運作」來運作。如下圖所示：

2）或者設定執行頻率，讓任務在特定的條件下運作。詳情請參見：排程管理、事件調度

4.1.2 終止

生產模式下的「終止」按鈕，需謹慎點選，將中斷當前任務產生的所有實體 。

使用者若想終止當前實體，可到「維運中心>定時任務>運作記錄」中終止當前實體 。

設計好的定時任務可以點選工具欄的「運作」來運作，如果需要中途強制終止任務，可以點選「終止」，操作如下圖所示：

4.2 參數設定

工具欄中的「參數設定」可以讓使用者自訂一些參數，詳細介紹參見文檔：自訂參數

4.3 調度計劃

詳情請參見：調度計劃概述

調度計劃中，可為定時任務新增「排程管理」和「事件調度」。

• 排程管理：可為定時任務設定執行頻率，定期自動運作定時任務，以保證資料能夠即時更新，一個定時任務可設定多個執行頻率。

• 事件調度：可設定任務的調度依賴。例如：數倉構建程式中 ODS 層有 a、b、c 任務互不影響、DW 層有 d 、f 任務，需要 a、b 任務執行完觸發 d 任務，來減少 DW 層對 ODS 層完全更新完等待的時間；若 a、b 執行失敗則不觸發，來避免資料準確性的問題。

4.4 任務控制

定時任務的「任務控制」中，包含 3 個 Tab ，可為定時任務設定失敗重試次數、逾時時間、髒資料容忍行數、執行失敗通知方式、任務優先等。如下圖所示：

詳情請參見：任務控制概述

4.5 任務資訊

點選「任務資訊」，展示定時任務的任務id、所屬目錄、建立人、建立時間、最近編輯時間（4.2.16.2 版本新增）、最近發佈時間 。

任務日誌展示區域的「日誌」頁可以查看當前任務的執行情況。日誌內容詳細說明請參見：運作日誌介紹

4.2.7.4 及之後版本，「資料轉化」內新增「日誌」tab，支援查看輸入、匯出算子的日誌資訊。

4.2.9.1 及之後版本，新增「尋找」按鈕，可輸入關鍵詞尋找日誌資訊。如下圖所示：

節點右下角會顯示執行狀態，滑鼠懸浮執行狀態，可查看節點執行日誌。如下圖所示：

4.2.9.1 及之後版本，節點運作狀態為：正在執行、執行成功、執行失敗、終止執行，資料同步、資料轉換、參數指派節點新增「後端日誌Job號」資訊。

可使用 Job 號，在後端日誌中定位節點資訊。

4.2.22.3 及之後版本，若日誌內容超出長度限制後會被截斷，新增「下載日誌」按鈕，支援在運作結束後下載完整的任務日誌查看 。

6.1 統計資訊

任務日誌展示區域的「統計」頁可以查看「資料同步」節點和「資料轉換」節點的讀寫資訊。

若定時任務運作程式中有髒資料，也展示髒資料資訊；點選髒資料行數可展開查看各錯誤原因分類下的髒資料條數。

注1：表格中「總流量」欄位代表讀取和寫入的資料量，所佔用的流量。

注2：「統計」中，只統計包含輸入、匯出的節點，例如資料同步節點、資料轉換節點等。

4.2.7.4 及之後版本，「資料轉化」內新增「統計」tab，支援查看輸入、匯出算子的統計結果。

在統計結果中，「資料流結果」列支援展示匯出算子是否執行成功。如下圖所示：

6.2 髒資料資訊 

6.2.1 查看髒資料

若定時任務運作程式中有髒資料，也展示髒資料資訊；點選髒資料行數可展開查看各錯誤原因分類下的髒資料條數。

同時可以按照錯誤類型對髒資料進行篩選，並查看報錯詳情，如下圖所示：

6.2.2 匯出髒資料

4.2.8.4 及之後版本，統計資訊中支援查看髒資料詳情，支援「匯出髒資料明細」。如下圖所示：

注 1：髒資料匯出行數限制 1 萬條；

注 2：髒資料清理策略跟隨「日誌清理」配置，入口為「管理系統->智慧維運->平台日誌->全局設定->日誌清理」。