使用$unwind
可以对输入文档数组字段进行结构,为每个数组元素输出一个文档,并且每个输出文档都是输入文档数组字段的值。相当于将内嵌的数组文档提升到了顶层。
语法
可以通过字段路径或文档操作符来展开数组字段。
通过字段操作符展开
可以将数组字段路径传递给$unwind
,如果字段值为null
、不存在或者是个空数组,则$unwind
不会输出文档。
指定的字段路径时,字段名前面必须使用$
前缀,并用引号引起来。
{ $unwind: <field path> }
使用文档操作符选项
可以通过给$unwind
传递一个文档来指定展开时的行为:
{
$unwind:
{
path: <field path>,
includeArrayIndex: <string>,
preserveNullAndEmptyArrays: <boolean>
}
}
|字段|类型|说明|
|path
|string|数组字段的路径,字段名前面必须使用$
前缀,并用引号引起来|
|includeArrayIndex
|string|可选,给数组元素位置字段指定字段名,不能以$
开始|
|preserveNullAndEmptyArrays|boolean|可选,缺省值为false
。如果为true
,当path
为空、不存在或数组元素为空,$unwind
输出文档,否则如果为false
则不输出文档|
使用
非数组字段路径
-
当操作符没有解析为数组,但不是缺失、空或空数组时,
$unwind
会将操作符视为单元素数组。 -
当操作符为空、缺失或空数组时,
$unwind
会按照preserveNullAndEmptyArrays
选项执行。
字段缺失
如果输入文档中不存在指定字段的路径或字段是个空数组,默认情况下$unwind
会忽略输入文档且不输出文档。可以使用preserveNullAndEmptyArrays
选项来强制输出文档。
举例
展开数组
为inventory
文档添加一个文档:
db.inventory.insertOne({ "_id" : 1, "item" : "ABC1", sizes: [ "S", "M", "L"] })
下面的聚合使用$unwind
阶段为sizes
数组的每个元素输出一个文档:
db.inventory.aggregate( [ { $unwind : "$sizes" } ] )
操作返回:
{ "_id" : 1, "item" : "ABC1", "sizes" : "S" }
{ "_id" : 1, "item" : "ABC1", "sizes" : "M" }
{ "_id" : 1, "item" : "ABC1", "sizes" : "L" }
每个文档都与输入文档完全相同,只是sizes
字段的值不同,该字段的值来自原始sizes
数组。
缺失或数组为空
准备clothing
集合数据:
db.clothing.insertMany([
{ "_id" : 1, "item" : "Shirt", "sizes": [ "S", "M", "L"] },
{ "_id" : 2, "item" : "Shorts", "sizes" : [ ] },
{ "_id" : 3, "item" : "Hat", "sizes": "M" },
{ "_id" : 4, "item" : "Gloves" },
{ "_id" : 5, "item" : "Scarf", "sizes" : null }
])
下列情况下,$unwind
把sizes
字段看做一个文档:
- 字段存在
- 字段的值不为空
- 字段的值不是空数组
使用$unwind
展开sizes
数组:
db.clothing.aggregate( [ { $unwind: { path: "$sizes" } } ] )
操作返回:
{ _id: 1, item: 'Shirt', sizes: 'S' },
{ _id: 1, item: 'Shirt', sizes: 'M' },
{ _id: 1, item: 'Shirt', sizes: 'L' },
{ _id: 3, item: 'Hat', sizes: 'M' }
- 在
_id: 1
的文档中,sizes
是一个有元素的数组,$unwind
为sizes
字段的每个元素生成了一个文档 - 在
_id: 3
的文档中,sizes
被解析为只有一个元素的数组 _id: 2
、_id: 4
和_id: 5
文档则没有返回,因为sizes
字段不能被解析为单元素数组。
注意:{path: <FIELD>}
是可选的,下面的两个$unwind
操作是等价的:
db.clothing.aggregate( [ { $unwind: "$sizes" } ] )
db.clothing.aggregate( [ { $unwind: { path: "$sizes" } } ] )
preserveNullAndEmptyArrays 和 includeArrayIndex
创建inventory2
并插入下面数据:
db.inventory2.insertMany([
{ "_id" : 1, "item" : "ABC", price: NumberDecimal("80"), "sizes": [ "S", "M", "L"] },
{ "_id" : 2, "item" : "EFG", price: NumberDecimal("120"), "sizes" : [ ] },
{ "_id" : 3, "item" : "IJK", price: NumberDecimal("160"), "sizes": "M" },
{ "_id" : 4, "item" : "LMN" , price: NumberDecimal("10") },
{ "_id" : 5, "item" : "XYZ", price: NumberDecimal("5.75"), "sizes" : null }
])
preserveNullAndEmptyArrays
下面的$unwind
操作使用preserveNullAndEmptyArrays
选项,当sizes
字段为null
、缺失或空数组时,仍然输出文档。
db.inventory2.aggregate( [
{ $unwind: { path: "$sizes", preserveNullAndEmptyArrays: true } }
] )
输出包含了sizes
为null
、缺失或为空数组时的文档:
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "S" }
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "M" }
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "L" }
{ "_id" : 2, "item" : "EFG", "price" : NumberDecimal("120") }
{ "_id" : 3, "item" : "IJK", "price" : NumberDecimal("160"), "sizes" : "M" }
{ "_id" : 4, "item" : "LMN", "price" : NumberDecimal("10") }
{ "_id" : 5, "item" : "XYZ", "price" : NumberDecimal("5.75"), "sizes" : null }
includeArrayIndex
下面的$unwind
操作使用includeArrayIndex
选项,在输出文档中添加了数组元素索引字段。
db.inventory2.aggregate( [
{
$unwind:
{
path: "$sizes",
includeArrayIndex: "arrayIndex"
}
}])
操作展开了sizes
数组,并为输出文档增加了一个数组元素索引字段arrayIndex
,如果sizes
字段不能被解析为一个有元素的数组,但又不是缺失、为空或空数组,则arrayIndex
字段为空。
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "S", "arrayIndex" : NumberLong(0) }
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "M", "arrayIndex" : NumberLong(1) }
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "L", "arrayIndex" : NumberLong(2) }
{ "_id" : 3, "item" : "IJK", "price" : NumberDecimal("160"), "sizes" : "M", "arrayIndex" : null }
对展开的数组做分组汇总
创建并填充inventory2
集合:
db.inventory2.insertMany([
{ "_id" : 1, "item" : "ABC", price: NumberDecimal("80"), "sizes": [ "S", "M", "L"] },
{ "_id" : 2, "item" : "EFG", price: NumberDecimal("120"), "sizes" : [ ] },
{ "_id" : 3, "item" : "IJK", price: NumberDecimal("160"), "sizes": "M" },
{ "_id" : 4, "item" : "LMN" , price: NumberDecimal("10") },
{ "_id" : 5, "item" : "XYZ", price: NumberDecimal("5.75"), "sizes" : null }
])
下面的操作展开sizes
数组,并对展开文档的size
字段进行分组:
db.inventory2.aggregate( [
//阶段1
{
$unwind: { path: "$sizes", preserveNullAndEmptyArrays: true }
},
//阶段2
{
$group:
{
_id: "$sizes",
averagePrice: { $avg: "$price" }
}
},
//阶段3
{
$sort: { "averagePrice": -1 }
}
] )
阶段1
$unwind
阶段为sizes
数组的每个元素输出一个文档,该阶段使用preserveNullAndEmptyArrays
选项为sizes
字段为空、缺失或空数组的情况都输出了文档,该阶段完成后输出下面的文档进入下一阶段:
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "S" }
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "M" }
{ "_id" : 1, "item" : "ABC", "price" : NumberDecimal("80"), "sizes" : "L" }
{ "_id" : 2, "item" : "EFG", "price" : NumberDecimal("120") }
{ "_id" : 3, "item" : "IJK", "price" : NumberDecimal("160"), "sizes" : "M" }
{ "_id" : 4, "item" : "LMN", "price" : NumberDecimal("10") }
{ "_id" : 5, "item" : "XYZ", "price" : NumberDecimal("5.75"), "sizes" : null }
阶段2
$group
阶段根据sizes
进行分组,并计算所有尺寸价格的平均值。该阶段完成后,生成下面的文档进入下一阶段:
{ "_id" : "S", "averagePrice" : NumberDecimal("80") }
{ "_id" : "L", "averagePrice" : NumberDecimal("80") }
{ "_id" : "M", "averagePrice" : NumberDecimal("120") }
{ "_id" : null, "averagePrice" : NumberDecimal("45.25") }
阶段3
$sort
阶段根据averagePrice
字段值从大到小对文档进行排序,该阶段完成后返回下面的文档:
{ "_id" : "M", "averagePrice" : NumberDecimal("120") }
{ "_id" : "L", "averagePrice" : NumberDecimal("80") }
{ "_id" : "S", "averagePrice" : NumberDecimal("80") }
{ "_id" : null, "averagePrice" : NumberDecimal("45.25") }