MongoDB $in оператор на конвейера за агрегация

В MongoDB, $in Операторът на конвейера за агрегиране връща булева стойност, показваща дали определена стойност е в масива.

$in Операторът на конвейера за агрегиране не трябва да се бърка с $in оператор на заявка, който избира документите, при които стойността на поле е равна на всяка стойност в посочения масив.

Пример

Да предположим, че имаме колекция, наречена products със следните документи:

{ "_id" : 1, "prod" : "Bat", "sizes" : [ "S", "M", "XL", "XXL" ] }
{ "_id" : 2, "prod" : "Hat", "sizes" : [ "S", "L", "XL" ] }
{ "_id" : 3, "prod" : "Cap", "sizes" : [ "XS", "S", "M", "L", "XL" ] }

Можем да използваме $in оператор, за да разберете дали sizes полето съдържа стойността L .

Пример:

db.products.aggregate(
   [
     {
       $project:
          {
            hasLarge: { $in: [ "L", "$sizes" ] }
          }
     }
   ]
)

Резултат:

{ "_id" : 1, "hasLarge" : false }
{ "_id" : 2, "hasLarge" : true }
{ "_id" : 3, "hasLarge" : true }

Вторият аргумент трябва да се разреши в масив

Вторият аргумент на $in операторът трябва да се разреши до масив. Ако не стане, се връща грешка.

Да предположим, че добавяме следния документ към колекцията:

{ "_id" : 4, "prod" : "Shirt", "sizes" : "L" }

Обърнете внимание, че sizes полето не е масив – това е низ.

Нека приложим $in към този документ:

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 4 ] } } },
     {
       $project:
          {
            hasLarge: { $in: [ "L", "$sizes" ] }
          }
     }
   ]
)

Резултат:

Error: command failed: {
	"ok" : 0,
	"errmsg" : "$in requires an array as a second argument, found: string",
	"code" : 40081,
	"codeName" : "Location40081"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:618:17
[email protected]/mongo/shell/assert.js:708:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1046:12
@(shell):1:1

В този случай sizes полето съдържа низ. и следователно се връща грешка.

В този пример също използвам $in с $match оператор, за да филтрирам документите само до тези, които ме интересуват. Имайте предвид, че това използва $in синтаксис на оператора на заявка, който приема единичен аргумент и не трябва да се бърка със синтаксиса на двата аргумента.

Нулеви стойности

Същото нещо ще се случи, ако вторият аргумент е null .

Нека добавим следния документ към колекцията:

{ "_id" : 5, "prod" : "Jeans", "sizes" : null }

Ето какво се случва, ако се опитаме да използваме $in с този документ:

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 5 ] } } },
     {
       $project:
          {
            hasLarge: { $in: [ "L", "$sizes" ] }
          }
     }
   ]
)

Резултат:

Error: command failed: {
	"ok" : 0,
	"errmsg" : "$in requires an array as a second argument, found: null",
	"code" : 40081,
	"codeName" : "Location40081"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:618:17
[email protected]/mongo/shell/assert.js:708:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1046:12
@(shell):1:1

Същата грешка.

Липсващи полета

Същото е и с липсващите полета.

Да предположим, че добавяме следния документ към нашата колекция:

{ "_id" : 6, "prod" : "Shorts" }

И сега се опитваме да приложим $in към (несъществуващите) sizes поле:

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 6 ] } } },
     {
       $project:
          {
            hasLarge: { $in: [ "L", "$sizes" ] }
          }
     }
   ]
)

Резултат:

Error: command failed: {
	"ok" : 0,
	"errmsg" : "$in requires an array as a second argument, found: missing",
	"code" : 40081,
	"codeName" : "Location40081"
} : aggregate failed :
[email protected]/mongo/shell/utils.js:25:13
[email protected]/mongo/shell/assert.js:18:14
[email protected]/mongo/shell/assert.js:618:17
[email protected]/mongo/shell/assert.js:708:16
[email protected]/mongo/shell/db.js:266:5
[email protected]/mongo/shell/collection.js:1046:12
@(shell):1:1

Регулярни изрази

За разлика от $in оператор на заявка, $in Операторът на конвейера за агрегиране не поддържа използването на регулярни изрази.

Следователно следният код не води до съвпадение:

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 1, 2, 3 ] } } },
     {
       $project:
          {
            hasLarge: { $in: [ /^X/, "$sizes" ] }
          }
     }
   ]
)

Резултат:

{ "_id" : 1, "hasLarge" : false }
{ "_id" : 2, "hasLarge" : false }
{ "_id" : 3, "hasLarge" : false }

Резултатът за всички документи е false , въпреки че sizes полето и в трите документа съдържа елементи от масив, които започват с главни букви X .