任务参数

参数配置

概述

为使任务自动周期运行时能动态适配环境变化，taier提供了参数配置的功能，参数的应用场景十分广泛，例如同步任务中将增量数据写入Hive表的天分区，需要在分区填写栏支持系统变量。SQL任务中，需要将每天的数据写入新的分区，也需要引用变量

参数配置可分为系统参数和自定义参数

tip

系统参数是内置的，用户可在各任务类型中直接引用，当系统参数的格式或处理方式无法满足要求时，taier支持自定义参数

系统参数

变量参数变量含义日期格式
${bdp.system.bizdate}默认为计划运行日期的前一天yyyyMMdd
${bdp.system.bizdate2}默认为计划运行日期的前一天yyyy-MM-dd
${bdp.system.cyctime}计划时间yyyyMMddHHmmss
${bdp.system.premonth}计划运行时间上个月yyyyMM
${bdp.system.currmonth}计划运行时间的本月yyyyMM
${bdp.system.runtime}实际运行时间yyyyMMddHHmmss

自定义参数

定义

在代码中引用 ${key1} 、${key2}， 然后在任务参数->自定义参数配置编辑框设置key1=,key2=

在对应的编辑框中填入对应的替换格式

时间基准

在对自定义参数进行增减之前，需明确取值的时间基准，Taier支持2种基准线，在右侧的参数面板中分别使用$[]、 $()2种不同的括号，区分2种时间基准，下面举例说明：

实例的计划运行时间：2022-02-06 12:10:00 实例的实际运行时间：2022-02-06 12:13:31

替换规则

基准线引用方式替换格式输出结果
计划时间$[]$[yyyy-MM-dd HH:mm:ss]2022-02-06 12:10:00
运行时间$()$(yyyy-MM-dd HH:mm:ss)2022-02-06 12:13:31

时间操作

基于计划时间取值的时间增减如下，基于业务日期、运行时间的时间增减方式类似，不再列出

  • 后N年：$[add_months(yyyyMMdd,12*N)]，输出yyyyMMdd
  • 前N年：$[add_months(yyyyMMdd,-12*N)]，输出yyyyMMdd
  • 后N月：$[add_months(yyyyMMdd,N)]，输出yyyyMMdd
  • 前N月：$[add_months(yyyyMMdd,-N)]，输出yyyyMMdd
  • 后N周：$[yyyyMMdd+7*N]，输出yyyyMMdd
  • 前N周：$[yyyyMMdd-7*N]，输出yyyyMMdd
  • 后N天：$[yyyyMMdd+N]，输出yyyyMMdd
  • 前N天：$[yyyyMMdd-N]，输出yyyyMMdd
  • 后N小时：$[hh24miss+N/24]，输出yyyyMMddHHmmss
  • 前N小时：$[hh24miss-N/24]，输出yyyyMMddHHmmss
  • 后N分钟：$[hh24miss+N/24/60]，输出yyyyMMddHHmmss
  • 前N分钟：$[hh24miss-N/24/60]，输出yyyyMMddHHmmss

分隔符

在时间增减的基础上，可增加各时间元素之间的分隔符，如下例： 后N年：$[add_months(yyyyMMdd,12*N,-)]，输出yyyy-MM-dd，在完成日期加减后，后面可输入 - 其中的 - 表示各元素的分隔符，例如$[add_months(yyyyMMdd,12*N,-)]

tip

此规则适用于时间操作的所有格式