DataWorks在原有任務級別調度參數基礎上,新增工作空間級別的調度參數,如果同一個工作空間中的多個參數需配置為相同值,可以使用工作空間參數。工作空間參數可配置為脫敏展示,以保護您的敏感數據;同時,在標準模式工作空間下,生產環境和開發環境工作空間參數的取值可以不同。
相關介紹
調度參數是DataWorks任務調度時使用的參數,可根據您配置的參數取值規則,在每次任務運行時自動替換為真實的取值。更多調度參數的介紹及使用,詳情請參見調度參數。
前提條件
已創建工作空間。工作空間參數需在指定的工作空間內使用。創建工作空間,詳情請參見創建并管理工作空間。
已添加用戶至指定工作空間并授予空間管理員角色權限。僅工作空間管理員角色可創建工作空間參數。授權詳情請參見添加空間成員并管理成員角色權限。
已購買專業版及以上版本DataWorks產品。僅專業版及以上版本DataWorks支持使用工作空間參數。購買詳情請參見購買或升級DataWorks版本。
使用限制
僅獨享調度資源組支持該功能,公共調度資源組不支持。
2024年01月01日
之后購買的獨享調度資源組可正常使用該功能;2024年01月01日
之前購買的獨享調度資源組,需聯系技術支持人員升級才能正常使用該功能。
創建工作空間參數
進入工作空間參數創建入口。
進入運維中心頁面。
登錄DataWorks控制臺,切換至目標地域后,單擊左側導航欄的 ,在下拉框中選擇對應工作空間后單擊進入運維中心。
在運維中心左側導航單擊
,然后切換至工作空間參數頁簽。
創建工作空間參數。
在工作空間參數頁面,單擊新建工作空間參數,根據業務需要配置參數信息。
說明如您有大量全局參數需要創建,也可單擊批量新建工作空間參數,批量創建參數。
配置項
描述
參數名稱
自定義參數名稱,默認以workspace.固定格式開頭。參數名稱必須唯一。
責任人
設置工作空間參數的負責人。
說明空間管理員可以指定工作空間中的任意一個成員作為參數的責任人。
僅空間管理員可以修改、刪除所有工作空間參數。
如您需執行相關參數管理操作,可添加用戶至工作空間并授予相應角色權限,詳情請參見添加空間成員并管理成員角色權限。
適用工作空間
設置當前工作空間參數可用于哪個工作空間。配置完成后,后續此處配置的工作空間中的任務均可使用本次新增的工作空間參數。
說明列表僅展示當前登錄賬號作為空間管理員的工作空間。
每個工作空間參數僅支持選擇用于某一個工作空間中。
參數類型與參數值
用于定義當前工作空間參數后續在任務使用中的實際替換值,支持的參數類型及取值如下:
常量(明文):參數實際賦值為所有用戶可見的常量。例如,123。
常量(密文):參數實際賦值為脫敏展示(默認為******)的常量。常用于較敏感的數據使用。例如,輸入123則會顯示為******。
變量:參數的實際賦值會根據您配置的變量動態替換為相應值。
例如,參數值可配置為獲取任務的定時調度時間$[yyyy-mm-dd],獲取任務運行的業務日期${yyyy-mm-dd},更多賦值格式可參考調度參數支持的格式。
說明參數值支持配置為部分特殊字符,具體請以實際界面提示為準。
不支持在一個參數賦值中引用另一個工作空間參數。
另外,若您使用的是標準模式的工作空間,則可根據需要配置同一個參數在開發環境和生產環境的取值不同。工作空間模式介紹,詳情請參見必讀:簡單模式和標準模式的區別。
配置完成后,單擊確定,完成參數的創建。
使用工作空間參數
工作空間參數創建完成后,您需進入被授權的工作空間,在相應節點編輯頁面使用參數。工作空間參數的使用與調度參數相同,步驟如下:
先在節點任務代碼中定義變量。
進入節點編輯頁面的
區域,為變量賦值工作空間參數。
參數配置完成后您可預覽參數取值是否符合預期,并根據需要進行調整。更多調度參數的使用,詳情請參見配置并使用調度參數。
你可根據實際需要創建合適的節點,詳情請參見DataWorks節點合集。
節點使用空間參數后需在節點編輯頁面工具欄執行保存、提交操作,提交后才認為參數被引用成功。
2024年01月01日
之后購買的獨享調度資源組可正常使用該功能;2024年01月01日
之前購買的獨享調度資源組,需聯系技術支持人員升級才能正常使用該功能。
管理工作空間參數
在工作空間參數頁面,您可對工作空間參數執行如下管理操作:
僅擁有空間管理員角色的工作空間成員支持修改、刪除工作空間參數。
僅擁有開發、運維、空間管理員角色的工作空間成員支持查看工作空間參數的引用任務及版本。
添加用戶至工作空間并授權相關角色權限,詳情請參見添加空間成員并管理成員角色權限。
查看參數:您可查看參數詳情、適用工作空間、引用的任務等信息,根據任務ID即可跳轉至相應任務進行開發操作。
修改參數:
僅支持修改參數的責任人、取值及描述信息。參數每修改一次,都會生成一個新的版本。
若工作空間參數已被其他任務引用,修改參數將影響該任務中工作空間參數的取值情況,請謹慎操作。
修改后的參數配置,其生效時間最晚不超過10分鐘。
對比及回滾參數:您可查看參數歷史版本,并根據需要進行版本內容對比,回滾參數至所需版本。
刪除參數:
若工作空間參數已被其他任務引用,則無法刪除。
刪除參數將導致對應任務運行失敗,請謹慎操作。
刪除操作在工作空間參數頁面立即生效,刪除后您將無法在空間參數列表中找到該參數;但刪除參數的10分鐘內,引用該參數的任務,運行時可能仍可獲取到該參數的賦值情況。