全部產品
Search
文件中心

Dataphin:配置離線任務運行參數

更新時間:Jan 14, 2026

運行參數配置是對離線任務中所涉及的變數進行賦值,以便在節點調度時,參數變數能夠自動被替換為相應的變數值。本文為您介紹如何配置參數及使用節點參數,並以MaxCompute SQL為例,講解參數配置。

操作步驟

  1. 在Dataphin首頁的頂部功能表列中,選擇研發 > 資料研發

  2. 開發頁面的頂部功能表列選擇專案(Dev-Prod模式需要選擇環境)。

  3. 在左側導覽列中選擇資料處理 > 計算任務

  4. 在計算工作清單中,單擊目標計算任務,開啟對應計算任務頁簽。

  5. 單擊頁面右側邊欄的屬性,開啟屬性面板,並在運行參數地區內配置以下參數。

    • 輸入參數

      在計算任務中通過運算式${變數名}配置的參數,系統將在運行參數地區進行展示。可以在運行參數列表中修改參數類型並對參數賦值。

      參數

      描述

      參數名稱

      代碼編輯器中定義的參數名稱。變數名稱僅包含數字、字母和底線(_),長度不超過32個字元。

      參數類型

      包括全域變數空間名稱變數本地變數跨節點變數非變數類型更多資訊,請參見變數分類

      選中多個參數或全選後,單擊參數列表底部的修改參數類型,可批量修改參數類型。

      參數值

      • 全域變數:預設為全域變數所定義的變數值,不支援設定。更多資訊,請參見建立全域變數

      • 空間名稱變數:參數值即為空白間名稱。

      • 本地變數:最長支援258個字元或設定為空白值。如需輸入日期時間,可選擇或參考列表中運算式,詳情請參見變數賦值

      • 跨節點變數:設定上遊依賴後,可以選擇上遊的跨節點輸出參數作為參數值。

      • 非變數:不支援定義。

      說明

      若引用了開啟許可權管控的全域變數,系統將自動校正目前使用者是否擁有許可權,無許可權的全域變數將以image表徵圖標識,您可單擊申請許可權,跳轉至許可權管理 > 變數許可權管理頁面進行許可權申請。

    • 跨節點輸出參數

      重要
      • 僅支援Python、SQL、Shell計算任務定義跨節點輸出參數。

      • 整合任務、計算任務、普通/層級維度邏輯表、事實邏輯表的輸入參數支援跨節點變數參數。

      透傳給本對象節點直接下遊節點的變數參數。須在本列表預先聲明定義,未聲明的輸出變數將被系統忽略。聲明後未在代碼中賦值的變數,將使用配置的預設值。在代碼編輯地區,可以通過按右鍵菜單設定跨節點參數對變數參數賦值。

      說明
      • 若需添加多個跨節點輸出參數,可以單擊+添加參數進行添加。

      • 跨節點輸出參數列表支援大量操作,勾選或全選跨節點輸出參數後,可以單擊image.png進行大量刪除。

      參數

      描述

      參數名稱

      長度不超過32個字元,僅支援數字、字母和底線(_)。

      參數說明

      參數的簡單描述,128個字元以內。

      預設值

      • 變數未被賦值時使用的預設值(預設值)。若需給跨節點輸出參數賦值,具體操作,請參見跨節點輸出參數賦值

      • 下遊(Down)節點引用了上遊(Up)節點的跨節點輸出參數,對下遊(Down)節點做補資料操作時,如果未勾選到上遊(Up)同一個補資料執行個體,下遊(Down)節點中跨節點輸入參數將從上遊(Up)的最近N天運行記錄中取值,若不存在運行記錄或超出N天,則取預設值。最近N天(N)預設為15天

      • 補資料時,建議同時勾選上遊(Up)節點和下遊(Down)節點。若上遊(Up)節點代碼中未對跨節點參數賦值,下遊(Down)節點也將使用缺失值。

  6. 單擊確定,完成計算任務運行參數配置。