参数管理

最近更新 2026/10/05

空间参数概述

空间参数是参数体系的组成部分，其作用域是全空间，即该空间下的所有任务流、离线同步方案等模块都可以使用这些空间参数。空间参数分为 预置空间参数 和 自定义空间参数。

预置参数

预置参数	说明
基准日期 ${bd}	Base date，数据结算的基准日期，需在新建工作空间时定义日期格式和偏移量 具体可以查看 数开空间管理
基准时区 ${btz}	Base timezone，数据结算的基准时区，需在新建工作空间时定义时区 具体可以查看 数开空间管理
理论调度时间 ${st}	任务实例理论上应该执行的时间点，默认格式为 yyyyMMddHHmmss，需在新建工作空间时定义 具体可以查看 数开空间管理
运行环境 ${env}	根据运行环境使用对应的环境值，可取值 dev、product
生产环境库 ${ws_prod_db}	系统预置的生产环境库名，可用于开发任务流中
开发环境库 ${ws_dev_db}	系统预置的开发环境库名，可用于开发任务流中
IDE 库 ${ws_ide_db}	系统预置的 IDE 库名

定义空间基准日期和时区

空间参数（自定义）

在空间参数列表中，可以查看当前空间下所有可用的自定义空间参数

用户也可以在参数管理模块点击「+空间参数」新增自定义空间参数。

空间参数配置如下：

字段	说明
参数名	自定义空间参数的名称 最多 40 个字符，不可与当前的预置参数重名，空间内唯一 不可以 ws_ 开头、不可用 ${bd}、${btz}。 以英文字母开头，可包含英文小写字母、数字、下划线
类型	自定义空间参数类型 分为「纯文本」与「表达式」两种类型 纯文本：即纯文本值，比如 num = 2 city = shanghai 表达式：可以在表达式中引用预置参数 比如引用：默认日期格式为 yyyy-MM-dd 的预置参数 ${bd}，则表达式可写方式 ${bd} 取值：2025-02-01 ${bd:yyyy-MM-dd-7} 取值：2025-01-23 ${bd:yy/MM/dd-7} 取值：2025/01/23
值	当 类型 = 「纯文本」时，为直接取值 当 类型 = 「表达式」时，为表达式
描述	空间参数描述

空间参数表达式填写案例

直接使用 ${bd}，则不做任何后调整，按照默认的取值与格式返回

${bd} 的格式化表达式与 DolphinScheduler（DS）的直接表达式类似，如 ${bd:yyyy-MM-dd-1}、${bd:dd/MM/yy} 等，在自定义格式（同样采用 SimpleDateFormat）后可以直接 "+/-" 数字，单位为天。

以格式为 ${bd:yyyy-MM-dd} 为例：

• 后 N 周： ${bd:yyyy-MM-dd+N*week}
• 前 N 周： ${bd:yyyy-MM-dd-N*week}
• 后 N 天： ${bd:yyyy-MM-dd+N}、${bd:yyyy-MM-dd+N*day}
• 前 N 天： ${bd:yyyy-MM-dd-N}、${bd:yyyy-MM-dd-N*day}
• 后 N 小时： ${bd:yyyy-MM-dd HH:mm:ss+N*hour}
• 前 N 小时： ${bd:yyyy-MM-dd HH:mm:ss-N*hour}
• 后 N 分钟：${bd:yyyy-MM-dd HH:mm:ss+N*minute}
• 前 N 分钟：${bd:yyyy-MM-dd HH:mm:ss-N*minute}

年与月的偏移，可以考虑使用如下方式：

• 后 N 月：${bd:yyyy-MM-dd+N*month}
• 前 N 月：${bd:yyyy-MM-dd-N*month}
• 后 N 年：${bd:yyyy-MM-dd+N*year}
• 前 N 年：${bd:yyyy-MM-dd-N*year}