ما وظيفة المعامل unwind$ في mongodb؟

يفكك $ unwind حقل مصفوفة من مستندات الإدخال لإخراج مستند لكل عنصر في هذه المصفوفة , لنحاول شرح ذلك بمثال

{ "_id" : 1, "name" : "A", "state": [ "S", "M", "L"] }
{ "_id" : 2, "name" : "B", "state" : [ ] }
{ "_id" : 3, "name" : "C", "state": "M" }
{ "_id" : 4, "name" : "D" }
{ "_id" : 5, "name" : "F", "state" : null }

لو حاولنا استخدام  $ unwind على حقل state 

db.test.aggregate( [ { $unwind: "$state" } ] )

سوف تكون النتيجة كالتالي

{ "_id" : 1, "item" : "A", "state" : "S" }
{ "_id" : 1, "item" : "A", "state" : "M" }
{ "_id" : 1, "item" : "A", "state" : "L" }
{ "_id" : 3, "item" : "C", "state" : "M" }

كما تلاحظ عملية الفك تعيد مستند لكل عنصر في حقل state
unwind$ مفيد جدا أثناء إجراء التجميع. يقوم بتقسيم المستندات المعقدة والمتداخلة إلى مستند بسيط قبل إجراء عمليات مختلفة مثل الفرز والبحث وغيرها من الاجراءات

يقوم المعامل unwind بتفكيك حقل المصفوفة من مستندات الإدخال لإخراج مستند لكل عُنصر من هذه المصفوفة تطابق هذه المستندات مُستند الإدخال غير أن خاصية المصفوفة ستأخذ عُنصر واحد في كل مرة:

مثال فرضاً أنه لديك المستند التالي:

[
  {
    title: "this is my title",
    author: "foo",
    posted: new Date(),
    pageViews: 6,
    tags: [
      "foo",
      "bar",
      "baz"
    ]
  }
]

عند إستخدام unwind بهذا الشكل:

db.collection.aggregate({
  $project: {
    author: 1,
    title: 1,
    tags: 1
  }
},
{
  $unwind: "$tags"
})

ستكون النتيجة بهذا الشكل:

[
  {
    "_id": ObjectId("5a934e000102030405000000"),
    "author": "foo",
    "tags": "foo",
    "title": "this is my title"
  },
  {
    "_id": ObjectId("5a934e000102030405000000"),
    "author": "foo",
    "tags": "bar",
    "title": "this is my title"
  },
  {
    "_id": ObjectId("5a934e000102030405000000"),
    "author": "foo",
    "tags": "baz",
    "title": "this is my title"
  }
]

يُمكنك تجربة المثال من: هنا، كان في المصفوفة ثلاث عناصر فأصبح لدينا 3 مستندات و توزعت عناصر المصفوفة على كل مستند في الخاصية tags