運行參數配置是對離線任務中所涉及的變數進行賦值,以便在節點調度時,參數變數能夠自動被替換為相應的變數值。本文為您介紹如何配置參數及使用節點參數,並以MaxCompute SQL為例,講解參數配置。
操作步驟
在Dataphin首頁的頂部功能表列中,選擇研發 > 資料研發。
在開發頁面的頂部功能表列選擇專案(Dev-Prod模式需要選擇環境)。
在左側導覽列中選擇資料處理 > 計算任務。
在計算工作清單中,單擊目標計算任務,開啟對應計算任務頁簽。
單擊頁面右側邊欄的屬性,開啟屬性面板,並在運行參數地區內配置以下參數。
輸入參數
在計算任務中通過運算式
${變數名}配置的參數,系統將在運行參數地區進行展示。可以在運行參數列表中修改參數類型並對參數賦值。參數
描述
參數名稱
代碼編輯器中定義的參數名稱。變數名稱僅包含數字、字母和底線(_),長度不超過32個字元。
參數類型
包括全域變數、空間名稱變數、本地變數、跨節點變數和非變數類型。更多資訊,請參見變數分類。
選中多個參數或全選後,單擊參數列表底部的修改參數類型,可批量修改參數類型。
參數值
說明若引用了開啟許可權管控的全域變數,系統將自動校正目前使用者是否擁有許可權,無許可權的全域變數將以
表徵圖標識,您可單擊申請許可權,跳轉至許可權管理 > 變數許可權管理頁面進行許可權申請。跨節點輸出參數
重要僅支援Python、SQL、Shell計算任務定義跨節點輸出參數。
整合任務、計算任務、普通/層級維度邏輯表、事實邏輯表的輸入參數支援跨節點變數參數。
透傳給本對象節點直接下遊節點的變數參數。須在本列表預先聲明定義,未聲明的輸出變數將被系統忽略。聲明後未在代碼中賦值的變數,將使用配置的預設值。在代碼編輯地區,可以通過按右鍵菜單設定跨節點參數對變數參數賦值。
說明若需添加多個跨節點輸出參數,可以單擊+添加參數進行添加。
跨節點輸出參數列表支援大量操作,勾選或全選跨節點輸出參數後,可以單擊
進行大量刪除。
參數
描述
參數名稱
長度不超過32個字元,僅支援數字、字母和底線(_)。
參數說明
參數的簡單描述,128個字元以內。
預設值
變數未被賦值時使用的預設值(預設值)。若需給跨節點輸出參數賦值,具體操作,請參見跨節點輸出參數賦值。
下遊(Down)節點引用了上遊(Up)節點的跨節點輸出參數,對下遊(Down)節點做補資料操作時,如果未勾選到上遊(Up)同一個補資料執行個體,下遊(Down)節點中跨節點輸入參數將從上遊(Up)的最近N天運行記錄中取值,若不存在運行記錄或超出N天,則取預設值。最近N天(N)預設為15天。
補資料時,建議同時勾選上遊(Up)節點和下遊(Down)節點。若上遊(Up)節點代碼中未對跨節點參數賦值,下遊(Down)節點也將使用缺失值。
單擊確定,完成計算任務運行參數配置。