使用流程参数

支持的节点类型

当前仅ODPS SQL、EMR Spark Shell、EMR Spark、EMR Shell、EMR Hive、EMR MR、EMR Presto、EMR Trino、EMR Spark SQL、EMR Spark Streaming、EMR Streaming SQL、Hologres SQL节点支持使用流程参数，具体请以实际界面为准。

注意事项

• 配置并保存流程参数后，每次打开节点（即当前业务流程下支持使用流程参数的节点）时，都会加载业务流程中最新的流程参数至节点的参数配置列表，节点将回到编辑状态，需提交发布节点后，新的流程参数配置才会在调度场景下生效。

• 当同一参数在流程参数的赋值与单个节点中的赋值不一致时，流程参数的赋值会覆盖节点中的参数赋值。

• 流程参数在进行参数赋值时，参数值或表达式不支持配置为${英文}：格式。例如：var：1、${var}：1。

流程参数配置入口

1. 进入数据开发页面。

   登录DataWorks控制台，切换至目标地域后，单击左侧导航栏的数据开发与运维 > 数据开发，在下拉框中选择对应工作空间后单击进入数据开发。

2. 进入流程参数配置界面。

   双击目标业务流程，在业务流程编辑页面右侧导航栏配置流程参数。

配置流程参数

支持使用流程参数的节点，其参数配置方式相同。通常，当需要批量为业务流程下节点的某参数赋值时，建议使用该功能。本文示例通过流程参数，将周期业务流程中ODPS SQL节点的ReplaceMe参数取值20230613替换为20230615，为您介绍流程参数的使用。

1. 开发节点配置节点参数。

   1. 进入节点编辑页面。

      双击目标业务流程下的ODPS SQL节点，进入节点编辑页面。

   2. 配置节点参数。

      如下图，配置ODPS SQL节点参数取值为20230613。更多节点参数的配置，详情请参见配置调度参数。

2. 使用流程参数替换开发节点中的参数取值。

   1. 双击目标业务流程，在业务流程编辑页面，单击右侧导航栏的流程参数。

   2. 在流程参数对话框配置参数信息。

      如下图，示例配置流程参数取值为20230615，保存配置后，业务流程中ODPS SQL节点的参数取值将替换为20230615。您也可根据业务需求，新增多个参数使用。

      说明

      • 当同一参数在流程参数的赋值与单个节点中的赋值不一致时，流程参数的赋值会覆盖节点中的参数赋值。

      • 流程参数在进行参数赋值时，参数值或表达式不支持配置为${英文}：格式。例如：var：1、${var}：1。

      ODPS SQL节点参数替换情况。

验证流程参数是否生效

流程参数配置完成后，您需运行业务流程，验证流程参数配置的参数取值是否已替换节点中配置的参数取值。

1. 运行业务流程并为变量赋值。

   运行业务流程时，当使用了流程参数，您需手动为流程参数进行赋值。更多运行方式介绍，详情请参见任务调试运行。

   1. 在业务流程编辑页面，单击工具栏中的图标。

   2. 在填写参数对话框中为变量ReplaceMe赋值20230615。

2. 查看运行结果。

   在业务流程编辑页面，右键单击ODPS SQL节点，选择查看日志，即可在页面下方查看ODPS SQL节点的赋值情况。此时节点的参数取值已由20230613变更为20230615，流程参数生效且运行无误。

提交发布流程参数

确认流程参数配置无误后，您需提交发布当前业务流程，提交发布后，流程参数才会真正生效。

1. 提交业务流程。

   您需按下图步骤提交业务流程，提交时，请选择需要提交的节点并配置相关描述信息。

   说明

   可根据需要选择是否使用代码评审，若使用，则当前提交的节点代码必须通过评审人员的审核才可发布。

   

2. 发布业务流程。

   如果您使用的是标准模式的工作空间，提交成功后，需单击右上方的发布，发布业务流程中的节点，具体操作请参见发布任务。