Dataphin提供全域變數設定能力,將頻繁使用的變數設定為全域變數,可以避免在任務代碼中重複定義,減少後期維護成本。同時,全域變數包含許可權管控和代碼審核,提高變數使用的安全性。本文為您介紹如何建立變數組和全域變數。
建立變數組
變數組用於對建立的變數進行分組,方便後續尋找與管理。
在Dataphin首頁的頂部功能表列中,選擇規劃 > 公用定義。
在公用定義頁面,單擊全域變數頁簽。
在全域變數頁簽下,單擊建立變數組,開啟建立變數組對話方塊。
在建立變數組對話方塊,按照下表說明填寫變數組名稱和變數組編碼。
參數
描述
變數組名稱
自訂變數組名稱。名稱要求:
全域唯一。
不能超過64個字元。
變數組編碼
自訂變數組編碼,變數組的唯一性校正。設定要求如下:
全域唯一。
由數字、字母、底線組成。
不能超過64個字元。
單擊確定,完成變數組建立。
建立全域變數
在全域變數頁簽下,單擊建立全域變數。
在建立全域變數對話方塊,配置全域變數參數。
變數類型支援普通變數、日期時間、帳號密碼共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。
快捷日期選擇:常用變數日期。
設定快捷日期選擇後,會在變數日期中自動填滿其對應的計算邏輯。您也可以自訂設定變數日期。
預覽基準時間:預覽變數值時的基準時間,僅用於預覽配置效果。
變數日期:定義變數的計算邏輯,以基準日期為輸入 ,進行年、季、月、周、日維度位移。
如果添加位移時間,則每一行計算的輸入日期是上一行計算的輸出日期。
變數日期設定後:
在日期預覽,查看本行計算後得到的日期。
在變數輸出格式,查看本行計算後的變數值,按照您選擇的變數輸出格式展示。
快捷時間選擇:設定快捷時間選擇後,會在變數時間中自動填滿其對應的計算邏輯。您也可以自訂設定變數時間。
變數時間:定義變數的計算邏輯,以基準日期為輸入 ,進行日、時、分、秒維度位移。
如果添加位移時間,則每一行計算的輸入日期是上一行計算的輸出日期。
變數時間設定後:
在時間預覽,查看本行計算後得到的時間。
在變數輸出格式,查看本行計算後的變數值,按照您選擇的變數輸出格式展示。
單擊確定,完成全域變數建立。
管理變數組和全域變數
變數組支援的操作
預設變數組不支援編輯和刪除操作。
變數組下存在變數時,不支援編輯和刪除操作。
操作項 | 說明 |
編輯 | 編輯變數組的名稱和編碼。
|
刪除 | 單擊目標變數組操作列(即全域變數列表中最後一列)的刪除表徵圖,刪除當前變數組。 |
全域變數支援的操作
系統變數不支援任何操作。
操作項 | 說明 |
搜尋 | 在搜尋欄中輸入關鍵詞後,系統將自動匹配變數名稱、編碼和值/計算邏輯(不匹配帳號密碼類型變數的值),並篩選出相關的全域變數。 |
編輯 | 單擊目標全域變數操作列(即全域變數列表中倒數第二列)的編輯表徵圖,開啟編輯全域變數對話方塊,在對話方塊中編輯相關參數,參數配置說明同建立操作,詳情請參見建立全域變數。編輯完成後將產生一個新版本。 說明
|
查看依賴 | 查看所有引用當前全域變數,且已提交的整合和計算任務。
|
刪除 | 重要 僅支援刪除無依賴的全域變數,刪除後無法恢複,請謹慎操作。 單擊目標全域變數操作列(即全域變數列表中倒數第二列)的刪除表徵圖,在彈出的對話方塊中單擊確認,完成刪除。 |
查看歷史版本 | 單擊目標全域變數操作列(即全域變數列表中倒數第二列)的查看歷史版本表徵圖,在查看歷史版本對話方塊中查看版本列表,包含版本號碼、提交人、提交時間、值/計算邏輯、描述,可單擊目標版本操作列的版本對比或版本復原表徵圖做相應操作。
|
申請許可權 | 單擊目標全域變數操作列(即全域變數列表中倒數第二列)的更多表徵圖,選擇申請許可權,跳轉至申請變數許可權對話方塊中,填寫相關參數配置,完成許可權申請,詳情請參見申請、續期和交還變數許可權。 |