DataWorks：任務調試流程

調試運行單個任務

1. 資料開發（DataStudio）（舊版），在左側導覽列的資料開發或手動商務程序模組，雙擊商務程序目錄下的目標節點，進入該節點的編輯頁面。

2. 調試運行任務。

   在節點編輯頁面，使用節點工具列中的運行或進階運行調試代碼邏輯，也可通過快捷運行調試程式碼片段，具體說明如下表。

   說明

   運行任務時，若查詢的目標資料無許可權，可參考引擎與資料許可權管控概述瞭解DataWorks中各引擎的許可權管控。

   運行方式	描述	情境選擇
   運行（表徵圖）	支援為代碼測試情境的變數賦值，以及指定調度資源群組。相關賦值及指定的資源群組會被記錄，後續運行時可直接使用。 說明 建立節點首次運行時會出現配置彈框，您需在彈框中手動為代碼中的變數賦值常量。首次賦值會被DataWorks記錄，下次執行運行操作時預設使用該配置。	當您需要頻繁調試代碼時，可選擇此功能。
   帶參運行（表徵圖）	每次運行都需為測試情境下的變數賦值常量，並指定調度資源群組。	當您需要修改代碼中變數的賦值，或修改任務使用的調度資源群組時，可選擇此功能。
   快捷運行（表徵圖）	支援在節點編輯頁面的代碼地區調試程式碼片段。	若您僅需調試節點中的程式碼片段，可選擇此功能。 說明 該功能僅用於調試部分代碼的正確性，如果需調試完整的代碼邏輯，請使用運行或進階運行。

調試運行商務程序

1. 資料開發（DataStudio）（舊版），在左側導覽列的資料開發或手動商務程序模組，雙擊目標商務程序，進入該商務程序面板。

2. 調試運行商務程序。

   單擊商務程序面板工具列的運行（表徵圖），即可按照依賴關係，依次運行整個商務程序中的任務。

   您也可以在商務程序面板中，按右鍵指定節點，選擇運行節點及下遊，按照依賴關係運行該節點及其所有下遊節點。

   工具列運行與右鍵運行節點及下遊的機制存在差異：

   • 工具列運行：按照商務程序的完整DAG依賴關係，從上遊到下遊依次運行所有節點。每個節點獨立提交運行，等效於逐一在節點編輯頁面執行運行操作。

   • 右鍵運行節點及下遊：從選定節點開始，帶入依賴調度邏輯運行該節點及其下遊節點。該方式會校正上遊節點的運行狀態和輸出，與在節點編輯頁面直接運行（獨立偵錯模式）的行為不同。

   如果右鍵運行節點及下遊時報錯，但在節點編輯頁面直接運行同一SQL無異常，原因在於右鍵運行會帶入調度依賴邏輯，校正上遊節點的運行狀態和輸出資料，而直接運行僅執行當前節點的SQL代碼。排查方向如下：

   • 檢查上遊節點的運行狀態。右鍵運行會校正上遊依賴，上遊節點未運行或運行失敗會導致當前節點報錯。在商務程序面板中查看上遊節點的運行狀態表徵圖，確認所有上遊節點均已運行成功。

   • 檢查節點間的依賴配置。確認節點的輸入輸出參數傳遞是否正確，調度參數賦值是否與預期一致。在節點的調度配置頁面，檢查上遊輸出表與當前節點輸入表是否匹配。

   • 按右鍵報錯節點，選擇查看作業記錄，定位具體的錯誤資訊。日誌中的報錯通常包含具體的錯誤原因（如表不存在、許可權不足、語法錯誤等）。

   • 檢查SQL中是否存在注釋文法問題。部分引擎在調度模式下對注釋的解析方式與直接運行不同，可能導致文法報錯。排查時可先移除SQL中的塊注釋（/* */），僅保留行注釋（--），確認是否仍然報錯。

   • 檢查上遊節點的輸出資料是否已就緒。右鍵運行依賴上遊節點產生的資料表作為輸入，若上遊節點雖運行成功但輸出資料尚未就緒或被清理，當前節點會因讀取不到輸入表而報錯。

   說明

   • 當手動商務程序中各節點存在同名變數，並且該變數可進行統一賦值時，您可在商務程序面板定義使用流程參數並為參數賦值，通過運行商務程序，查看賦值結果及手動任務的執行情況。

   • 僅部分類型節點支援使用流程參數，具體請以實際介面為準。

   • 運行完成後，可在商務程序面板中，按右鍵指定節點，查看該節點的作業記錄。

查看運行歷史

您可進入資料開發（DataStudio）的運行歷史頁面，查看當前登入帳號近三天在資料開發介面運行過的所有任務記錄。

任務在資料開發（DataStudio）運行後，將下發至對應引擎的服務執行，即使在任務運行過程中，您不小心將任務關閉，該任務仍會繼續執行。您可進入運行歷史頁面，查看任務作業記錄或停止已經下發執行的任務。

建立臨時查詢檔案

處理查詢結果