项目参数管理

项目参数是 DolphinScheduler 中项目级别的全局静态参数，作用域仅限当前项目，用于统一管理项目内重复使用的固定参数配置。

• 引用方式为 ${参数名}，优先级低于工作流 / 任务参数；
• 同一项目下的所有工作流、所有任务都可以引用该项目的项目参数；
• 项目参数由项目管理员或有对应权限的用户配置。

核心使用场景

• 统一管理项目内重复使用的固定参数（如集群地址、Hive 数据库名、Spark 资源配置）；
• 简化参数修改：若需调整某类参数（如更换 Hive 库名），只需修改项目参数，无需逐个修改工作流 / 任务；
• 权限管控：项目参数仅项目内可见，避免不同项目的参数冲突。

功能入口

点击项目卡片的「项目配置」，进入项目配置主页面，点击左侧菜单「项目参数管理」。

新建项目参数

点击左侧菜单「项目参数管理」，点击按钮【+新建项目参数】，填写参数名称、参数类型和参数值。如下图所示：

参数名称：唯一标识（如 spark_executor_cores），建议使用英文字母 + 下划线，避免特殊字符。

参数类型：支持 9 种，包含 BOOLEAN、DATE、DOUBLE、FLOAT、INTEGER、LONG、TIME、TIMESTAMP、VARCHAR。

参数值：参数的具体值，支持字符串、数字、简单表达式。

刷新

在实际作业任务开发完成后，会发生修改项目参数的情况，在项目配置》项目参数管理，点击【刷新】按钮可以同步更新任务中已经配置的项目参数，无需开发人员修改作业任务。

使用场景

以 shell 程序为例，在脚本内容中输入echo ${param}，其中 param 为创建的项目参数。

运行该 shell 程序，在运行日志中可以查看日志，验证参数是否有效。