使用流程参数

当需要对业务流程中多个节点的同一参数变量统一赋值或替换其参数值时,可使用流程参数功能实现。本文以替换周期业务流程中节点的ReplaceMe参数取值示例,为您介绍流程参数的使用方法。

前提条件

  • 已创建业务流程,用于配置流程参数。详情请参见创建周期业务流程创建手动业务流程

  • 已创建节点,配置的流程参数将在节点中使用,替换实际节点中的参数取值。

    说明

    当前仅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节点支持使用流程参数,具体请以实际界面为准。

    创建节点,详情请参见DataWorks节点合集

支持的节点类型

当前仅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. 进入数据开发页面。

    1. 登录DataWorks控制台

    2. 在左侧导航栏,单击工作空间列表

    3. 选择工作空间所在地域后,单击相应工作空间后的快速进入 > 数据开发

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

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

配置流程参数

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

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

    1. 进入节点编辑页面。

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

    2. 配置节点参数。

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

  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. 发布业务流程。

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