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