全部產品
Search
文件中心

Dataphin:變數組及全域變數

更新時間:Jul 08, 2025

Dataphin提供全域變數設定能力,將頻繁使用的變數設定為全域變數,可以避免在任務代碼中重複定義,減少後期維護成本。同時,全域變數包含許可權管控和代碼審核,提高變數使用的安全性。本文為您介紹如何建立變數組和全域變數。

建立變數組

變數組用於對建立的變數進行分組,方便後續尋找與管理。

  1. 在Dataphin首頁的頂部功能表列中,選擇規劃 > 公用定義

  2. 公用定義頁面,單擊全域變數頁簽。

  3. 全域變數頁簽下,單擊建立變數組,開啟建立變數組對話方塊。

  4. 建立變數組對話方塊,按照下表說明填寫變數組名稱變數組編碼

    參數

    描述

    變數組名稱

    自訂變數組名稱。名稱要求:

    • 全域唯一。

    • 不能超過64個字元。

    變數組編碼

    自訂變數組編碼,變數組的唯一性校正。設定要求如下:

    • 全域唯一。

    • 由數字、字母、底線組成。

    • 不能超過64個字元。

  5. 單擊確定,完成變數組建立。

建立全域變數

  1. 全域變數頁簽下,單擊建立全域變數

  2. 建立全域變數對話方塊,配置全域變數參數。

    變數類型支援普通變數日期時間帳號密碼共3種變數類型,各變數類型配置不同。各變數型別參數說明詳情如下:

    普通變數、帳號密碼

    參數

    描述

    基本資料

    變數名稱

    自訂變數名稱。不能超過64個字元。

    變數組

    預設為預設變數組。您可以單擊下拉式清單選擇其他的變數組。

    編碼

    自訂編碼,變數的引用名稱,固定首碼為dp_glb。設定要求如下:

    • 全域唯一。

    • 由數字、英文、底線(_)組成。

    • 不能超過64個字元(含dp_glb_ 的總長度)。

    說明

    編碼不區分大小寫,大寫字母將統一轉換為小寫字母。

    許可權管控

    開啟後,初次引用所建立的全域變數時,需要申請許可權。

    代碼審核

    開啟後,可以指定代碼審核人,在代碼中如果引用該全域變數,提交時需要代碼審核人審核通過。

    描述

    自訂描述。全域變數備忘資訊。

    變數值

    生產開發環境隔離

    • 關閉:生產和開發環境使用同一個變數值。

    • 開啟:可以針對生產和開發環境分別設定變數的取值,開發環境調試運行時, 取開發值;生產環境周期調度及手動運行時取生產值。

    變數值

    設定生產或開發環境的變數值,區分大小寫。

    • 普通變數要求不能超過512個字元。

    • 帳號密碼要求不能超過5000個字元。

    日期時間

    參數

    描述

    基本資料

    變數名稱

    自訂變數名稱。不能超過64個字元。

    編碼

    自訂編碼,變數的引用名稱,固定首碼為dp_glb。設定要求如下:

    • 全域唯一。

    • 由數字、英文、底線(_)組成。

    • 不能超過64個字元(含dp_glb_ 的總長度)。

    說明

    編碼不區分大小寫,大寫字母將統一轉換為小寫字母。

    變數組

    預設為預設變數組。您可以單擊下拉式清單選擇其他的變數組。

    許可權管控

    開啟後,初次引用所建立的全域變數時,需要申請許可權。

    代碼審核

    開啟後,可以指定代碼審核人,在代碼中如果引用該全域變數,提交時需要代碼審核人審核通過。

    描述

    自訂描述。全域變數備忘資訊。

    變數值

    生產開發環境隔離

    • 關閉:生產和開發環境使用同一個變數值。

    • 開啟:可以針對生產和開發環境分別設定變數的取值,開發環境調試運行時, 取開發值;生產環境周期調度及手動運行時取生產值。

    基準日期類型選擇為業務日期(bizdate-年月日)

    適用於所有任務。

    • 變數輸出格式:日期時間變數計算後,結果傳回值的格式。單擊下拉式清單可以進行選擇,格式包括:

      • yyyyMMdd年月日。例如20220604。

      • yyyy-MM-dd年-月-日。例如2022-06-04。

      • yyyy/MM/dd年/月/日。例如2022/06/04。

      • yyyyMMddHHmmss年月日時分秒。例如20220604000000。

      • yyyy-MM-dd HH:mm:ss年-月-日 時:分:秒。例如2022-06-04 00:00:00。

      • unixtimestamp:UNIX時間戳記,指從1970年1月1日0時0分開始到現在所經過的秒數。例如2022-06-04 00:00:00轉換為UNIX時間戳記,輸出後的變數格式顯示為1654272000。

    • 快捷日期選擇:常用變數日期。

      設定快捷日期選擇後,會在變數日期中自動填滿其對應的計算邏輯。您也可以自訂設定變數日期

    • 預覽基準日期:預覽變數值時的基準日期,僅用於預覽配置效果。

    • 變數日期:定義變數的計算邏輯,以基準日期為輸入 ,進行維度位移。

      如果添加位移時間,則每一行計算的輸入日期是上一行計算的輸出日期。

      變數日期設定後:

      • 日期預覽,查看本行計算後得到的日期。

      • 變數輸出格式,查看本行計算後的變數值,按照您選擇的變數輸出格式展示。

    基準日期類型選擇為業務時間(bizdatetime-年月日時分秒)

    僅用於小時、分鐘調度的任務。

    • 變數輸出格式:日期時間變數計算後,結果傳回值的格式。單擊下拉式清單可以進行選擇,格式包括:

      • yyyyMMdd年月日。例如20220604。

      • yyyy-MM-dd年-月-日。例如2022-06-04。

      • yyyy/MM/dd年/月/日。例如2022/06/04。

      • yyyyMMddHHmmss年月日時分秒。例如20220604000000。

      • yyyy-MM-dd HH:mm:ss年-月-日 時:分:秒。例如2022-06-04 00:00:00。

      • unixtimestamp:UNIX時間戳記,指從1970年1月1日0時0分開始到現在所經過的秒數。例如2022-06-04 00:00:00轉換為UNIX時間戳記,輸出後的變數格式顯示為1654272000。

    • 快捷日期選擇:常用變數日期。

      設定快捷日期選擇後,會在變數日期中自動填滿其對應的計算邏輯。您也可以自訂設定變數日期

    • 預覽基準時間:預覽變數值時的基準時間,僅用於預覽配置效果。

    • 變數日期:定義變數的計算邏輯,以基準日期為輸入 ,進行維度位移。

      如果添加位移時間,則每一行計算的輸入日期是上一行計算的輸出日期。

      變數日期設定後:

      • 日期預覽,查看本行計算後得到的日期。

      • 變數輸出格式,查看本行計算後的變數值,按照您選擇的變數輸出格式展示。

    • 快捷時間選擇:設定快捷時間選擇後,會在變數時間中自動填滿其對應的計算邏輯。您也可以自訂設定變數時間

    • 變數時間:定義變數的計算邏輯,以基準日期為輸入 ,進行維度位移。

      如果添加位移時間,則每一行計算的輸入日期是上一行計算的輸出日期。

      變數時間設定後:

      • 時間預覽,查看本行計算後得到的時間。

      • 變數輸出格式,查看本行計算後的變數值,按照您選擇的變數輸出格式展示。

  3. 單擊確定,完成全域變數建立。

管理變數組和全域變數

變數組支援的操作

說明
  • 預設變數組不支援編輯和刪除操作。

  • 變數組下存在變數時,不支援編輯和刪除操作。

操作項

說明

編輯

編輯變數組的名稱和編碼。

  1. 單擊目標變數組操作列(即全域變數列表中最後一列)的編輯表徵圖,開啟編輯變數組對話方塊。

  2. 編輯變數組對話方塊中,編輯變數的名稱編碼,命名要求同建立操作,詳情請參見建立變數組

  3. 編輯完成後,單擊確定

刪除

單擊目標變數組操作列(即全域變數列表中最後一列)的刪除表徵圖,刪除當前變數組。

全域變數支援的操作

說明

系統變數不支援任何操作。

操作項

說明

搜尋

在搜尋欄中輸入關鍵詞後,系統將自動匹配變數名稱、編碼和值/計算邏輯(不匹配帳號密碼類型變數的值),並篩選出相關的全域變數。

編輯

單擊目標全域變數操作列(即全域變數列表中倒數第二列)的編輯表徵圖,開啟編輯全域變數對話方塊,在對話方塊中編輯相關參數,參數配置說明同建立操作,詳情請參見建立全域變數。編輯完成後將產生一個新版本。

說明
  • 帳號密碼日期時間類型的全域變數不支援修改變數類型

  • 普通變數支援轉為帳號密碼類型變數,轉變為帳號密碼變數後,將自動開啟許可權管控和代碼審核,當前引用該變數的生產任務預設無許可權,請提前授權。

查看依賴

查看所有引用當前全域變數,且已提交的整合和計算任務。

  1. 單擊目標全域變數操作列(即全域變數列表中倒數第二列)的查看依賴表徵圖,開啟查看依賴對話方塊。

  2. 依賴對象列表中展示對象名稱對象空間物件類型引用時間,可單擊目標對象操作列的查看表徵圖,跳轉至對應整合或計算任務開發頁面。

刪除

重要

僅支援刪除無依賴的全域變數,刪除後無法恢複,請謹慎操作。

單擊目標全域變數操作列(即全域變數列表中倒數第二列)的刪除表徵圖,在彈出的對話方塊中單擊確認,完成刪除。

查看歷史版本

單擊目標全域變數操作列(即全域變數列表中倒數第二列)的查看歷史版本表徵圖,在查看歷史版本對話方塊中查看版本列表,包含版本號碼提交人提交時間值/計算邏輯描述,可單擊目標版本操作列的版本對比版本復原表徵圖做相應操作。

  • 版本對比:跳轉至版本對比頁面,預設使用目前的版本與所選版本進行對比,差異資訊將高亮顯示。

  • 版本復原:單擊對應版本操作列的版本復原表徵圖,復原至該版本。

    說明

    版本復原時,若目前的版本為帳號密碼類型變數,目標版本為普通變數,則復原至目標版本時,變數類型將轉為普通變數。

申請許可權

單擊目標全域變數操作列(即全域變數列表中倒數第二列)的更多表徵圖,選擇申請許可權,跳轉至申請變數許可權對話方塊中,填寫相關參數配置,完成許可權申請,詳情請參見申請、續期和交還變數許可權