全部產品
Search
文件中心

Dataphin:參數配置

更新時間:May 29, 2025

通過參數配置,可以對Notebook或SQL查詢中的SQL代碼所使用的參數變數進行賦值。在SQL代碼運行時,參數變數將自動被替換為相應的值。本文為您介紹如何配置參數。

操作步驟

以下操作步驟以SQL查詢為例,Notebook和SQL查詢任務的參數配置操作路徑相同。

  1. 在Dataphin首頁的頂部功能表列中,選擇分析 > SQL查詢/Notebook

  2. 在SQL查詢列表中,選擇待配置參數的目標任務,在該任務的編輯地區中,單擊頂部的image..png表徵圖,進入參數配置對話方塊。

  3. 在屬性面板的參數配置對話方塊中,配置任務的參數資訊。

    欄位

    描述

    資料來源模式

    資料來源SQL查詢支援配置資料來源模式。若資料來源為Dev-Prod模式,支援選擇開發生產;若資料來源為Basic模式,僅支援選擇生產。

    重要

    若選擇生產,執行語句後將改變生產環境資料,請謹慎操作。

    參數名稱

    參數名稱為您在SQL代碼中定義的變數名稱。在SQL中您可以通過運算式方式新增參數,系統將自動載入SQL中已有的參數。運算式格式${變數名}

    參數類型

    單擊參數類型下拉框,支援修改參數的類型。包括全域變數空間名稱變數本地變數跨節點變數非變數類型更多資訊,請參見參數名稱

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

    說明
    • 出於資料安全考慮,帳號密碼類型的全域變數在此無法使用,將被視作本地變數,需要手動賦值。

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

    • 分析平台內不支援空間名稱變數。如果variable_name與某個生產專案或者生產板塊的名稱一致,會被視作本地變數。

    參數值

    請輸入變數所需替換的參數值。最長支援256位,支援填充空值。您也可以針對日期時間進行運算。具體操作,請參見變數賦值

    操作

    支援轉為本地變數和忽略操作。

    • 轉為本地變數:參數配置時如果您的變數與某個全域變數名稱一致,會被系統優先視作引用了全域變數,您可單擊對應參數操作列的image表徵圖,將其類型轉換為本地變數,或者將本地變數轉換為全域變數。

    • 忽略:如果您代碼中${變數名}是代碼內容的一部分,而不是變數,可單擊對應參數操作列的image表徵圖,忽略該變數。

  4. 單擊確定

    重要

    單個SQL運行時,僅需配置當前SQL中未配置的參數,且配置的值將在該任務中全域生效。