db.collection.findOne() (método mongosh)

Desconexión del cliente

Si el cliente que emitió db.collection.findOne() se desconecta antes de que la operación se complete, MongoDB marca db.collection.findOne() para su terminación usando killOp.

Proyección

El parámetro projection determina qué campos se devuelven en los documentos coincidentes. El parámetro projection acepta un documento con el siguiente formato:

{ field1: <value>, field2: <value> ... }

Con especificación de query vacía

La siguiente operación devuelve un solo documento de la colección bios:

db.bios.findOne()

Con una especificación de query

La siguiente operación devuelve el primer documento coincidente de la colección bios donde el campo first en el documento incrustado name comienza con la letra G o donde el campo birth es menor new Date('01/01/1945') que:

db.bios.findOne(
   {
     $or: [
            { 'name.first' : /^G/ },
            { birth: { $lt: new Date('01/01/1945') } }
          ]
   }
)

Con una proyección

El parámetro projection especifica qué campos deben devolverse. El parámetro contiene especificaciones de inclusión o exclusión, no ambas, a menos que la exclusión sea para el campo _id.

db.bios.findOne(
    { },
    { name: 1, contribs: 1 }
)

db.bios.findOne(
   { contribs: 'OOP' },
   { _id: 0, 'name.first': 0, birth: 0 }
)

Con una opción

La siguiente operación utiliza la opción sort para devolver el primer documento coincidente de la ordenada colección bios. En este ejemplo, la colección se ordena por birth en orden ascendente.

db.bios.findOne(
   { },
   { },
   { sort: { birth: 1 } }
)

El findOne documento de resultados

No puede aplicar métodos de cursor al resultado de findOne() porque se devuelve un solo documento. Tienes acceso directo al documento:

var myDocument = db.bios.findOne();
if (myDocument) {
   var myName = myDocument.name;
   print (tojson(myName));
}

Usar variables en let la opción

Puedes especificar las opciones de query para modificar el comportamiento de la query e indicar cómo se devuelven los resultados.

Por ejemplo, para definir variables a las que puedas acceder en otras partes del método findOne, utiliza la opción let. Para aplicar un filtro de resultados con una variable, debes acceder a la variable dentro del operador $expr.

Cree una colección cakeFlavors:

db.cakeFlavors.insertMany( [
   { _id: 1, flavor: "chocolate" },
   { _id: 2, flavor: "strawberry" },
   { _id: 3, flavor: "cherry" }
] )

El siguiente ejemplo define una variable targetFlavor en let y utiliza la variable para recuperar el sabor del pastel chocolate:

db.cakeFlavors.findOne(
   { $expr: { $eq: [ "$flavor", "$$targetFlavor" ] } },
   { _id: 0 },
   { let : { targetFlavor: "chocolate" }
} )

Salida:

{ flavor: 'chocolate' }

Para ver todas las opciones de consulta disponibles, consulta FindOptions.