设置管道返回值

2023-03-05 15:56| 来源: 网络整理| 查看: 265

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Azure 数据工厂和 Azure Synapse Analytics 中设置管道返回值项目 02/27/2023

适用于： Azure 数据工厂 Azure Synapse Analytics

在调用管道子管道范例中，可以使用设置变量活动将值从子管道返回到调用管道。在以下方案中，有一个通过执行管道活动运行的子管道。我们想要从子管道检索信息，然后在调用管道中使用这些信息。

引入管道返回值，它是键值对的字典，用于在子管道和父管道之间实现通信。

先决条件 - 调用子管道

本用例的先决条件是你有一个执行管道活动，该活动调用一个子管道。请务必为该活动启用“等待完成”

在子管道中配置管道返回值

我们已扩展设置变量活动以包含系统变量“管道返回值”。不需要在管道级别定义这些变量（与在管道中使用的任何其他变量不同）。

在管道“活动”窗格中搜索“Set Variable”，然后将 Set Variable 活动拖动到管道画布上。选择画布上的“设置变量”活动（如果尚未选择）及其“变量”选项卡，以编辑其详细信息。选择“管道返回值”作为变量类型。选择“新建”以添加新的键值对。可以添加合理数量的键值对，只要不超过返回 json 的大小限制即可。

对于值类型，可以使用几个选项，包括

类型名称说明 String 最直接的选项。需要为它输入字符串值。 Expression 它允许引用先前活动的输出。数组它需要一个字符串值数组。按 Enter 键分隔数组中的值布尔是或否 Null 信号占位符状态；该值为常量 null int 需要为它输入整数类型的数值 Float 需要为它输入浮点类型的数值 Object 警告：仅适用于复杂用例。用于为值嵌入键值对类型的列表

对象类型的值定义如下：

[{"key": "myKey1", "value": {"type": "String", "content": "hello world"}}, {"key": "myKey2", "value": {"type": "String", "content": "hi"}} ] 在调用管道中检索值

子管道的管道返回值将成为执行管道活动的活动输出。可以使用 @activity('Execute Pipeline1').output.pipelineReturnValue.keyName 检索信息。用例没有限制。例如，可以

使用子管道中的整型值来定义等待活动的等待期限使用字符串值来定义 Web 活动的 URL 将脚本活动的表达式值有效负载用于日志记录目的。

在引用管道返回值时有两个明显的标注。

使用对象类型时，可以进一步扩展到嵌套的 json 对象，例如 @activity('Execute Pipeline1').output.pipelineReturnValue.keyName.nextLevelKey 使用数组类型时，可以使用 @activity('Execute Pipeline1').output.pipelineReturnValue.keyName[0] 指定列表中的索引。该数字的索引以零为基础，即从 0 开始。

注意

请确保引用的 keyName 存在于子管道中。 ADF 表达式生成器无法为你确认引用检查。如果有效负载中缺少引用的键，管道将会失败

特殊注意事项

管道中可能有多个“设置管道返回值”活动。但是，请确保只有其中一个活动在管道中运行。

为避免调用管道中出现如上所述的缺少键的情况，我们建议对子管道中的所有分支使用相同的键列表。考虑在特定分支中为没有值的键使用 null 类型。

后续步骤

详细了解其他相关的控制流活动：

设置变量活动追加变量活动

【本文地址】

公司简介

联系我们