Operador de pipeline de agregação do MongoDB $in

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

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

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

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 .