Apache DolphinScheduler 使用文档（7/8）：系统参数及自定义参数

本文章经授权转载，原文链接：

https://blog.csdn.net/MiaoSO/article/details/104770720

目录

7. 参数

• 7.1 系统参数

• 7.2 时间自定义参数

• 7.3 用户自定义参数

---

7. 参数

7.1 系统参数

• ${system.biz.date} : 日常调度实例定时的定时时间前一天，格式为 yyyyMMdd，补数据时，该日期 +1

• ${system.biz.curdate} : 日常调度实例定时的定时时间，格式为 yyyyMMdd，补数据时，该日期 +1

• ${system.datetime} : 日常调度实例定时的定时时间，格式为 yyyyMMddHHmmss，补数据时，该日期 +1

7.2 时间自定义参数

时间自定义参数支持代码中自定义变量名，声明方式：${变量名}。可以是引用 "系统参数" 或指定 "常量"。

我们定义这种基准变量为 [...] 格式的，[yyyyMMddHHmmss] 是可以任意分解组合的，比如：$[yyyyMMdd], $[HHmmss], $[yyyy-MM-dd] 等。

例：

• 后 N 年：$[add_months(yyyyMMdd,12*N)]

• 前 N 年：$[add_months(yyyyMMdd,-12*N)]

• 后 N 月：$[add_months(yyyyMMdd,N)]

• 前 N 月：$[add_months(yyyyMMdd,-N)]

• 后 N 周：$[yyyyMMdd+7*N]

• 前 N 周：$[yyyyMMdd-7*N]

• 后 N 天：$[yyyyMMdd+N]

• 前 N 天：$[yyyyMMdd-N]

• 后 N 小时：$[HHmmss+N/24]

• 前 N 小时：$[HHmmss-N/24]

• 后 N 分钟：$[HHmmss+N/24/60]

• 前 N 分钟：$[HHmmss-N/24/60]

7.3 用户自定义参数

用户自定义参数分为全局参数和局部参数。
全局参数是保存工作流定义和工作流实例的时候传递的全局参数，全局参数可以在整个流程中的任何一个任务节点的局部参数引用。

例：

项目管理 -> 工作流 -> 工作流定义 -> 创建工作流
------------------------------------------------------
拖拽 Shell 节点到画布，新增一个 Shell 任务
节点名称：Test_parameters
... ...
脚本：
    #!/bin/sh
    echo "---------------------------------------"
    echo "# 时间自定义参数"
    echo "后 1 年：" $[add_months(yyyyMMdd, 12*1)]
    echo "前 1 年：" $[add_months(yyyyMMdd, -12*1)]
    echo "后 1 月：" $[add_months(yyyyMMdd,1)]
    echo "前 1 月：" $[add_months(yyyyMMdd,-1)]
    echo "后 1 周：" $[yyyyMMdd+7*1]
    echo "前 1 周：" $[yyyyMMdd-7*1]
    echo "后 1 天：" $[yyyyMMdd+1]
    echo "前 1 天：" $[yyyyMMdd-1]
    echo "后 1 小时：" $[HHmmss+1/24]
    echo "前 1 小时：" $[HHmmss-1/24]
    echo "后 1 分钟：" $[HHmmss+1/24/60]
    echo "前 1 分钟：" $[HHmmss-1/24/60]

    echo "---------------------------------------"
    echo "# 用户自定义参数"
    echo "dt_yesterday: " ${dt_yesterday}
    echo "dt_datetime: " ${dt_datetime}
    echo "dt_today: " ${dt_today}
    echo "dt_today_global: " ${dt_today_global}

资源：
自定义参数：
    dt_yesterday    ${system.biz.date}
    dt_datetime     ${system.datetime}
    dt_today        ${system.biz.curdate}
-> 确认添加
------------------------------------------------------
保存 ->
设置 DAG 图名称：Test_parameters
选择租户：Default
超时告警：off
设置全局：
    dt_today_global ${system.biz.curdate}
------------------------------------------------------
添加 -> 上线 -> 运行

---

文章目录：
DS 1.2.0 使用文档（1/8）：架构及名词解释
DS 1.2.0 使用文档（2-3/8）：集群规划及环境准备
DS 1.2.0 使用文档（4/8）：软件部署
DS 1.2.0 使用文档（5/8）：使用与测试
DS 1.2.0 使用文档（6/8）：任务节点类型与任务参数设置
DS 1.2.0 使用文档（7/8）：系统参数及自定义参数
DS 1.2.0 使用文档（8/8）：附录