变量组及全局变量

Dataphin提供全局变量设置能力,将频繁使用的变量设置为全局变量,可以避免在任务代码中重复定义,减少后期维护成本。同时,全局变量包含权限管控和代码审核,提高变量使用的安全性。本文为您介绍如何新建变量组和全局变量。

新建变量组

变量组用于对创建的变量进行分组,方便后续查找与管理。

  1. Dataphin首页的顶部菜单栏中,选择规划 > 公共定义

  2. 公共定义页面,单击全局变量页签。

  3. 全局变量页签下,单击新建变量组,打开新建变量组对话框。

  4. 新建变量组对话框,按照下表说明填写变量组名称变量组编码

    参数

    描述

    变量组名称

    自定义变量组名称。名称要求:

    • 全局唯一。

    • 不能超过64个字符。

    变量组编码

    自定义变量组编码,变量组的唯一性校验。设置要求如下:

    • 全局唯一。

    • 由数字、字母、下划线组成。

    • 不能超过64个字符。

  5. 单击确定,完成变量组新建。

新建全局变量

  1. 全局变量页签下,单击新建全局变量

  2. 新建全局变量对话框,配置全局变量参数。

    变量类型支持普通变量日期时间账号密码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时间戳,指从19701100分开始到现在所经过的秒数。例如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时间戳,指从19701100分开始到现在所经过的秒数。例如2022-06-04 00:00:00转换为UNIX时间戳,输出后的变量格式显示为1654272000。

    • 快捷日期选择:常用变量日期。

      设置快捷日期选择后,会在变量日期中自动填充其对应的计算逻辑。您也可以自定义设置变量日期

    • 预览基准时间:预览变量值时的基准时间,仅用于预览配置效果。

    • 变量日期:定义变量的计算逻辑,以基准日期为输入 ,进行维度的偏移。

      如果添加偏移时间,则每一行计算的输入日期是上一行计算的输出日期。

      变量日期设置后:

      • 日期预览,查看本行计算后得到的日期。

      • 变量输出格式,查看本行计算后的变量值,按照您选择的变量输出格式展示。

    • 快捷时间选择:设置快捷时间选择后,会在变量时间中自动填充其对应的计算逻辑。您也可以自定义设置变量时间

    • 变量时间:定义变量的计算逻辑,以基准日期为输入 ,进行维度的偏移。

      如果添加偏移时间,则每一行计算的输入日期是上一行计算的输出日期。

      变量时间设置后:

      • 时间预览,查看本行计算后得到的时间。

      • 变量输出格式,查看本行计算后的变量值,按照您选择的变量输出格式展示。

  3. 单击确定,完成全局变量新建。

管理变量组和全局变量

变量组支持的操作

说明
  • 默认变量组不支持编辑和删除操作。

  • 变量组下存在变量时,不支持编辑和删除操作。

操作项

说明

编辑

编辑变量组的名称和编码。

  1. 单击目标变量组操作列(即全局变量列表中最后一列)的编辑图标,打开编辑变量组对话框。

  2. 编辑变量组对话框中,编辑变量的名称编码,命名要求同新建操作,详情请参见新建变量组

  3. 编辑完成后,单击确定

删除

单击目标变量组操作列(即全局变量列表中最后一列)的删除图标,删除当前变量组。

全局变量支持的操作

说明

系统变量不支持任何操作。

操作项

说明

搜索

在搜索栏中输入关键词后,系统将自动匹配变量名称、编码和值/计算逻辑(不匹配账号密码类型变量的值),并筛选出相关的全局变量。

编辑

单击目标全局变量操作列(即全局变量列表中倒数第二列)的编辑图标,打开编辑全局变量对话框,在对话框中编辑相关参数,参数配置说明同新建操作,详情请参见新建全局变量。编辑完成后将生成一个新版本。

说明
  • 账号密码日期时间类型的全局变量不支持修改变量类型

  • 普通变量支持转为账号密码类型变量,转变为账号密码变量后,将自动开启权限管控和代码审核,当前引用该变量的生产任务默认无权限,请提前授权。

查看依赖

查看所有引用当前全局变量,且已提交的集成和计算任务。

  1. 单击目标全局变量操作列(即全局变量列表中倒数第二列)的查看依赖图标,打开查看依赖对话框。

  2. 依赖对象列表中展示对象名称对象空间对象类型引用时间,可单击目标对象操作列的查看图标,跳转至对应集成或计算任务开发页面。

删除

重要

仅支持删除无依赖的全局变量,删除后无法恢复,请谨慎操作。

单击目标全局变量操作列(即全局变量列表中倒数第二列)的删除图标,在弹出的对话框中单击确认,完成删除。

查看历史版本

单击目标全局变量操作列(即全局变量列表中倒数第二列)的查看历史版本图标,在查看历史版本对话框中查看版本列表,包含版本号提交人提交时间值/计算逻辑描述,可单击目标版本操作列的版本对比版本回滚图标做相应操作。

  • 版本对比:跳转至版本对比页面,默认使用当前版本与所选版本进行对比,差异信息将高亮显示。

  • 版本回滚:单击对应版本操作列的版本回滚图标,回滚至该版本。

    说明

    版本回滚时,若当前版本为账号密码类型变量,目标版本为普通变量,则回滚至目标版本时,变量类型将转为普通变量。

申请权限

单击目标全局变量操作列(即全局变量列表中倒数第二列)的更多图标,选择申请权限,跳转至申请变量权限对话框中,填写相关参数配置,完成权限申请,详情请参见申请、续期和交还变量权限