使用流程参数

使用限制

• 手动业务流程中的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，参数值或表达式为ReplaceMe123。
   
5. 在手动业务流程的编辑页面，单击工具栏中的图标。

ODPS SQL节点获取流程参数

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

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

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

Shell节点获取流程参数

1. 在数据开发页面的左侧导航栏，单击手动业务流程。
2. 展开相应手动业务流程下的数据开发，双击打开Shell节点的编辑页面。
3. 单击右侧的属性，输入参数为${ReplaceMe}。
   

   说明 请注意Shell节点的参数定义和赋值。
4. 在手动业务流程的编辑页面，单击工具栏中的图标。

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

1. 在数据开发页面的左侧导航栏，单击手动业务流程。
2. 展开相应手动业务流程下的数据开发，双击打开数据同步节点的编辑页面。
3. 单击右侧的属性，输入参数为-p"ReplaceMe=abc"。
   

   此处数据集成参数配置为ReplaceMe=abc，流程参数为ReplaceMe=ReplaceMe123，运行整个业务流程时，流程参数的赋值ReplaceMe=ReplaceMe123替换了代码中的ReplaceMe，所以pt="ReplaceMe123"，流程参数会覆盖节点中的ReplaceMe的赋值。

   说明 数据同步节点的参数格式为-p"-D参数名=参数值"。
4. 在手动业务流程的编辑页面，单击工具栏中的图标。

运行并查看结果

在手动业务流程的编辑页面，单击工具栏中的图标。调度任务时，各节点的赋值才会替换为流程参数。所以在界面运行手动业务流程时，您需要在填写参数对话框中，为变量ReplaceMe赋值：

• 右键单击ODPS SQL节点，单击查看日志，即可在页面下方查看ODPS SQL节点的赋值情况。
• 右键单击Shell节点，单击查看日志，即可在页面下方查看Shell节点的赋值情况。
• 右键单击数据同步节点，单击查看日志，即可在页面下方查看数据同步节点的赋值情况。

如果您未在手动业务流程编辑页面右侧的流程参数中赋值，则每次在生产环境运行该业务流程时，都需要手动给业务流程参数赋值。