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

Dans MongoDB, le $eq l'opérateur de pipeline d'agrégation compare deux valeurs et renvoie soit true ou false , selon que les deux valeurs sont équivalentes ou non.

Exemple

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

{ "_id" : 1, "a" : 250, "b" : 250 }
{ "_id" : 2, "a" : 250, "b" : 100 }

Nous pouvons utiliser le $eq opérateur pour comparer le a et b champs :

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 1, 2 ] } } },
     {
       $project:
          {
            a: 1,
            b: 1,
            isEquivalent: { $eq: [ "$a", "$b" ] }
          }
     }
   ]
)

Résultat :

{ "_id" : 1, "a" : 250, "b" : 250, "isEquivalent" : true }
{ "_id" : 2, "a" : 250, "b" : 100, "isEquivalent" : false }

Dans le premier document, le a et b les champs sont équivalents, ce qui donne une valeur de retour de true . Mais dans le deuxième document, ils ne sont pas équivalents, ce qui se traduit par une valeur de retour de false .

Comparer les types

Le $eq compare à la fois la valeur et le type en utilisant l'ordre de comparaison BSON spécifié pour les valeurs de différents types.

Supposons que notre collection contienne les documents suivants :

{ "_id" : 3, "a" : 250, "b" : "250" }
{ "_id" : 4, "a" : 250, "b" : NumberDecimal("250") }
{ "_id" : 5, "a" : NumberDecimal("250"), "b" : NumberDecimal("250.00") }
{ "_id" : 6, "a" : "2021-01-03T23:30:15.100Z", "b" : ISODate("2021-01-03T23:30:15.100Z") }

Nous pouvons appliquer $eq au a et b champs de ces documents :

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 3, 4, 5, 6 ] } } },
     {
       $project:
          {
            a: 1,
            b: 1,
            isEquivalent: { $eq: [ "$a", "$b" ] }
          }
     }
   ]
).pretty()

Résultat :

{ "_id" : 3, "a" : 250, "b" : "250", "isEquivalent" : false }
{ "_id" : 4, "a" : 250, "b" : NumberDecimal("250"), "isEquivalent" : true }
{
	"_id" : 5,
	"a" : NumberDecimal("250"),
	"b" : NumberDecimal("250.00"),
	"isEquivalent" : true
}
{
	"_id" : 6,
	"a" : "2021-01-03T23:30:15.100Z",
	"b" : ISODate("2021-01-03T23:30:15.100Z"),
	"isEquivalent" : false
}

Dans le document 3, les deux a et b avoir une valeur de 250 , mais si vous regardez attentivement b , c'est une chaîne (elle est entourée de guillemets doubles). Par conséquent, le premier document renvoie false .

Le document 4 renvoie true car les deux champs contiennent 250 et les deux sont des nombres. Ceci est vrai même si a est un double et b est un nombre décimal.

Le document 5 renvoie true car les deux sont des décimales et les deux ont la même valeur (même si l'un utilise explicitement des décimales et l'autre non).

Le document 6 renvoie false car, même si la valeur date/heure est exactement la même, ils utilisent des types différents pour exprimer cette date (a utilise une chaîne date/heure et b utilise un objet Date).

Valeurs nulles

Comparer une valeur à null renvoie false , sauf s'ils sont tous les deux null .

Supposons que nous ajoutions les documents suivants à notre collection :

{ "_id" : 7, "a" : 250, "b" : null }
{ "_id" : 8, "a" : null, "b" : null }

Appliquons $eq à ces documents :

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 7, 8 ] } } },
     {
       $project:
          {
            a: 1,
            b: 1,
            isEquivalent: { $eq: [ "$a", "$b" ] }
          }
     }
   ]
)

Résultat :

{ "_id" : 7, "a" : 250, "b" : null, "isEquivalent" : false }
{ "_id" : 8, "a" : null, "b" : null, "isEquivalent" : true }

Champs manquants

Si l'un des champs que vous essayez de comparer est manquant, $eq renvoie false .

Supposons que nous ajoutions le document suivant à notre collection :

{ "_id" : 9, "a" : 250 }

Appliquons $eq à ce document :

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 9 ] } } },
     {
       $project:
          {
            a: 1,
            b: 1,
            isEquivalent: { $eq: [ "$a", "$b" ] }
          }
     }
   ]
)

Résultat :

{ "_id" : 9, "a" : 250, "isEquivalent" : false }

Infini

Comparer Infinity à Infinity renvoie true .

Comparer -Infinity à -Infinity renvoie true .

Comparer Infinity à -Infinity renvoie false .

Supposons que nous ajoutions les documents suivants à notre collection :

{ "_id" : 10, "a" : Infinity, "b" : Infinity }
{ "_id" : 11, "a" : -Infinity, "b" : -Infinity }
{ "_id" : 12, "a" : Infinity, "b" : -Infinity }

Appliquons $eq à ces documents :

db.data.aggregate(
   [
     { $match: { _id: { $in: [ 10, 11, 12 ] } } },
     {
       $project:
          {
            a: 1,
            b: 1,
            isEquivalent: { $eq: [ "$a", "$b" ] }
          }
     }
   ]
)

Résultat :

{ "_id" : 10, "a" : Infinity, "b" : Infinity, "isEquivalent" : true }
{ "_id" : 11, "a" : -Infinity, "b" : -Infinity, "isEquivalent" : true }
{ "_id" : 12, "a" : Infinity, "b" : -Infinity, "isEquivalent" : false }