文档

发布任务

更新时间:

本文为您介绍数据准备中占位符和任务运行的配置。

前提条件

已完成数据的加工并导出数据,请参见输出数据

占位符管理

占位符管理用于配置在数据准备(轻量ETL)输入和输出组件可以引用的占位符,包括静态和动态占位符,可以用于周期动态运行任务。若您需要配置占位符时,单击主工具栏的全局参数图标。

image.png

占位符管理界面输入变量名查询默认值

image.png

占位符格式有静态占位符和动态占位符两种,可以在输入组件的过滤条件、输出组件的分区设置中被引用。

占位符格式设计

  • 占位符格式为KeyA = ValueA。其中KeyA为占位符名(变量名),ValueA为占位符值(固定值)。

  • 支持2种占位符格式:

    • 固定值格式,例如:user=myname

    • 动态值格式,例如: mydate=${bizdate}

动态占位符

动态占位符根据运行时间不同动态取不同值,可用于动态时间运行任务。动态占位符由基础日期占位符和时间间隔偏移两部分组成:

  • 日期动态占位符:提供基于业务日期和执行时间两种方式。

    • {yyyyMMdd}为业务日期,即当前更新数据日期的前一天,即T-1。

    • [yyyyMMdd]为执行日期,即当前更新数据的日期T。T为天的粒度。

  • 小时占位符的偏移:提供基于小时的偏移。

    • HH表示小时

    • mm表示分钟

    • ss表示秒

    • 小时的偏移:delta/24

    例如,在指定执行时间前1小时的表达式为:$[HH-1/24]

  • 分钟占位符的偏移:提供基于分钟偏移。

    • HH表示小时

    • mm表示分钟

    • ss表示秒

    • 分钟的偏移:delta/24/60

    例如,在业务日期前1分钟:${HHmmss-1/24/60}

  • 暂不支持秒。

类型

占位符格式

占位符说明

系统动态占位符

${bizdate}

业务日期,默认格式为${yyyyMMdd},运行任务时,前一天的日期,T-1。

例如,当前是2021-12-29,则${bizdate}20211228

${dueTime}

执行日期,默认格式为$[yyyyMMdd],运行任务时,当天的日期,即T。

例如,当前是2021-12-29,则${duedate}20211229

具体时间动态占位符,参考下表。

当前日期

基于业务日期(T-1)的配置

实际值

基于预计执行时间(T)的配置

实际值

2022-01-10

${yyyyMMdd}

20220109

$[yyyyMMdd]

20220110

2022-01-10

${yyyyMMdd-1}

20220108

$[yyyyMMdd-1]

20220109

2022-01-10

${yyyyMMdd-7}

20220102

$[yyyyMMdd-7]

20220103

2022-01-10

${yyyy-MM-dd}

2022-01-09

$[yyyy-MM-dd]

2022-01-10

2022-01-10

${yyyy-MM}

2022-01

$[yyyy-MM]

2022-01

2022-01-10

${yyyy-MM-1}

2021-12

$[yyyy-MM -1]

2021-12

2022-01-10

${yyyy}

2022

$[yyyy]

2022

2022-01-10

${yyyy+1}

2023

$[yyyy+1]

2023

2022-01-10

${yyyy/MM/dd HH:mm:ss}

2022/01/09 00:00:00

$[yyyy/MM/dd HH:mm:ss]

2022/01/10 00:00:00

2022-01-10

${yyyy/MM/dd HH:mm:ss-1/24}

2022/01/08 23:00:00

$[HH:mm:ss-5/24/60]

23:55:00

2022-01-10

${HH}

00

$[HH]

dueTime对应的小时

2022-01-10

${HH-1}

${HH-1/24}

23

$[HH-1]

$[HH-1/24]

dueTime对应的小时-1

任务运行配置

创建数据准备后,需要运行才可以在数据库表中写入数据。

  1. 进入数据准备页面

  2. 在主工具栏区域,单击运行配置图标。

    image.png

  3. 运行配置页面,配置运行类型和周期后,单击确定

    支持周期运行手动运行两种方式。

    • 选择手动运行,手动触发后,才会进行数据的更新。

    • 选择周期运行并配置时间后,则每月、每周、每日或每小时会定时进行数据的更新。

  4. 单击保存并发布

配置完成后,在数据准备列表页,您可以查看新创建任务的运行相关状态。

image

请参见查看任务运行状态