Bulk.find.updateOne() (método mongosh)

Descripción

Bulk.find.updateOne(<update>)

Agrega una sola operación de actualización de documento a una lista de operaciones masivas.

Utilice el método Bulk.find() para especificar la condición que determina qué documento debe actualizar. El método Bulk.find.updateOne() limita la actualización a un solo documento. Para actualizar varios documentos, consulte Bulk.find.update().

Bulk.find.updateOne() acepta el siguiente parámetro:

Parameter	Tipo	Descripción
update	documento o pipeline	Las modificaciones que se deben aplicar puede ser una de las siguientes: Un documento de sustitución Contiene únicamente pares de campo y valor. Consulte también Bulk.find.replaceOne(). Update document Contiene solo expresiones de operadores de actualización. Aggregation Pipeline Contiene únicamente las siguientes etapas de agregación: $addFields y su alias $set $project y su alias $unset $replaceRoot y su alias $replaceWith Para obtener más información sobre el parámetro de modificación de actualizar, consulta la página de referencia db.collection.updateOne(). La suma del documento <query> asociado del Bulk.find() y el documento actualizado debe ser inferior o igual al tamaño máximo de documento BSON.

• Para especificar una inserción: true para esta operación, usa con Bulk.find.upsert().

• Para especificar arrayFilters para actualizar elementos específicos de un arreglo, utilícelo con Bulk.find.arrayFilters().

• Para especificar el índice a utilizar para el Bulk.find() asociado, vea Bulk.find.hint().

• Para reemplazar un documento en su totalidad, consulta también Bulk.find.replaceOne().

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Comportamiento

Si el <update> documento contiene solo expresiones de operadores de actualizar, como en:

{
  $set: { status: "D" },
  $inc: { points: 2 }
}

Luego, Bulk.find.updateOne() actualiza únicamente los campos correspondientes, status y points, en el documento.

Ejemplo

El siguiente ejemplo inicializa un constructor de operaciones de Bulk() para la colección items, y añade diversas operaciones de updateOne() a la lista de operaciones.

var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( { status: "D" } ).updateOne( { $set: { status: "I", points: "0" } } );
bulk.execute();

var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( {  status: "P" } ).updateOne(
   [
      { $set: { points: 0, lastModified: "$$NOW" } }
   ]
);
bulk.execute();