$unwind

将文档中的某一个数组类型字段拆分成多条,每条包含数组中的一个值。

$unwind 两种语法结构

1. 指定 要拆分字段的路径path

  1. { $unwind: <field path> }

2. 指定一个文档格式

New in version 3.2.

  1. {
  2. $unwind:
  3. {
  4. path: <field path>,
  5. includeArrayIndex: <string>,
  6. preserveNullAndEmptyArrays: <boolean>
  7. }
  8. }

示例

拆分数组

现有集合 inventory 内容如下:

db.inventory.insert({ "_id" : 1, "item" : "ABC1", sizes: [ "S", "M", "L"] })

下面的聚合 使用$unwind 让数组中的每个元素输出一个文档:

  1. db.inventory.aggregate( [ { $unwind : "$sizes" } ] )

执行返回如下结果:

  1. { "_id" : 1, "item" : "ABC1", "sizes" : "S" }
  2. { "_id" : 1, "item" : "ABC1", "sizes" : "M" }
  3. { "_id" : 1, "item" : "ABC1", "sizes" : "L" }

includeArrayIndex and preserveNullAndEmptyArrays

现有集合 inventory 内容如下:

db.inventory.insert([{ "_id" : 1, "item" : "ABC", "sizes": [ "S", "M", "L"] },{ "_id" : 2, "item" : "EFG", "sizes" : [ ] },{ "_id" : 3, "item" : "IJK", "sizes": "M" },{ "_id" : 4, "item" : "LMN" },{ "_id" : 5, "item" : "XYZ", "sizes" : null }])

以下的$unwind 操作是等效的,并为sizes字段中的每个元素返回一个文档。

  1. db.inventory.aggregate( [ { $unwind: "$sizes" } ] )
  2. db.inventory.aggregate( [ { $unwind: { path: "$sizes" } } ] )

注意:如果sizes字段不能解析成数组,但又不属于情况(不存在,null,或一个空数组,处理方式:丢弃),$unwind 将视为一个单数组操作。

执行返回如下结果:

  1. { "_id" : 1, "item" : "ABC", "sizes" : "S" }
  2. { "_id" : 1, "item" : "ABC", "sizes" : "M" }
  3. { "_id" : 1, "item" : "ABC", "sizes" : "L" }
  4. { "_id" : 3, "item" : "IJK", "sizes" : "M" }

指定索引号 includeArrayIndex

以下的 $unwind操作 使用了 includeArrayIndex选项输出数组元素的数组索引。

  1. db.inventory.aggregate( [ { $unwind: { path: "$sizes", includeArrayIndex: "arrayIndex" } } ] )

此操作 拆分sizes字段,返回数组每个元素的的索引值

  1. { "_id" : 1, "item" : "ABC", "sizes" : "S", "arrayIndex" : NumberLong(0) }
  2. { "_id" : 1, "item" : "ABC", "sizes" : "M", "arrayIndex" : NumberLong(1) }
  3. { "_id" : 1, "item" : "ABC", "sizes" : "L", "arrayIndex" : NumberLong(2) }
  4. { "_id" : 3, "item" : "IJK", "sizes" : "M", "arrayIndex" : null }

注意:如果 sizes字段 不能解析成数组,但又不属于情况(不存在,null,或者是空数组)的话,索引值字段为null

问题:数据出现了丢失情况,sizes为不存在,[] 或者null时,数据丢失

$unwind 使用preservenullandemptyarrays选项 可以 输出sizes字段(不存在、null或空数组)的这些文档。

  1. db.inventory.aggregate( [
  2. { $unwind: { path: "$sizes", preserveNullAndEmptyArrays: true } }
  3. ] )

此操作执行返回如下结果:

  1. { "_id" : 1, "item" : "ABC", "sizes" : "S" }
  2. { "_id" : 1, "item" : "ABC", "sizes" : "M" }
  3. { "_id" : 1, "item" : "ABC", "sizes" : "L" }
  4. { "_id" : 2, "item" : "EFG" }
  5. { "_id" : 3, "item" : "IJK", "sizes" : "M" }
  6. { "_id" : 4, "item" : "LMN" }
  7. { "_id" : 5, "item" : "XYZ", "sizes" : null }

小结:

  1. {
  2. $unwind:
  3. {
  4. path: <field path>, #拆分路径
  5. includeArrayIndex: <string>, #指定数组索引号
  6. preserveNullAndEmptyArrays: <boolean> #防止数据丢失
  7. }
  8. }