当整个业务流程需要对同一个变量进行统一的赋值或替换参数值时,请选择使用流程参数功能。本文以替换手动业务流程中所有的ReplaceMe参数为ReplaceMe123为例,为您介绍如何使用流程参数。

使用限制

  • 手动业务流程中的ODPS SQL、Shell和数据同步节点支持全局参数,且需要特定的格式。例如,全局参数为x=y1
    • 对于ODPS SQL节点,需要双击打开节点后,单击右侧的属性。在基础属性中输入参数x=aaa,在执行时才会正确替换为x=y1。代码中以${x}的方式来进行引用。
    • 对于Shell节点,需要双击打开节点后,单击右侧的属性。在基础属性中输入参数$x,在执行时才会正确替换为y1。代码中以$1的方式来进行引用。
    • 对于数据同步节点,需要双击打开节点后,单击右侧的属性。在基础属性中输入参数-p”-Dx=aaa”,在执行时才会正确替换为-p”-Dx=y1。代码中以${x}的方式来进行引用。
  • 调度的业务流程仅支持ODPS SQL节点使用流程参数。
  • 使用流程参数前,请先配置好单个节点的参数,确保单个节点运行无误。
  • 当流程参数的赋值与单个节点参数的赋值不一致时,流程参数的赋值会覆盖节点参数的赋值。
  • 输入参数时,请注意区分大小写。

配置流程参数

  1. 进入数据开发页面。
    1. 登录DataWorks控制台
    2. 在左侧导航栏,单击工作空间列表
    3. 选择工作空间所在地域后,单击相应工作空间后的进入数据开发
  2. 在左侧导航栏,单击手动业务流程
  3. 双击打开相应手动业务流程的编辑页面,单击右侧的流程参数
  4. 流程参数对话框中,输入参数名称ReplaceMe参数值或表达式RepalceMe123
    流程参数
  5. 在手动业务流程的编辑页面,单击工具栏中的1图标。

ODPS SQL节点获取流程参数

  1. 数据开发页面的左侧导航栏,单击手动业务流程
  2. 展开相应手动业务流程下的数据开发,双击打开ODPS SQL节点的编辑页面。
  3. 单击右侧的属性,输入参数ReplaceMe=123
    参数

    由于流程参数ReplaceMe=RepalceMe123,所以运行整个业务流程时,该节点赋值为RepalceMe123

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

Shell节点获取流程参数

  1. 数据开发页面的左侧导航栏,单击手动业务流程
  2. 展开相应手动业务流程下的数据开发,双击打开Shell节点的编辑页面。
  3. 单击右侧的属性,输入参数${ReplaceMe}
    属性
    说明 请注意Shell节点的参数定义和赋值。
  4. 在手动业务流程的编辑页面,单击工具栏中的1图标。

数据同步节点获取流程参数

  1. 数据开发页面的左侧导航栏,单击手动业务流程
  2. 展开相应手动业务流程下的数据开发,双击打开数据同步节点的编辑页面。
  3. 单击右侧的属性,输入参数-p"ReplaceMe=abc"
    参数
    由于流程参数为ReplaceMe=RepalceMe123,运行整个业务流程时,该节点赋值为RepalceMe123
    说明 数据同步节点的参数格式为-p"-D参数名=参数值"
  4. 在手动业务流程的编辑页面,单击工具栏中的1图标。

运行并查看结果

在手动业务流程的编辑页面,单击工具栏中的运行图标。调度任务时,各节点的赋值才会替换为流程参数。所以在界面运行手动业务流程时,您需要在填写参数对话框中,为变量RepalceMe赋值:
  • 右键单击ODPS SQL节点,单击查看日志,即可在页面下方查看ODPS SQL节点的赋值情况。SQL赋值
  • 右键单击Shell节点,单击查看日志,即可在页面下方查看Shell节点的赋值情况。Shell节点赋值
  • 右键单击数据同步节点,单击查看日志,即可在页面下方查看数据同步节点的赋值情况。数据同步赋值
如果您未在手动业务流程编辑页面右侧的流程参数中赋值,则每次在生产环境运行该业务流程时,都需要手动给业务流程参数赋值。手动运行