Opérateur de pipeline d'agrégation $in MongoDB

Dans MongoDB, le $in L'opérateur de pipeline d'agrégation renvoie un booléen indiquant si une valeur spécifiée se trouve dans le tableau.

Le $in l'opérateur de pipeline d'agrégation ne doit pas être confondu avec le $in opérateur de requête, qui sélectionne les documents où la valeur d'un champ est égale à n'importe quelle valeur dans le tableau spécifié.

Exemple

Supposons que nous ayons une collection appelée products avec les documents suivants :

{ "_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" ] }

Nous pouvons utiliser le $in opérateur pour savoir si oui ou non les sizes le champ contient la valeur L .

Exemple :

db.products.aggregate(
   [
     {
       $project:
          {
            hasLarge: { $in: [ "L", "$sizes" ] }
          }
     }
   ]
)

Résultat :

{ "_id" : 1, "hasLarge" : false }
{ "_id" : 2, "hasLarge" : true }
{ "_id" : 3, "hasLarge" : true }

Le deuxième argument doit être résolu en un tableau

Le deuxième argument du $in L'opérateur doit se résoudre en un tableau. Si ce n'est pas le cas, une erreur est renvoyée.

Supposons que nous ajoutions le document suivant à la collection :

{ "_id" : 4, "prod" : "Shirt", "sizes" : "L" }

Notez que les sizes le champ n'est pas un tableau - c'est une chaîne.

Appliquons $in à ce document :

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 4 ] } } },
     {
       $project:
          {
            hasLarge: { $in: [ "L", "$sizes" ] }
          }
     }
   ]
)

Résultat :

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

Dans ce cas, les sizes champ contient une chaîne., et donc une erreur est renvoyée.

Dans cet exemple, j'utilise également $in avec le $match afin de filtrer les documents uniquement pour ceux qui m'intéressent. Notez que cela utilise le $in la syntaxe de l'opérateur de requête, qui accepte un seul argument et ne doit pas être confondue avec la syntaxe à deux arguments.

Valeurs nulles

La même chose se produira si le deuxième argument est null .

Ajoutons le document suivant à la collection :

{ "_id" : 5, "prod" : "Jeans", "sizes" : null }

Voici ce qui se passe si nous essayons d'utiliser $in avec ce document :

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 5 ] } } },
     {
       $project:
          {
            hasLarge: { $in: [ "L", "$sizes" ] }
          }
     }
   ]
)

Résultat :

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

Même erreur.

Champs manquants

C'est la même chose avec les champs manquants.

Supposons que nous ajoutions le document suivant à notre collection :

{ "_id" : 6, "prod" : "Shorts" }

Et maintenant, nous essayons d'appliquer $in aux sizes (inexistantes) champ :

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 6 ] } } },
     {
       $project:
          {
            hasLarge: { $in: [ "L", "$sizes" ] }
          }
     }
   ]
)

Résultat :

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

Expressions régulières

Contrairement au $in opérateur de requête, le $in L'opérateur de pipeline d'agrégation ne prend pas en charge l'utilisation d'expressions régulières.

Par conséquent, le code suivant n'entraîne pas de correspondance :

db.products.aggregate(
   [
     { $match: { _id: { $in: [ 1, 2, 3 ] } } },
     {
       $project:
          {
            hasLarge: { $in: [ /^X/, "$sizes" ] }
          }
     }
   ]
)

Résultat :

{ "_id" : 1, "hasLarge" : false }
{ "_id" : 2, "hasLarge" : false }
{ "_id" : 3, "hasLarge" : false }

Le résultat pour tous les documents est false , même si les sizes le champ dans les trois documents contient des éléments de tableau qui commencent par la majuscule X .