新建变量组及全局变量

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

新建变量组

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

  1. 在Dataphin首页,单击顶部菜单栏的规划

  2. 按照下图操作指引,进入新建变量组对话框。

    image

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

    参数

    说明

    变量组名称

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

    • 全局唯一。

    • 不能超过64个字符。

    变量组编码

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

    • 全局唯一。

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

    • 不能超过64个字符。

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

新建全局变量

  1. 公共定义页面的全局变量页签,单击新建全局变量

    image..png

  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时间戳,指从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。

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

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

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

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

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

        变量日期设置后:

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

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

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

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

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

        变量时间设置后:

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

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

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