DataWorks功能实践速览 — 参数透传

朴灿烈づ我的快乐病毒、 2022-09-11 11:13 259阅读 0赞

**简介：** DataWorks功能实践系列，帮助您解析业务实现过程中的痛点，提高业务功能使用效率！

![1.png][]

往期回顾：

*  [DataWorks 功能实践速览01期——数据同步解决方案][DataWorks _01]：为您介绍不同场景下可选的数据同步方案。
 *  [DataWorks 功能实践速览02期——独享数据集成资源组][DataWorks _02]：为您介绍进行数据同步时，可使用的资源组与网络连通方案、注意事项。
 *  [DataWorks 功能实践速览03期——生产开发环境隔离][DataWorks _03]：为您介绍DataWorks通过标准模式提供开发环境与生产环境隔离及不同环境的权限要求。

通过往期的介绍，您已经了解到在DataWorks上进行任务运行的最关键的几个知识点，接下来为您逐步介绍如何通过DataWorks的任务节点实现最常见的数据开发场景。本期为您介绍如何在DataWorks上实现参数透传，即把上游任务的参数透传到下游任务。

## 功能推荐：赋值节点与参数节点 ##

在阿里云DataWorks中，一个数据开发任务最终是拆解为多个节点任务，并通过设置节点间上下游关系最终形成一个完整的数据开发业务流程，如下图所示。

![2.png][]

以上为一个简单的示例，在实际应用时，我们通常会碰到这样的情况，拆解出来的上游节点任务会生成一些参数，或上游节点的运行结果，需要在下游节点任务中应用到，这就需要数据开发任务能够实现参数/节点运行结果在各个节点间的透传，根据不同的透传需求，DataWorks提供了两种特殊节点可以实现：**赋值节点**与**参数节点**。

## Part1：赋值节点 - 实现任务结果透传 ##

当您需要**将上游节点任务的结果提供给下游节点使用**时，您可使用赋值节点，实现任务结果在节点间传递。赋值节点支持ODPS SQL、SHELL和Python三种赋值语言，且根据赋值规则，自动为您添加赋值参数（outputs参数），便于其他节点引用。

使用赋值节点进行透传参数时，需关注以下三个要点。

### 1.1赋值节点与上下游节点间的依赖关系 ###

![3.png][]

如上图所示，使用赋值节点透传参数时：

*  赋值节点（fuzhi\_python、fuzhi\_sql、fuzhi\_shell）需作为引用赋值节点参数节点（down\_compare）的上游节点，**下游节点需要与赋值节点设置直接依赖关系(赋值节点为下游节点的一层父节点)**。
 *  赋值节点作为上游与其它节点配合使用时，**请务必先提交赋值节点**，以便下游节点在配置时可以解析出参数。

### 1.2赋值节点与下游节点的上下文参数透传关系 ###

如下图所示，通过赋值节点与引用节点的调度配置中的**上下文参数配置**，形成参数透传引用关系：

![4.png][]

*  赋值节点（fuzhi\_python、fuzhi\_sql、fuzhi\_shell）需将待赋值给下游的参数添加为**节点上下文**中的**本节点输出参数**。
 *  下游引用赋值参数的节点需将待引用的赋值参数添加为**节点上下文**中的**本节点输入参数**。

说明：

*  赋值节点参数传递**只支持传递给一层子节点，不支持跨节点传递**。

### 1.3赋值语言与赋值结果 ###

引用赋值节点结果时，赋值节点的参数输出格式与下游节点引用参数方式有关系，不同语言的赋值参数（outputs参数）赋值说明如下。

<table> 
 <tbody> 
 <tr> 
 <td> 赋值语言 </td> 
 <td> outputs参数取值 </td> 
 <td> outputs参数格式 </td> 
 <td> outputs参数大小限制 </td> 
 </tr> 
 <tr> 
 <td> ODPS SQL </td> 
 <td> 最后一行SELECT语句的输出作为赋值参数，添加为赋值节点的本节点输出参数，供其他节点引用。 </td> 
 <td> 将输出结果作为一个二维数组传递至下游。 </td> 
 <td> 传递值最大为2 MB。如果赋值语句的输出结果超过该限制，赋值节点会运行失败。 </td> 
 </tr> 
 <tr> 
 <td> SHELL </td> 
 <td> 最后一行ECHO语句的数据，添加为赋值节点的本节点输出参数，供其他节点引用。 </td> 
 <td> 将输出结果基于逗号（,）分割为一维数组。 </td> 
 </tr> 
 <tr> 
 <td> Python </td> 
 <td> 最后一行PRINT语句的输出，添加为赋值节点的本节点输出参数，供其他节点引用。 </td> 
 <td> 将输出结果基于逗号（,）分割为一维数组。 </td> 
 </tr> 
 </tbody> 
</table>

更多赋值节点的介绍可进入帮助中心查看文档[配置赋值节点][Link 1]。

## Part2：参数节点 - 实现参数透传 ##

参数节点是一种特殊的虚拟节点，用于管理业务流程中的参数和实现参数在任务节点中传递，支持常量参数、变量参数和透传上游节点的参数，需要引用参数的节点直接依赖参数节点即可。

参数节点本质上是一种虚拟节点，不会运行数据计算任务产生数据，主要用于跨节点传参、参数管理的场景。

### 2.1跨节点传参 ###

当数据开发的业务流程中，某个下游节点的任务需要获取多个、多级上游节点的输出参数时，您可以使用参数节点，将下游节点需要获取的所有参数统一添加至参数节点中，后续下游节点可直接挂在参数节点之下，即可获取到所有所需参数。

![5.png][]

以上图为例，sql\_7节点需要获取sql\_1、sql\_3、sql\_4节点的输出参数，此时您可以新增一个参数节点，作为sql\_1、sql\_3、sql\_4的下游节点，并将所有sql\_7所需参数添加至参数节点中，将sql\_7的挂在此参数节点下游，则sql\_7可直接通过参数节点获取到所有所需参数。

### 2.2参数管理 ###

当数据开发的业务流程中，下游节点的任务需要使用某些常量参数、变量参数时，您可以使用参数节点，将下游节点需要使用的参数均添加至参数节点中，需使用参数的下游节点直接挂在参数节点之下，即可获取使用所需参数，便于整个业务流程中对所有使用的参数进行统一管理。

![6.png][]

以上图为例，sql\_3、sql\_4、sql\_5、sql\_7节点均需使用参数，此时您可以新增一个参数节点，将各个下游节点使用的参数都添加至参数节点中，将需要使用参数的节点挂在此参数节点下游。

更多参数节点的介绍可进入帮助中心查看文档[创建参数节点][Link 2]。

## Part3：赋值节点与参数节点的对比 ##

<table> 
 <tbody> 
 <tr> 
 <td> 对比项 </td> 
 <td> 赋值节点 </td> 
 <td> 参数节点 </td> 
 </tr> 
 <tr> 
 <td> 透传场景 </td> 
 <td> 节点运行结果透传 </td> 
 <td> 节点参数透传 </td> 
 </tr> 
 <tr> 
 <td> 透传限制 </td> 
 <td> 仅能透传至一层子节点，不支持跨节点透传 </td> 
 <td> 可跨节点透传 </td> 
 </tr> 
 <tr> 
 <td> 节点属性 </td> 
 <td> 一种任务节点，节点中运行赋值任务，支持ODPS SQL、SHELL和Python三种赋值语言 </td> 
 <td> 本质上是一种虚拟节点，不会运行任务产生数据 </td> 
 </tr> 
 </tbody> 
</table>

[原文链接][Link 3]  
本文为阿里云原创内容，未经允许不得转载。

[1.png]: /images/20220828/b6cd47fd07e543cd80fb27ebe268019c.png
[DataWorks _01]: https://developer.aliyun.com/article/786080
[DataWorks _02]: https://developer.aliyun.com/article/787172
[DataWorks _03]: https://developer.aliyun.com/article/788461?spm=a2c6h.12873581.0.dArticle788461.1d1a3740xtDrCn&groupCode=dataworks
[2.png]: /images/20220828/6329378d6476459eabd2dcecb6a95b0c.png
[3.png]: /images/20220828/6103973d556742489adff8a0354f9e8a.png
[4.png]: /images/20220828/d4f8b249facc445db54cd31cd417e13e.png
[Link 1]: https://help.aliyun.com/document_detail/137534.html
[5.png]: /images/20220828/44fdbc5b69ae4dc99ed2446c54d3f0e8.png
[6.png]: /images/20220828/f81f9d59fa3e4003a6677b881362fecd.png
[Link 2]: https://help.aliyun.com/document_detail/201889.html
[Link 3]: http://click.aliyun.com/m/1000295916/