Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

$ou (agregação)

Nesta página

  • Definição
  • Comportamento
  • Error Handling
  • Exemplo
$or

Avalia uma ou mais expressões e retorna true se qualquer das expressões for true. Caso contrário, $or retorna false.

$or tem a seguinte sintaxe:

{ $or: [ <expression1>, <expression2>, ... ] }

Para mais informações sobre expressões, consulte Operadores de expressão.

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

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 para true.

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 ] } }
]
} )

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 }

Voltar

$objectToArray