Dans MongoDB, le $gte
l'opérateur de pipeline d'agrégation compare deux valeurs et renvoie soit true
ou false
, selon que la première valeur est ou non supérieure ou égale à la deuxième valeur.
Exemple
Supposons que nous ayons une collection appelée data
avec les documents suivants :
{ "_id" : 1, "a" : 250, "b" : 250 } { "_id" : 2, "a" : 300, "b" : 250 } { "_id" : 3, "a" : 250, "b" : 300 }
Nous pouvons utiliser le $gte
opérateur pour comparer le a
et b
champs :
db.data.aggregate(
[
{ $match: { _id: { $in: [ 1, 2, 3 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $gte: [ "$a", "$b" ] }
}
}
]
)
Résultat :
{ "a" : 250, "b" : 250, "result" : true } { "a" : 300, "b" : 250, "result" : true } { "a" : 250, "b" : 300, "result" : false }
Dans le premier document, le a
et b
les champs sont équivalents, ce qui donne une valeur de retour de true
(car a
est bien supérieur ou égal à b
).
Dans le deuxième document a
est supérieur à b
, ce qui donne une valeur de retour de true
(encore une fois parce que a
est bien supérieur ou égal à b
).
Dans le troisième document, a
est inférieur à b
et donc le $gte
l'opérateur renvoie false
(car a
n'est pas supérieur ou égal à b
).
Comparer les types
Le $gte
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" : 4, "a" : 250, "b" : "250" } { "_id" : 5, "a" : 250, "b" : NumberDecimal("250") } { "_id" : 6, "a" : NumberDecimal("250"), "b" : NumberDecimal("250.00") } { "_id" : 7, "a" : "2022-01-03T23:30:15.100Z", "b" : ISODate("2021-01-03T23:30:15.100Z") }
Nous pouvons appliquer $gte
au a
et b
champs de ces documents :
db.data.aggregate(
[
{ $match: { _id: { $in: [ 4, 5, 6, 7 ] } } },
{
$project:
{
a: 1,
b: 1,
result: { $gte: [ "$a", "$b" ] }
}
}
]
).pretty()
Résultat :
{ "_id" : 4, "a" : 250, "b" : "250", "result" : false } { "_id" : 5, "a" : 250, "b" : NumberDecimal("250"), "result" : true } { "_id" : 6, "a" : NumberDecimal("250"), "b" : NumberDecimal("250.00"), "result" : true } { "_id" : 7, "a" : "2022-01-03T23:30:15.100Z", "b" : ISODate("2021-01-03T23:30:15.100Z"), "result" : false }
Dans le document 4, 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). Dans ce cas, $gte
renvoie false
. Si nous avions utilisé le $lte
à la place, cela aurait renvoyé true
.
Le document 5 utilise également une valeur de 250, mais l'un est un double et l'autre un décimal. Quoi qu'il en soit, ils sont équivalents, et donc $gte
renvoie true
.
De même, le document 6 renvoie true
car les deux valeurs sont équivalentes, même si l'une utilise explicitement des décimales et l'autre non.
Le document 7 renvoie true
car, même si la valeur date/heure dans a
est supérieur à celui de b
, ils utilisent différents types pour exprimer cette date (a
utilise une chaîne date/heure et b
utilise un objet Date). Si nous avions utilisé le $lte
à la place, cela aurait renvoyé true
en raison de l'ordre de comparaison BSON.
Valeurs nulles
$gte
des comparaisons peuvent être faites avec null
. Et en comparant null
à null
renvoie true
.
Supposons que nous ajoutions les documents suivants à notre collection :
{ "_id" : 8, "a" : 250, "b" : null } { "_id" : 9, "a" : null, "b" : 250 } { "_id" : 10, "a" : null, "b" : null }
Appliquons $gte
à ces documents :
db.data.aggregate(
[
{ $match: { _id: { $in: [ 8, 9, 10 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $gte: [ "$a", "$b" ] }
}
}
]
)
Résultat :
{ "a" : 250, "b" : null, "result" : true } { "a" : null, "b" : 250, "result" : false } { "a" : null, "b" : null, "result" : true }
Champs manquants
Si l'un des champs que vous essayez de comparer est manquant, $gte
renvoie true
si le deuxième champ est manquant, et false
si le premier est manquant.
Supposons que nous ajoutions les documents suivants à notre collection :
{ "_id" : 11, "a" : 250 } { "_id" : 12, "b" : 250 }
Appliquons $gte
à ces documents :
db.data.aggregate(
[
{ $match: { _id: { $in: [ 11, 12 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $gte: [ "$a", "$b" ] }
}
}
]
)
Résultat :
{ "a" : 250, "result" : true } { "b" : 250, "result" : false }
Infini
Comparer Infinity
à Infinity
renvoie true
.
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" : 13, "a" : Infinity, "b" : Infinity } { "_id" : 14, "a" : -Infinity, "b" : -Infinity } { "_id" : 15, "a" : Infinity, "b" : -Infinity } { "_id" : 16, "a" : -Infinity, "b" : Infinity }
Appliquons $gte
à ces documents :
db.data.aggregate(
[
{ $match: { _id: { $in: [ 13, 14, 15, 16 ] } } },
{
$project:
{
_id: 0,
a: 1,
b: 1,
result: { $gte: [ "$a", "$b" ] }
}
}
]
)
Résultat :
{ "a" : Infinity, "b" : Infinity, "result" : true } { "a" : -Infinity, "b" : -Infinity, "result" : true } { "a" : Infinity, "b" : -Infinity, "result" : true } { "a" : -Infinity, "b" : Infinity, "result" : false }