MongoDB $in Aggregation Pipeline Operator

I MongoDB er $in aggregeringspipeline-operatør returnerer en boolean, der angiver, om en specificeret værdi er i arrayet.

$in aggregeringspipeline-operatør må ikke forveksles med $in forespørgselsoperator, som vælger de dokumenter, hvor værdien af ​​et felt er lig med enhver værdi i det angivne array.

Eksempel

Antag, at vi har en samling kaldet products med følgende dokumenter:

{ "_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 bruge $in operatør for at finde ud af, hvorvidt sizes feltet indeholder værdien L .

Eksempel:

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

Resultat:

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

Andet argument skal løses til et array

Det andet argument i $in operatør skal løse til et array. Hvis den ikke gør det, returneres en fejl.

Antag, at vi tilføjer følgende dokument til samlingen:

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

Bemærk, at sizes felt er ikke et array – det er en streng.

Lad os anvende $in til det dokument:

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 dette tilfælde er sizes feltet indeholder en streng., og derfor returneres en fejl.

I dette eksempel bruger jeg også $in med $match operatør for at filtrere dokumenterne til kun dem, jeg er interesseret i. Bemærk, at denne bruger $in forespørgselsoperatorsyntaks, som accepterer et enkelt argument og ikke må forveksles med to argumentsyntaks.

Nul-værdier

Det samme vil ske, hvis det andet argument er null .

Lad os tilføje følgende dokument til samlingen:

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

Her er, hvad der sker, hvis vi forsøger at bruge $in med det dokument:

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

Samme fejl.

Manglende felter

Det er den samme aftale med manglende felter.

Antag, at vi tilføjer følgende dokument til vores samling:

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

Og nu prøver vi at anvende $in til de (ikke-eksisterende) sizes felt:

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

Regulære udtryk

I modsætning til $in forespørgselsoperator, $in aggregeringspipeline-operator understøtter ikke brugen af ​​regulære udtryk.

Derfor resulterer følgende kode ikke i et match:

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 for alle dokumenter er false , selvom sizes felt i alle tre dokumenter indeholder array-elementer, der starter med det store X .