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 : [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
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 : [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
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 : [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
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
.