$ou (agregação)
Nesta página
Definição
$or
Avalia uma ou mais expressões e retorna
true
se qualquer das expressões fortrue
. Caso contrário,$or
retornafalse
.$or
tem a seguinte sintaxe:{ $or: [ <expression1>, <expression2>, ... ] } Para mais informações sobre expressões, consulte Operadores de expressão.
Comportamento
Além do valor booleano false
, $or
avalia como false
os seguintes valores: null
, 0
e undefined
. O $or
avalia todos os outros valores como true
, incluindo valores numéricos diferentes de zero e arrays.
Exemplo | Resultado |
---|---|
{ $or: [ true, false ] } | true |
{ $or: [ [ false ], false ] } | true |
{ $or: [ null, 0, undefined ] } | false |
{ $or: [ ] } | false |
Error Handling
Para permitir que o mecanismo de consulta otimize as consultas, o $or
lida com erros como segue:
Se qualquer expressão fornecida para
$or
causar um erro quando avaliada sozinha, o$or
contendo a expressão pode causar um erro, mas um erro não é garantido.Uma expressão fornecida após a primeira expressão fornecida para
$or
pode causar um erro mesmo se a primeira expressão avaliar paratrue
.
Por exemplo, a seguinte consulta sempre produz um erro se $x
for 0
:
db.example.find( { $expr: { $eq: [ { $divide: [ 1, "$x" ] }, 3 ] } } )
A consulta a seguir, que contém várias expressões fornecidas para $or
, pode gerar um erro se houver algum documento em que $x
seja 0
:
db.example.find( { $or: [ { x: { $eq: 0 } }, { $expr: { $eq: [ { $divide: [ 1, "$x" ] }, 3 ] } } ] } )
Exemplo
Considere uma coleção inventory
com os seguintes documentos:
{ "_id" : 1, "item" : "abc1", description: "product 1", qty: 300 } { "_id" : 2, "item" : "abc2", description: "product 2", qty: 200 } { "_id" : 3, "item" : "xyz1", description: "product 3", qty: 250 } { "_id" : 4, "item" : "VWZ1", description: "product 4", qty: 300 } { "_id" : 5, "item" : "VWZ2", description: "product 5", qty: 180 }
A seguinte operação utiliza o operador $or
para determinar se qty
é maior que 250 ou menor que 200
:
db.inventory.aggregate( [ { $project: { item: 1, result: { $or: [ { $gt: [ "$qty", 250 ] }, { $lt: [ "$qty", 200 ] } ] } } } ] )
A operação retorna os seguintes resultados:
{ "_id" : 1, "item" : "abc1", "result" : true } { "_id" : 2, "item" : "abc2", "result" : false } { "_id" : 3, "item" : "xyz1", "result" : false } { "_id" : 4, "item" : "VWZ1", "result" : true } { "_id" : 5, "item" : "VWZ2", "result" : true }