En MongoDB, el $in El operador de canalización de agregación devuelve un valor booleano que indica si un valor específico está en la matriz.
El $in el operador de canalización de agregación no debe confundirse con $in operador de consulta, que selecciona los documentos donde el valor de un campo es igual a cualquier valor en la matriz especificada.
Ejemplo
Supongamos que tenemos una colección llamada products con los siguientes documentos:
{ "_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" ] }
Podemos usar el $in operador para averiguar si los sizes el campo contiene el valor L .
Ejemplo:
db.products.aggregate(
[
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
)Resultado:
{ "_id" : 1, "hasLarge" : false }
{ "_id" : 2, "hasLarge" : true }
{ "_id" : 3, "hasLarge" : true } El segundo argumento debe resolverse en una matriz
El segundo argumento de $in el operador debe resolverse en una matriz. Si no es así, se devuelve un error.
Supongamos que agregamos el siguiente documento a la colección:
{ "_id" : 4, "prod" : "Shirt", "sizes" : "L" }
Tenga en cuenta que los sizes el campo no es una matriz, es una cadena.
Apliquemos $in a ese documento:
db.products.aggregate(
[
{ $match: { _id: { $in: [ 4 ] } } },
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
)Resultado:
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
En este caso, los sizes El campo contiene una cadena y, por lo tanto, se devuelve un error.
En este ejemplo, también uso $in con el $match operador para filtrar los documentos solo a aquellos que me interesan. Tenga en cuenta que esto usa el $in sintaxis del operador de consulta, que acepta un único argumento y no debe confundirse con la sintaxis de dos argumentos.
Valores nulos
Ocurrirá lo mismo si el segundo argumento es null .
Agreguemos el siguiente documento a la colección:
{ "_id" : 5, "prod" : "Jeans", "sizes" : null }
Esto es lo que sucede si tratamos de usar $in con ese documento:
db.products.aggregate(
[
{ $match: { _id: { $in: [ 5 ] } } },
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
)Resultado:
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 Mismo error.
Campos faltantes
Es lo mismo con los campos que faltan.
Supongamos que agregamos el siguiente documento a nuestra colección:
{ "_id" : 6, "prod" : "Shorts" }
Y ahora tratamos de aplicar $in a los (inexistentes) sizes campo:
db.products.aggregate(
[
{ $match: { _id: { $in: [ 6 ] } } },
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
)Resultado:
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 Expresiones regulares
A diferencia del $in operador de consulta, el $in El operador de canalización de agregación no admite el uso de expresiones regulares.
Por lo tanto, el siguiente código no da como resultado una coincidencia:
db.products.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
hasLarge: { $in: [ /^X/, "$sizes" ] }
}
}
]
)Resultado:
{ "_id" : 1, "hasLarge" : false }
{ "_id" : 2, "hasLarge" : false }
{ "_id" : 3, "hasLarge" : false }
El resultado para todos los documentos es false , aunque los sizes campo en los tres documentos contiene elementos de matriz que comienzan con la mayúscula X .
