No MongoDB, o
$in
o operador de pipeline de agregação retorna um booleano indicando se um valor especificado está na matriz. O
$in
operador de pipeline de agregação não deve ser confundido com o $in
operador de consulta, que seleciona os documentos em que o valor de um campo é igual a qualquer valor na matriz especificada. Exemplo
Suponha que tenhamos uma coleção chamada
products
com os seguintes 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 o
$in
operador para descobrir se os sizes
campo contém o valor L
. Exemplo:
db.products.aggregate(
[
{
$project:
{
hasLarge: { $in: [ "L", "$sizes" ] }
}
}
]
)
Resultado:
{ "_id" : 1, "hasLarge" : false } { "_id" : 2, "hasLarge" : true } { "_id" : 3, "hasLarge" : true }
O segundo argumento deve resolver para uma matriz
O segundo argumento do
$in
operador deve resolver para uma matriz. Se isso não acontecer, um erro é retornado. Suponha que adicionamos o seguinte documento à coleção:
{ "_id" : 4, "prod" : "Shirt", "sizes" : "L" }
Observe que os
sizes
field não é um array – é uma string. Vamos aplicar
$in
a esse 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 : [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
Neste caso, os
sizes
O campo contém uma string. e, portanto, um erro é retornado. Neste exemplo, também uso
$in
com o $match
operador para filtrar os documentos apenas para aqueles em que estou interessado. Observe que isso usa o $in
sintaxe do operador de consulta, que aceita um único argumento e não deve ser confundida com a sintaxe de dois argumentos. Valores nulos
A mesma coisa acontecerá se o segundo argumento for
null
. Vamos adicionar o seguinte documento à coleção:
{ "_id" : 5, "prod" : "Jeans", "sizes" : null }
Veja o que acontece se tentarmos usar
$in
com esse 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 : [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
Mesmo erro.
Campos ausentes
É a mesma coisa com campos ausentes.
Suponha que adicionamos o seguinte documento à nossa coleção:
{ "_id" : 6, "prod" : "Shorts" }
E agora tentamos aplicar
$in
para os (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 : [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
Expressões regulares
Ao contrário do
$in
operador de consulta, o $in
operador de pipeline de agregação não oferece suporte ao uso de expressões regulares. Portanto, o código a seguir não resulta em uma correspondência:
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 }
O resultado para todos os documentos é
false
, embora os sizes
campo em todos os três documentos contém elementos de matriz que começam com o X
maiúsculo .