$or (agregación)

Definición

$or

Evalúa una o más expresiones y devuelve true si alguna de ellas true es. De lo contrario, $or falsedevuelve.

$or tiene la siguiente sintaxis:

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

Para obtener más información sobre las expresiones, consulte Expresiones.

Comportamiento

Además del false valor booleano, evalúa$or como false los siguientes valores:, null 0 undefined y. evalúa como todos los demás $or valores,true incluidos los valores numéricos y las matrices distintos de cero.

Error Handling

Para permitir que el motor de queries las optimice, $or gestiona los errores de la siguiente manera:

• Si alguna expresión suministrada a $or causara un error al evaluarse por sí sola, el $or que contiene la expresión podría causar un error, pero no se garantiza que ocurra.

• Una expresión proporcionada después de la primera proporcionada a $or puede causar un error incluso si la primera expresión se evalúa como true.

Por ejemplo, la siguiente query siempre produce un error si $x es 0:

db.example.find( {
   $expr: { $eq: [ { $divide: [ 1, "$x" ] }, 3 ] }
} )

La siguiente query, que contiene múltiples expresiones suministradas a $or, puede generar un error si hay algún documento donde $x sea 0:

db.example.find( {
   $or: [
      { x: { $eq: 0 } },
      { $expr: { $eq: [ { $divide: [ 1, "$x" ] }, 3 ] } }
   ]
} )

Ejemplo

Considere una colección inventory con los siguientes documentos:

db.inventory.insertMany( [
   { _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 }
] )

La siguiente operación utiliza el operador para determinar $or si qty es mayor que 250 o menor 200 que:

db.inventory.aggregate(
   [
     {
       $project:
          {
            item: 1,
            result: { $or: [ { $gt: [ "$qty", 250 ] }, { $lt: [ "$qty", 200 ] } ] }
          }
     }
   ]
)

La operación devuelve los siguientes 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 }