MongoDB $in Aggregation Pipeline Operator

I MongoDB, $in aggregeringspipeline-operatören returnerar en boolean som indikerar om ett angivet värde finns i arrayen.

$in aggregeringspipeline-operatör ska inte förväxlas med $in frågeoperator, som väljer de dokument där värdet på ett fält är lika med valfritt värde i den angivna matrisen.

Exempel

Anta att vi har en samling som heter products med följande dokument:

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

Vi kan använda $in operatör för att ta reda på om sizes är eller inte fältet innehåller värdet L .

Exempel:

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

Resultat:

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

Det andra argumentet måste lösas till en array

Det andra argumentet för $in operatören måste lösa till en array. Om det inte gör det returneras ett felmeddelande.

Anta att vi lägger till följande dokument i samlingen:

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

Observera att sizes fältet är inte en array – det är en sträng.

Låt oss tillämpa $in till det dokumentet:

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

Resultat:

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

I det här fallet, sizes fältet innehåller en sträng., och därför returneras ett fel.

I det här exemplet använder jag också $in med $match operatör för att filtrera dokumenten till bara de som jag är intresserad av. Observera att den här använder $in frågeoperatorsyntax, som accepterar ett enda argument och inte ska förväxlas med syntaxen för två argument.

Nullvärden

Samma sak kommer att hända om det andra argumentet är null .

Låt oss lägga till följande dokument i samlingen:

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

Här är vad som händer om vi försöker använda $in med det dokumentet:

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

Resultat:

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

Samma fel.

Fält saknas

Det är samma affär med saknade fält.

Anta att vi lägger till följande dokument i vår samling:

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

Och nu försöker vi använda $in till de (icke-existerande) sizes fält:

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

Resultat:

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

Reguljära uttryck

Till skillnad från $in frågeoperator, $in aggregeringspipeline-operatören stöder inte användningen av reguljära uttryck.

Följande kod resulterar därför inte i en matchning:

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

Resultat:

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

Resultatet för alla dokument är false , även om sizes fältet i alla tre dokument innehåller arrayelement som börjar med versaler X .