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。
快捷日期选择:常用变量日期。
设置快捷日期选择后,会在变量日期中自动填充其对应的计算逻辑。您也可以自定义设置变量日期。
预览基准时间:预览变量值时的基准时间,仅用于预览配置效果。
变量日期:定义变量的计算逻辑,以基准日期为输入 ,进行年、季、月、周、日维度的偏移。
如果添加偏移时间,则每一行计算的输入日期是上一行计算的输出日期。
变量日期设置后:
在日期预览,查看本行计算后得到的日期。
在变量输出格式,查看本行计算后的变量值,按照您选择的变量输出格式展示。
快捷时间选择:设置快捷时间选择后,会在变量时间中自动填充其对应的计算逻辑。您也可以自定义设置变量时间。
变量时间:定义变量的计算逻辑,以基准日期为输入 ,进行日、时、分、秒维度的偏移。
如果添加偏移时间,则每一行计算的输入日期是上一行计算的输出日期。
变量时间设置后:
在时间预览,查看本行计算后得到的时间。
在变量输出格式,查看本行计算后的变量值,按照您选择的变量输出格式展示。
单击确定,完成全局变量新建。
管理变量组和全局变量
变量组支持的操作
默认变量组不支持编辑和删除操作。
变量组下存在变量时,不支持编辑和删除操作。
操作项 | 说明 |
编辑 | 编辑变量组的名称和编码。
|
删除 | 单击目标变量组操作列(即全局变量列表中最后一列)的删除图标,删除当前变量组。 |
全局变量支持的操作
系统变量不支持任何操作。
操作项 | 说明 |
搜索 | 在搜索栏中输入关键词后,系统将自动匹配变量名称、编码和值/计算逻辑(不匹配账号密码类型变量的值),并筛选出相关的全局变量。 |
编辑 | 单击目标全局变量操作列(即全局变量列表中倒数第二列)的编辑图标,打开编辑全局变量对话框,在对话框中编辑相关参数,参数配置说明同新建操作,详情请参见新建全局变量。编辑完成后将生成一个新版本。 说明
|
查看依赖 | 查看所有引用当前全局变量,且已提交的集成和计算任务。
|
删除 | 重要 仅支持删除无依赖的全局变量,删除后无法恢复,请谨慎操作。 单击目标全局变量操作列(即全局变量列表中倒数第二列)的删除图标,在弹出的对话框中单击确认,完成删除。 |
查看历史版本 | 单击目标全局变量操作列(即全局变量列表中倒数第二列)的查看历史版本图标,在查看历史版本对话框中查看版本列表,包含版本号、提交人、提交时间、值/计算逻辑、描述,可单击目标版本操作列的版本对比或版本回滚图标做相应操作。
|
申请权限 | 单击目标全局变量操作列(即全局变量列表中倒数第二列)的更多图标,选择申请权限,跳转至申请变量权限对话框中,填写相关参数配置,完成权限申请,详情请参见申请、续期和交还变量权限。 |