MongoDB $in Aggregation Pipeline Operator

V MongoDB, $in Operátor agregačního kanálu vrací boolean označující, zda je zadaná hodnota v poli.

$in Operátor agregačního kanálu nelze zaměňovat s $in dotazovací operátor, který vybere dokumenty, kde se hodnota pole rovná jakékoli hodnotě v zadaném poli.

Příklad

Předpokládejme, že máme kolekci nazvanou products s následujícími dokumenty:

{ "_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" ] }

Můžeme použít $in operátora, abyste zjistili, zda sizes pole obsahuje hodnotu L .

Příklad:

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

Výsledek:

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

Druhý argument se musí vyřešit na pole

Druhý argument parametru $in operátor se musí přeložit na pole. Pokud ne, vrátí se chyba.

Předpokládejme, že do sbírky přidáme následující dokument:

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

Všimněte si, že sizes pole není pole – je to řetězec.

Aplikujme $in k tomuto dokumentu:

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

Výsledek:

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

V tomto případě sizes pole obsahuje řetězec., a proto je vrácena chyba.

V tomto příkladu také používám $in pomocí $match operátor za účelem filtrování dokumentů pouze na ty, které mě zajímají. Všimněte si, že toto používá $in syntaxe dotazovacího operátoru, který přijímá jeden argument a nesmí být zaměňován se syntaxí dvou argumentů.

Nulové hodnoty

Totéž se stane, pokud je druhý argument null .

Přidejme do sbírky následující dokument:

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

Zde je to, co se stane, když se pokusíme použít $in s tímto dokumentem:

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

Výsledek:

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

Stejná chyba.

Chybějící pole

S chybějícími poli je to stejné.

Předpokládejme, že do naší sbírky přidáme následující dokument:

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

A nyní se pokusíme použít $in na (neexistující) sizes pole:

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

Výsledek:

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

Regulární výrazy

Na rozdíl od $in operátor dotazu, $in operátor agregačního kanálu nepodporuje použití regulárních výrazů.

Proto následující kód nevede ke shodě:

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

Výsledek:

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

Výsledek pro všechny dokumenty je false , i když sizes pole ve všech třech dokumentech obsahuje prvky pole, které začínají velkým X .