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。
快捷日期选择:常用变量日期。
设置快捷日期选择后,会在变量日期中自动填充其对应的计算逻辑。您也可以自定义设置变量日期。
预览基准时间:预览变量值时的基准时间,仅用于预览配置效果。
变量日期:定义变量的计算逻辑,以基准日期为输入 ,进行年、季、月、周、日维度的偏移。
如果添加偏移时间,则每一行计算的输入日期是上一行计算的输出日期。
变量日期设置后:
在日期预览,查看本行计算后得到的日期。
在变量输出格式,查看本行计算后的变量值,按照您选择的变量输出格式展示。
快捷时间选择:设置快捷时间选择后,会在变量时间中自动填充其对应的计算逻辑。您也可以自定义设置变量时间。
变量时间:定义变量的计算逻辑,以基准日期为输入 ,进行日、时、分、秒维度的偏移。
如果添加偏移时间,则每一行计算的输入日期是上一行计算的输出日期。
变量时间设置后:
在时间预览,查看本行计算后得到的时间。
在变量输出格式,查看本行计算后的变量值,按照您选择的变量输出格式展示。
单击确定,完成全局变量新建。