通過參數配置,可以對Notebook或SQL查詢中的SQL代碼所使用的參數變數進行賦值。在SQL代碼運行時,參數變數將自動被替換為相應的值。本文為您介紹如何配置參數。
操作步驟
以下操作步驟以SQL查詢為例,Notebook和SQL查詢任務的參數配置操作路徑相同。
在Dataphin首頁的頂部功能表列中,選擇分析 > SQL查詢/Notebook。
在SQL查詢列表中,選擇待配置參數的目標任務,在該任務的編輯地區中,單擊頂部的
表徵圖,進入參數配置對話方塊。在屬性面板的參數配置對話方塊中,配置任務的參數資訊。
欄位
描述
資料來源模式
資料來源SQL查詢支援配置資料來源模式。若資料來源為Dev-Prod模式,支援選擇開發或生產;若資料來源為Basic模式,僅支援選擇生產。
重要若選擇生產,執行語句後將改變生產環境資料,請謹慎操作。
參數名稱
參數名稱為您在SQL代碼中定義的變數名稱。在SQL中您可以通過運算式方式新增參數,系統將自動載入SQL中已有的參數。運算式格式:
${變數名}。參數類型
單擊參數類型下拉框,支援修改參數的類型。包括全域變數、空間名稱變數、本地變數、跨節點變數和非變數類型。更多資訊,請參見參數名稱。
選中多個參數或全選後,單擊參數列表底部的修改參數類型,可批量修改參數類型。
說明出於資料安全考慮,帳號密碼類型的全域變數在此無法使用,將被視作本地變數,需要手動賦值。
若引用了開啟許可權管控的全域變數,系統將自動校正目前使用者是否擁有許可權,無許可權的全域變數將以
表徵圖標識,您可單擊申請許可權,跳轉至許可權管理 > 變數許可權管理頁面進行許可權申請。分析平台內不支援空間名稱變數。如果
variable_name與某個生產專案或者生產板塊的名稱一致,會被視作本地變數。
參數值
請輸入變數所需替換的參數值。最長支援256位,支援填充空值。您也可以針對日期時間進行運算。具體操作,請參見變數賦值
操作
支援轉為本地變數和忽略操作。
轉為本地變數:參數配置時如果您的變數與某個全域變數名稱一致,會被系統優先視作引用了全域變數,您可單擊對應參數操作列的
表徵圖,將其類型轉換為本地變數,或者將本地變數轉換為全域變數。忽略:如果您代碼中
${變數名}是代碼內容的一部分,而不是變數,可單擊對應參數操作列的
表徵圖,忽略該變數。
單擊確定。
重要單個SQL運行時,僅需配置當前SQL中未配置的參數,且配置的值將在該任務中全域生效。