$or

$or Cláusulas e índices

Al evaluar las cláusulas de la $or expresión, MongoDB realiza un escaneo de colección o de índice. Si todas las cláusulas son compatibles con los índices, MongoDB realiza escaneos de índice. Para usar índices para evaluar una $or expresión, todas las cláusulas de la $or expresión deben ser compatibles con los índices. De lo contrario, MongoDB realiza un escaneo de colección.

Al utilizar índices con queries $or, cada cláusula de $or puede utilizar su propio índice. Considere esta query:

db.inventory.find( { $or: [ { quantity: { $lt: 20 } }, { price: 10 } ] } )

Para admitir esta query, en lugar de un índice compuesto, crea un índice en quantity y otro índice en price:

db.inventory.createIndex( { quantity: 1 } )
db.inventory.createIndex( { price: 1 } )

$or y text Consultas

Si$orincluye una consulta$text, todas las cláusulas del array$ordeben estar respaldadas por un índice. Esto se debe a que una consulta $text debe usar un índice, y$orsolo puede usar índices si todas sus cláusulas están respaldadas por índices. Si la consulta $text no puede usar un índice, devuelve un error.

$or y queries geoespaciales

$or admite queries geoespaciales. Sin embargo, si utiliza una cláusula near ($near o $nearSphere), $or no puede contener ninguna otra cláusula. El uso de $or con una sola cláusula tiene el mismo efecto que omitir el operador $or.

Por ejemplo, el siguiente query no es válido porque el operador $or combina $near con otra cláusula:

db.places.find( {
   $or: [
      { location: { $near: [ 40, 5 ] } },
      { category: "restaurant" }
   ]
} )

El siguiente query es válido porque $or utiliza una cláusula geoespacial que no es near ($geoIntersects):

db.places.find( {
   $or: [
      {
         location: {
            $geoIntersects: {
               $geometry: {
                  type: "Polygon",
                  coordinates: [
                     [ [ 39, 4 ], [ 41, 4 ], [ 41, 6 ], [ 39, 4 ] ]
                  ]
               }
            }
         }
      },
      { category: "restaurant" }
   ]
} )

$or y operaciones de clasificación

Al ejecutar queries $or con sort(), MongoDB puede usar índices que admitan las cláusulas $or.

$or e índices parciales

Puede crear índices parciales con $or. Utilice partialFilterExpression del método db.collection.createIndex() para crear un índice parcial.

$or En comparación con $in

Si usas $or con <expressions> que son comprobaciones de igualdad para el valor del mismo campo, usa $in en lugar de $or.

Esta consulta selecciona documentos en la colección inventory donde quantity es 20 o 50:

db.inventory.find ( { quantity: { $in: [20, 50] } } )

Cláusulasanidadas $or

Puedes anidar $or operaciones.

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