# 实战干货：Apache DolphinScheduler 参数使用与优化总结


在使用 DolphinScheduler 进行数据调度开发的过程中，参数的灵活运用是提升任务复用性、动态化执行逻辑的关键。无论是日常跑批任务中的日期处理，还是复杂工作流中的上下游传参，掌握参数的正确使用方式，能极大提高开发效率与任务健壮性。本文基于海豚调度3.1.9版本将系统梳理 DolphinScheduler 中各类参数的使用方法，涵盖内置参数、衍生函数、日期计算、全局变量设置以及跨任务参数传递等核心场景，助你彻底掌握参数使用的“正确姿势”。


## 内置参数
DolphinScheduler 提供了几个常用的系统级内置参数，主要用于获取调度实例的执行时间。这些参数无需定义，直接引用即可。

### 基础参数

![](https://developer.qcloudimg.com/http-save/yehe-11849333/8a3f629593a23317eb4d054d9e585176.jpg)

- SHELL 案例

![d8f093fdbda77c78ec551a42fb0bc5fd](https://developer.qcloudimg.com/http-save/yehe-11849333/5cda262771c7f560314c6b7266a9d9eb.png)

但是这种方式在SQL节点下 不适用，SQL下使用衍生内置函数会比较方便
## 衍生内置参数
为解决 SQL 节点无法使用 ${} 参数的问题，DolphinScheduler 提供了强大的 $[...] 衍生函数语法，支持任意格式的日期拼接与运算，推荐在所有场景中优先使用。

```我们定义这种基准参数为 $[...] 格式的，$[yyyyMMddHHmmss] 是可以任意分解组合的，比如：$[yyyyMMdd], $[HHmmss], $[yyyy-MM-dd] 等
```
### 简单案例
- shell案例

![](https://developer.qcloudimg.com/http-save/yehe-11849333/fc515a09a5fbffe666dbcc97b7528ae7.jpg)
- SQL案例

![aa1b5297c428957afe4ab2abd14b2e0e](https://developer.qcloudimg.com/http-save/yehe-11849333/306edd3fd52dff985d86acef8fdd383d.png)
结果如下：

![47a5b0f03689bbe97cc2e01ed0ff7cdc](https://developer.qcloudimg.com/http-save/yehe-11849333/81ae22eeec2ee285caa6d6c7b661a870.png)


### 日期月份增减变化
若需按月计算（考虑大小月、闰年），可使用 add_months() 函数
- shell 案例，获取前一个月日期

![7a77e5d4aab26156a4c5ddac8a1abefe](https://developer.qcloudimg.com/http-save/yehe-11849333/305b8a1f81b79f683e2ba87b73bb09ff.png)


执行结果如下

![a87f114a006d47b88baf019e3e68599f](https://developer.qcloudimg.com/http-save/yehe-11849333/31d4d3015fb56bc4a1cb18e598edfff6.png)


- PG案例，下一个月

![a887fc6a5541c34837d0f156f51143ab](https://developer.qcloudimg.com/http-save/yehe-11849333/83bf1d76bba29433a23b84dd7ee604f3.png)



执行结果如下

![d6fc84bc43b500fc9129a262a6f68f4e](https://developer.qcloudimg.com/http-save/yehe-11849333/cb4ab22a88999ac0e224c1fd591ecfe4.png)


### 其他时期增减

直接加减数字 在自定义格式后直接“+/-”数字
```
后 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]
```
- shell案例

![6961f42480a4f6de9058a85ecc0b18cf](https://developer.qcloudimg.com/http-save/yehe-11849333/45bb46037ab5440852a7e6020b67bf93.png)


执行结果如下

![4244d6fcb9ca757ae10234d0720310e1](https://developer.qcloudimg.com/http-save/yehe-11849333/5893fff78c09ebef487d781d59aa24b6.png)



- SQL案例

![f0a4892e7d30bbd09993eb7c47d24150](https://developer.qcloudimg.com/http-save/yehe-11849333/3e8748622d12a3a426d18bb6438e093f.png)


执行结果如下：

![fd0c3b4b0cc1d2a3aa2d30e1f909383a](https://developer.qcloudimg.com/http-save/yehe-11849333/04fa62860305ff4d8f2d08ab3051bc56.png)




TIPS ：一般建议使用衍生内置函数，即`$[]`的方式，比较直观且通用。

## 单个任务节点中使用参数

![b26ad39efd173ed70160e47dc364f671](https://developer.qcloudimg.com/http-save/yehe-11849333/887483cd0279a1126b73c14edc2fae7c.png)



TIPS： 不要在别名的地方使用自定义参数，会触发BUG

例如 下图，

![9603f3f2ba7128d4c10f012ac38219fb](https://developer.qcloudimg.com/http-save/yehe-11849333/2803bd3035f8deef99c048b8b5f816db.png)


## 工作流全局参数

当多个任务需要使用相同的自定义变量（如环境标识、项目编号等），可通过工作流全局参数统一管理。

- 案例
下面三个节点用一个参数

shell案例
```
echo ${my_param}
```
SQL案例
```
SELECT name  
FROM test_datax_hive 
WHERE 
dt = DATE_FORMAT('$[yyyy-MM-dd-1]', 'yyyy-MM-dd')  
and name = ${my_param}
```

python案例
```
print('${my_param}')
```
在每个节点的地方不需要设置参数，只需要在工作流保存的时候设置参数即可。如下图。

![10d49b1775af3cf38c5bd57f6a2a2db5](https://developer.qcloudimg.com/http-save/yehe-11849333/117e4d70852f4057eac1ae2cb51f2029.png)

## 工作流参数传递
DolphinScheduler 支持在任务之间传递运行时生成的参数，适用于“上游查询结果 → 下游处理”的场景。

**只有SQL和SHELL任务可以往下传递参数。**

**SQL SHELL PYTHON可以接受上一个节点传递的参数。**

下面通过案例来演示实际操作。
1. SQL向下传递参数

在工作流中新建一个SQL节点。如下图。

![a7560386863314f05fae4cc8d674cd78](https://developer.qcloudimg.com/http-save/yehe-11849333/da05b455daaf44793b16c44212dac85e.png)

1. 参数名要始终保持相同，这里使用my_name作为参
2. 自定义参数中也使用my_name作为参数，选择OUT类型，用于往下传递

然后建SHELL类型任务，如下图

![abfb9cc8a333e8a5546db2fe51461320](https://developer.qcloudimg.com/http-save/yehe-11849333/e29935147798f31c738649a320ee6285.png)


参数名保持相同，依旧是OUT类型。

再建一个PYTHON类型任务。如下图

![2d6a4d7ac630785c006c5bf194007fef](https://developer.qcloudimg.com/http-save/yehe-11849333/053e09536ab191c1bc1fc8356d383420.png)


参数名保持相同。

最后，把工作流连起来，如下图

![22f3ae410ce5273ecd7bc5b55bd00438](https://developer.qcloudimg.com/http-save/yehe-11849333/f204549f36188e0a0fe2f00800606358.png)


最后看运行日志，来验证。

SQL执行结果

![1c524169cb7dc70bed38acc2849bc454](https://developer.qcloudimg.com/http-save/yehe-11849333/184cee217c059144f590251082a91106.png)



SHELL 运行结果，参数被成功赋值

![f2359c19d65761dbed67529b1f6eb3ab](https://developer.qcloudimg.com/http-save/yehe-11849333/27b3bd9e5889264785b210dff5da0d79.png)


PYTHON运行结果，参数被成功赋值

2. SHELL向下传递参数

创建shell脚本，参数名要一致。

![0903d5d08c5bf5718cd5672d538f4ab2](https://developer.qcloudimg.com/http-save/yehe-11849333/0f17789fc099f52da3b78835bd32b182.png)


`${setValue(key=value)} `的语句，key 为对应参数的 prop，value 为该参数的值。

在SQL节点接收参数

![3d17d769d9d5330b446525d601d9da35](https://developer.qcloudimg.com/http-save/yehe-11849333/84c8f5f89e1544badd729b1187b5d8e8.png)


参数名保持一致。

PYTHON任务中接收参数

![e1706743faf2fc12e20ebf5531c7aa8e](https://developer.qcloudimg.com/http-save/yehe-11849333/ae57857ca78e5000b19b3fe0cc7bb844.png)


执行结果：

- SHELL

![59cc46a61d4248724463fe9c63b552dc](https://developer.qcloudimg.com/http-save/yehe-11849333/0c5a8fd241a9040426d47ac9794c232f.png)


- SQL

![a3412ee294f0e29b624770aae59f16fc](https://developer.qcloudimg.com/http-save/yehe-11849333/91558b6d9cea883404e0ecdc1ef0f705.png)

- PYTHON

![702e7a2e296add044c12014a9f46dd29](https://developer.qcloudimg.com/http-save/yehe-11849333/f86b1ec63b78ef579af847c5bf0d6339.png)

## 参数使用总结
1. IN 表示局部参数仅能在当前节点使用
2. OUT 表示局部参数可以向下游传递。参数优先级：DolphinScheduler 
3. 参数的优先级从高到低为：本地参数 > 上游任务传递的参数 > 全局参数

在使用 DolphinScheduler 进行数据调度开发的过程中，参数的灵活运用是提升任务复用性、动态化执行逻辑的关键。无论是日常跑批任务中的日期处理，还是复杂工作流中的上下游传参，掌握参数的正确使用方式，能极大提高开发效率与任务健壮性。本文基于海豚调度3.1.9版本将系统梳理 DolphinScheduler 中各类参数的使用方法，涵盖内置参数、衍生函数、日期计算、全局变量设置以及跨任务参数传递等核心场景，助你彻底掌握参数使用的“正确姿势”。

实战干货：Apache DolphinScheduler 参数使用与优化总结

本文基于海豚调度3.1.9版本将系统梳理 DolphinScheduler 中各类参数的使用方法，涵盖内置参数、衍生函数、日期计算、全局变量设置以及跨任务参数传递等核心场景，助你彻底掌握参数使用的“正确姿势”。

数据库

编程语言

掌握DolphinScheduler参数使用技巧，提升数据调度效率。详解内置参数、衍生函数、日期计算、全局变量设置及跨任务传参方法，涵盖SQL/SHELL/PYTHON节点实战案例，助你优化工作流参数管理。

11.11畅享AI算力 云启新增长

bigdata-class

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

实战干货：Apache DolphinScheduler 参数使用与优化总结-腾讯云开发者社区-腾讯云

实战干货：Apache DolphinScheduler 参数使用与优化总结

实战干货：Apache DolphinScheduler 参数使用与优化总结

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐