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

bag_unpack 插件

适用于：✅Microsoft Fabric✅Azure 数据资源管理器

bag_unpack 插件通过将每个属性包顶级槽视为列来解压缩 dynamic 类型的单个列。 该插件通过 evaluate 运算符调用。

语法

T|evaluatebag_unpack(Column [,OutputColumnPrefix] [,columnsConflict] [,ignoredProperties] ) [:OutputSchema]

详细了解语法约定。

参数

客户	类型​​	必需	说明
T	string	✔️	要解压缩其列 Column 的表格输入。
列	dynamic	✔️	要解压缩的列 T。
OutputColumnPrefix	string		添加到插件生成的所有列的常见前缀。
columnsConflict	string		有关解决列冲突的指导。 有效值： error - 查询生成错误（默认值） replace_source -源列被替换 keep_source - 源列被保留
ignoredProperties	dynamic		要忽略的一组可选包属性。 }
OutputSchema			bag_unpack 插件输出的所需列的名称和类型。 指定所需架构可以优化查询执行，因为无需首先运行实际查询即可浏览架构。 有关语法信息，请参阅输出架构语法。

输出架构语法

( ColumnName : ColumnType [, ...] )

若要将输入表的所有列添加到插件输出，请使用通配符 * 作为第一个参数，如下所示：

( * , ColumnName : ColumnType [, ...] )

返回

bag_unpack 插件返回一个表，其中包含的记录与其表格输入 (T) 的数量相同。 该表格的架构与表格输入的架构相同，但有以下修改：

• 删除了指定的输入列 (Column)。
• 该架构扩展多个列，与 T 的顶层属性包值中非重复槽的数量相同。每个列的名称对应每个槽的名称，可选择将 OutputColumnPrefix 作为前缀。 如果同一槽的所有值具有相同的类型，则其类型为槽的类型；如果类型中的值不同，则为 dynamic。

注意

如果未指定 OutputSchema，插件的输出架构因输入数据值而异。 因此，使用不同的数据输入多次执行插件可能会产生不同的输出架构。

注意

插件的输入数据必须确保输出架构遵循表格架构的所有规则。 具体而言：

• 输出列名不能与表格输入 T 中的现有列相同，除非它是要解压缩的列 (Column)，因为这将生成两个同名列。

• 以 OutputColumnPrefix 为前缀时，所有槽名称必须是有效的实体名称，并遵循标识符命名规则。

示例

展开包

运行查询

datatable(d:dynamic)
[
    dynamic({"Name": "John", "Age":20}),
    dynamic({"Name": "Dave", "Age":40}),
    dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d)

输出

Age	名称
20	John
40	Dave
30	Jasmine

使用 OutputColumnPrefix 展开包

展开包，并使用 OutputColumnPrefix 选项生成以前缀“Property_”开头的列名称。

运行查询

datatable(d:dynamic)
[
    dynamic({"Name": "John", "Age":20}),
    dynamic({"Name": "Dave", "Age":40}),
    dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d, 'Property_')

输出

Property_Age	Property_Name
20	John
40	Dave
30	Jasmine

使用 columnsConflict 展开包

展开包，并使用 columnsConflict 选项来解决现有的列和 bag_unpack() 运算符生成的列之间的冲突。

运行查询

datatable(Name:string, d:dynamic)
[
    'Old_name', dynamic({"Name": "John", "Age":20}),
    'Old_name', dynamic({"Name": "Dave", "Age":40}),
    'Old_name', dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d, columnsConflict='replace_source') // Use new name

输出

Age	名称
20	John
40	Dave
30	Jasmine

运行查询

datatable(Name:string, d:dynamic)
[
    'Old_name', dynamic({"Name": "John", "Age":20}),
    'Old_name', dynamic({"Name": "Dave", "Age":40}),
    'Old_name', dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d, columnsConflict='keep_source') // Keep old name

输出

Age	名称
20	Old_name
40	Old_name
30	Old_name

使用 ignoredProperties 展开包

展开包，并使用 ignoredProperties 选项以忽略属性包中的某些属性。

运行查询

datatable(d:dynamic)
[
    dynamic({"Name": "John", "Age":20, "Address": "Address-1" }),
    dynamic({"Name": "Dave", "Age":40, "Address": "Address-2"}),
    dynamic({"Name": "Jasmine", "Age":30, "Address": "Address-3"}),
]
// Ignore 'Age' and 'Address' properties
| evaluate bag_unpack(d, ignoredProperties=dynamic(['Address', 'Age']))

输出

名称
John
Dave
Jasmine

使用查询定义的 OutputSchema 展开包

展开包并使用 OutputSchema 选项，以便在运行实际查询之前评估各种优化。

运行查询

datatable(d:dynamic)
[
    dynamic({"Name": "John", "Age":20}),
    dynamic({"Name": "Dave", "Age":40}),
    dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d) : (Name:string, Age:long)

输出

名称	Age
John	20
Dave	40
Jasmine	30

展开包并使用 OutputSchema 选项，以便在运行实际查询之前评估各种优化。 使用通配符 * 返回输入表的所有列。

运行查询

datatable(d:dynamic, Description: string)
[
    dynamic({"Name": "John", "Age":20}), "Student",
    dynamic({"Name": "Dave", "Age":40}), "Teacher",
    dynamic({"Name": "Jasmine", "Age":30}), "Student",
]
| evaluate bag_unpack(d) : (*, Name:string, Age:long)

输出

说明	Name	Age
学生	John	20
教师	Dave	40
学生	Jasmine	30