当需要对业务流程中多个节点的同一参数变量统一赋值或替换其参数值时,可使用流程参数功能实现。本文以替换周期业务流程中节点的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。
流程参数配置入口
进入数据开发页面。
登录DataWorks控制台,切换至目标地域后,单击左侧导航栏的 ,在下拉框中选择对应工作空间后单击进入数据开发。
进入流程参数配置界面。
双击目标业务流程,在业务流程编辑页面右侧导航栏配置流程参数。
配置流程参数
支持使用流程参数的节点,其参数配置方式相同。通常,当需要批量为业务流程下节点的某参数赋值时,建议使用该功能。本文示例通过流程参数,将周期业务流程中ODPS SQL节点的ReplaceMe参数取值20230613
替换为20230615
,为您介绍流程参数的使用。
开发节点配置节点参数。
进入节点编辑页面。
双击目标业务流程下的ODPS SQL节点,进入节点编辑页面。
配置节点参数。
如下图,配置ODPS SQL节点参数取值为
20230613
。更多节点参数的配置,详情请参见配置调度参数。
使用流程参数替换开发节点中的参数取值。
双击目标业务流程,在业务流程编辑页面,单击右侧导航栏的流程参数。
在流程参数对话框配置参数信息。
如下图,示例配置流程参数取值为
20230615
,保存配置后,业务流程中ODPS SQL节点的参数取值将替换为20230615
。您也可根据业务需求,新增多个参数使用。说明当同一参数在流程参数的赋值与单个节点中的赋值不一致时,流程参数的赋值会覆盖节点中的参数赋值。
流程参数在进行参数赋值时,参数值或表达式不支持配置为${英文}:格式。例如:var:1、${var}:1。
ODPS SQL节点参数替换情况。
验证流程参数是否生效
流程参数配置完成后,您需运行业务流程,验证流程参数配置的参数取值是否已替换节点中配置的参数取值。
运行业务流程并为变量赋值。
运行业务流程时,当使用了流程参数,您需手动为流程参数进行赋值。更多运行方式介绍,详情请参见任务调试运行。
在业务流程编辑页面,单击工具栏中的图标。
在填写参数对话框中为变量ReplaceMe赋值
20230615
。
查看运行结果。
在业务流程编辑页面,右键单击ODPS SQL节点,选择查看日志,即可在页面下方查看ODPS SQL节点的赋值情况。此时节点的参数取值已由
20230613
变更为20230615
,流程参数生效且运行无误。
提交发布流程参数
确认流程参数配置无误后,您需提交发布当前业务流程,提交发布后,流程参数才会真正生效。