取消嵌套字段

取消嵌套字段 工具用于将在数组、映射或结构体字段中存储的值返回为新字段或行。

示例

取消嵌套字段工具可用于以下场景：

• 将值数组展平为新行
• 将结构体或映射字段中的嵌套属性返回为新字段

参数

下表概述了在取消嵌套字段工具中使用的参数：

参数	描述
输入数据集	包含要取消嵌套的数组、结构体或映射字段的数据集。
取消嵌套字段	要取消嵌套的数据、结构体或映射字段。
输出字段名	要包含取消嵌套数组值的字段的名称。 此参数为可选参数，仅在嵌套字段为数组类型时可用。
输出关键字段名称	要包含取消嵌套映射键的字段的名称。 此参数为可选参数，仅在嵌套字段为映射类型时可用。
输出值字段名称	要包含取消嵌套映射值的字段的名称。 此参数为可选参数，仅在嵌套字段为映射类型时可用。

用法说明

使用输入数据集参数选择包含要取消嵌套的字段的数据集。

使用取消嵌套字段参数指定要取消嵌套的数组、映射或结构体字段。 将输出包含指定字段中的值的新行和字段。

在要取消嵌套的字段类型为数组时，可选择使用输出字段名称。 使用此参数可重命名包含取消嵌套值的结果字段。 默认情况下，输出字段将以要取消嵌套的输入字段名称进行命名。

在要取消嵌套的字段类型为映射时，可选择使用输出键字段名称和输出值字段名称。 使用此参数可重命名包含取消嵌套键和值的结果字段。 默认情况下，输出字段将以追加有 "_KEY" 或 "_VALUE" 的输入字段名称进行命名。

结构体字段将取消嵌套到名称基于结构体属性的新字段。

输出

该工具将输出包含取消嵌套字段中的新行或字段的输入数据集。 下面概述了如何取消嵌套每个受支持的字段类型：

• 数组 - 数组字段值将在一行对应数组中的一个值的字段中返回。 下图是一个演示如何取消嵌套输入数组字段的示例：

  

• 映射 - 映射字段值将在表示映射中的键和值的两个新字段中返回。 这两个字段分别包含键和值。 下图是一个演示如何取消嵌套输入映射字段的示例：

  

• 结构体 - 结构体字段将以与结构体中的每个属性对应的新字段形式返回。 这些字段将包含每个属性的值。 下图是一个演示如何取消嵌套输入结构体字段的示例：

  

局限性

该工具将仅解析单层嵌套。 例如，如果输入字段为结构体数组，则将输出包含结构体的新行。 要取消嵌套结构体，需要配置另一个取消嵌套工具。

许可要求

需要以下许可和配置：

• Creator 或 Professional 用户类型
• 发布者、服务商或管理员角色，或等效的自定义角色

有关 Data Pipelines 要求的详细信息，请参阅要求。