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