Docs Menu
Docs Home
/ /

Update Documents

En esta guía, aprenderá a actualizar documentos en una colección de MongoDB. Las operaciones de actualización especifican los campos y valores que se deben cambiar en uno o más documentos. Aplican los cambios especificados en un documento de actualización a uno o más documentos que coinciden con su filtro de consulta.

Para aprender cómo actualizar matrices integradas o actualizar o insertar en una sola operación, consulte las siguientes páginas:

  • Actualizar matrices en un documento

  • Insertar o Actualizar en una Operación Única

Las operaciones de actualización pueden modificar campos y valores:

  • El updateOne() El método cambia el primer documento que coincide con el filtro de consulta y el

  • El método updateMany() cambia todos los documentos que coincidan con su filtro de query.

Puedes llamar al updateOne() y métodos updateMany() en una instancia MongoCollection de la siguiente manera:

collection.updateOne(<query>, <updateDocument>);
collection.updateMany(<query>, <updateDocument>);

Los métodos updateOne() y updateMany() tienen ambos los siguientes parámetros:

  • query Especifica un filtro de consulta con los criterios para hacer coincidir los documentos que desea actualizar en su colección.

  • update especifica los campos y valores a modificar en el documento o documentos coincidentes. Los ejemplos de esta sección utilizan el Updates desarrolladores para crear el documento de actualización.

  • (Opcional) updateOptions Especifica opciones que se pueden configurar para personalizar cómo el controlador realiza la operación de actualización. Para obtener más información sobre este tipo, consulte la documentación de la API de UpdateOptions.

Puede crear el updateDocument utilizando un generador Updates de la siguiente manera:

Bson update = Updates.operator(<field>, <value>);

Para ver una lista completa de los generadores de actualizaciones y su uso, consulte Actualizaciones en la documentación de la API.

En los siguientes ejemplos, una tienda de pinturas vende cinco colores diferentes. La colección paint_inventory representa su inventario actual:

{ "_id": 1, "color": "red", "qty": 5 }
{ "_id": 2, "color": "purple", "qty": 8 }
{ "_id": 3, "color": "yellow", "qty": 0 }
{ "_id": 4, "color": "green", "qty": 6 }
{ "_id": 5, "color": "pink", "qty": 0 }

El siguiente ejemplo demuestra cómo cambiar el valor del campo color en el primer documento coincidente en el que el valor de qty es 0:

Bson filter = Filters.eq("qty", 0);
Bson update = Updates.set("color", "dandelion");
// Updates first matching document
UpdateResult result = collection.updateOne(filter, update);

Si varios documentos coinciden con el filtro de consulta especificado en el método updateOne(), se actualiza el primer resultado. Puede especificar una ordenación en una instancia UpdateOptions para aplicar un orden a los documentos coincidentes antes de que el servidor realice la operación de actualización, como se muestra en el siguiente código:

UpdateOptions options = UpdateOptions.sort(ascending("color"));
UpdateResult result = collection.updateOne(filter, document, options);

La tienda de pinturas recibe un nuevo envío y necesita actualizar su inventario. El envío contiene 20 latas de cada color de pintura.

Para actualizar el inventario, llame al método updateMany() especificando lo siguiente:

  • Filtro de consulta que coincide con todos los colores

  • Actualizar el documento que contiene instrucciones para incrementar el campo qty en 20

Bson filter = Filters.empty();
Bson update = Updates.inc("qty", 20);
// Updates all documents and prints the number of matched and modified documents
UpdateResult result = collection.updateMany(filter, update);
System.out.println("Matched document count: " + result.getMatchedCount());
System.out.println("Modified document count: " + result.getModifiedCount());

La salida del código anterior se parece a la siguiente:

Matched document count: 5
Modified document count: 5

A continuación se muestran los documentos actualizados en la colección paint_inventory:

{ "_id": 1, "color": "red", "qty": 25 }
{ "_id": 2, "color": "purple", "qty": 28 }
{ "_id": 3, "color": "yellow", "qty": 20 }
{ "_id": 4, "color": "green", "qty": 26 }
{ "_id": 5, "color": "pink", "qty": 20 }

Si ningún documento coincide con el filtro de consulta en la operación de actualización, updateMany() no realiza cambios en los documentos de la colección. Consulte nuestra guía de actualización e inserción para aprender a insertar un nuevo documento en lugar de actualizarlo si no hay documentos coincidentes.

Importante

Los métodos updateOne() y updateMany() no pueden realizar cambios en un documento que infrinjan las restricciones de índice único en la colección. Para más información sobre las restricciones en índices únicos, consulte Índices Únicos en el manual del Servidor de MongoDB.

Nota

Configuración de ejemplo

Este ejemplo se conecta a una instancia de MongoDB mediante una URI de conexión. Para obtener más información sobre cómo conectarse a su instancia de MongoDB, consulte la guía "Crear un MongoClient". Este ejemplo también utiliza la movies colección de la sample_mflix base de datos incluida en los conjuntos de datos de ejemplo de Atlas. Puede cargarlos en su base de datos en la versión gratuita de MongoDB Atlas siguiendo la guía "Empezar a usar MongoDB".

El siguiente código es un archivo completo e independiente que realiza una operación de actualización uno y una operación de actualización varios:

// Updates the first document that matches a query filter by using the Java driver
package org.example;
import org.bson.Document;
import org.bson.conversions.Bson;
import com.mongodb.MongoException;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.UpdateOptions;
import com.mongodb.client.model.Updates;
import com.mongodb.client.result.UpdateResult;
import static com.mongodb.client.model.Filters.gt;
public class Update {
public static void main(String[] args) {
// Replace the uri string with your MongoDB deployment's connection string
String uri = "<connection string uri>";
try (MongoClient mongoClient = MongoClients.create(uri)) {
MongoDatabase database = mongoClient.getDatabase("sample_mflix");
MongoCollection<Document> collection = database.getCollection("movies");
// Instructs the driver to insert a new document if none match the query
UpdateOptions options = new UpdateOptions().upsert(true);
Document updateOneQuery = new Document().append("title", "Cool Runnings 2");
// Creates instructions to update the values of three document fields
Bson updateOneUpdates = Updates.combine(
Updates.set("runtime", 99),
Updates.addToSet("genres", "Sports"),
Updates.currentTimestamp("lastUpdated"));
// Updates the first document that has a "title" value of "Cool Runnings 2"
UpdateResult result = collection.updateOne(updateOneQuery, updateOneUpdates, options);
// Prints the number of updated documents and the upserted document ID, if an upsert was performed
System.out.println("Number of documents updated - update one: " + result.getModifiedCount());
System.out.println("Upserted document ID: " + result.getUpsertedId());
Bson updateManyQuery = gt("num_mflix_comments", 50);
// Creates instructions to update the values of two document fields
Bson updateManyUpdates = Updates.combine(
Updates.addToSet("genres", "Frequently Discussed"),
Updates.currentTimestamp("lastUpdated"));
// Updates documents that have a "num_mflix_comments" value over 50
UpdateResult result = collection.updateMany(updateManyQuery, updateManyUpdates);
// Prints the number of updated documents
System.out.println("\nNumber of documents updated - update many: " + result.getModifiedCount());
}
}
}
updateOne() modified document count: 1
Upserted ID: null
updateMany() modified document count: 242

Una operación de reemplazo sustituye un documento de su colección. La sustitución se produce entre un documento que coincide con el filtro de consulta y un documento de reemplazo.

El método replaceOne() elimina todos los campos y valores existentes en el documento coincidente (excepto el _id campo) y lo sustituye con el documento de reemplazo.

Puede llamar al método replaceOne() en una instancia MongoCollection de la siguiente manera:

collection.replaceOne(<query>, <replacement>);

El método replaceOne() tiene los siguientes parámetros:

  • query Especifica un filtro de consulta con los criterios para encontrar un documento que se va a reemplazar en su colección.

  • replacement especifica los campos y valores de un nuevo objeto Document para reemplazar el documento coincidente.

  • (Opcional) replaceOptions Especifica opciones que se pueden configurar para personalizar cómo el controlador realiza la operación de reemplazo. Para obtener más información sobre este tipo, consulte la documentación de la API de "ReplaceOptions".

La tienda de pinturas se da cuenta de que deben actualizar su inventario. Lo que creían que eran 20 latas de pintura rosa, en realidad son 25 latas de pintura naranja.

Para actualizar el inventario, llame al método replaceOne() especificando lo siguiente:

  • Un filtro de query que coincide con documentos donde el color es "rosa".

  • Un documento de reemplazo donde el color es "naranja" y el qty es "25"

Bson filter = Filters.eq("color", "pink");
Document document = new Document("color", "orange").append("qty", 25);
// Replaces the first document that matches the filter with a new document
UpdateResult result = collection.replaceOne(filter, document);
// Prints the number of matched and modified documents
System.out.println("Matched document count: " + result.getMatchedCount());
System.out.println("Modified document count: " + result.getModifiedCount());

La salida del código anterior se parece a la siguiente:

Matched document count: 1
Modified document count: 1

A continuación se muestra el documento actualizado:

{ "_id": 5, "color": "orange", "qty": 25 }

Si varios documentos coinciden con el filtro de consulta especificado en el método replaceOne(), este reemplaza el primer resultado. Puede especificar una ordenación en una instancia ReplaceOptions para aplicar un orden a los documentos coincidentes antes de que el servidor realice la operación de reemplazo, como se muestra en el siguiente código:

ReplaceOptions options = ReplaceOptions.sort(ascending("qty"));
UpdateResult result = collection.replaceOne(filter, document, options);

Si ningún documento coincide con el filtro de consulta en la operación de reemplazo, replaceOne() no realiza cambios en los documentos de la colección. Consulte nuestra guía de upsert para aprender a insertar un nuevo documento en lugar de reemplazarlo si no hay documentos coincidentes.

Importante

El replaceOne() método no puede realizar cambios en un documento que infrinjan las restricciones de índice único de la colección. Para obtener más información sobre las restricciones de índice único, consulte Índices únicos en el manual de MongoDB Server.

Nota

Configuración de ejemplo

Este ejemplo se conecta a una instancia de MongoDB mediante una URI de conexión. Para obtener más información sobre cómo conectarse a su instancia de MongoDB, consulte la guía "Crear un MongoClient". Este ejemplo también utiliza la movies colección de la sample_mflix base de datos incluida en los conjuntos de datos de ejemplo de Atlas. Puede cargarlos en su base de datos en la versión gratuita de MongoDB Atlas siguiendo la guía "Empezar a usar MongoDB".

El siguiente código es un archivo completo e independiente que realiza una operación de reemplazo.

// Replaces the first document that matches a filter by using the Java driver
package org.example;
import static com.mongodb.client.model.Filters.eq;
import org.bson.Document;
import org.bson.conversions.Bson;
import com.mongodb.MongoException;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.ReplaceOptions;
import com.mongodb.client.result.UpdateResult;
public class ReplaceOne {
public static void main(String[] args) {
// Replace the uri string with your MongoDB deployment's connection string
String uri = "<connection string uri>";
try (MongoClient mongoClient = MongoClients.create(uri)) {
MongoDatabase database = mongoClient.getDatabase("sample_mflix");
MongoCollection<Document> collection = database.getCollection("movies");
Bson query = eq("title", "Music of the Heart");
// Creates a new document containing "title" and "fullplot" fields
Document replaceDocument = new Document().
append("title", "50 Violins").
append("fullplot", " A dramatization of the true story of Roberta Guaspari who co-founded the Opus 118 Harlem School of Music");
// Instructs the driver to insert a new document if none match the query
ReplaceOptions opts = new ReplaceOptions().upsert(true);
// Replaces the first document that matches the filter with a new document
UpdateResult result = collection.replaceOne(query, replaceDocument, opts);
// Prints the number of modified documents and the upserted document ID, if an upsert was performed
System.out.println("Modified document count: " + result.getModifiedCount());
System.out.println("Upserted id: " + result.getUpsertedId());
// Prints a message if any exceptions occur during the operation
} catch (MongoException me) {
System.err.println("Unable to replace due to an error: " + me);
}
}
}
Modified document count: 0
Upserted id: BsonObjectId{ ... }

Para obtener más información sobre los métodos y clases utilizados en esta página, consulte la siguiente documentación de API:

Volver

Acceder a datos desde un cursor

En esta página