MongoDB Actualizar documento

En MongoDB, la operación de actualizar documentos se puede implementar de varias maneras; los métodos más utilizados incluyenupdateOne(), updateMany(), replaceOne() y findOneAndUpdate()。

1、updateOne()

El método updateOne() se utiliza para actualizar un único documento que coincida con el filtro.

Sintaxis:

db.collection.updateOne(filter, update, options)
  • filter: condición de consulta para buscar documentos.
  • update: documento o operadores de actualización que especifican la operación de actualización.
  • options: objeto de parámetros opcional, comoupsert、arrayFiltersetc.

Ejemplo

db.myCollection.updateOne(
    { name: "Alice" },                // condición de filtro
    { $set: { age: 26 } },            // operación de actualización
    { upsert: false }                 // parámetro opcional
);

2、updateMany()

El método updateMany() se utiliza para actualizar todos los documentos que coincidan con el filtro.

Sintaxis:

db.collection.updateMany(filter, update, options)
  • filter: condición de consulta para buscar documentos.
  • update: documento o operadores de actualización que especifican la operación de actualización.
  • options: objeto de parámetros opcional, comoupsert、arrayFiltersetc.

Ejemplo

db.myCollection.updateMany(
    { age: { $lt: 30 } },             // condición de filtro
    { $set: { status: "active" } },   // operación de actualización
    { upsert: false }                  // parámetro opcional
);

3、replaceOne()

El método replaceOne() se utiliza para reemplazar un único documento que coincida con el filtro; el nuevo documento reemplazará completamente al documento antiguo.

Sintaxis:

db.collection.replaceOne(filter, replacement, options)
  • filter: condición de consulta para buscar documentos.
  • replacement: nuevo documento que reemplazará al antiguo.
  • options: objeto de parámetros opcional, comoupsertetc.

Ejemplo

db.myCollection.replaceOne(
{ name: "Bob" }, // condición de filtro
{ name: "Bob", age: 31 } // nuevo documento
);

4、findOneAndUpdate()

El método findOneAndUpdate() se utiliza para buscar y actualizar un único documento, y puede devolver opcionalmente el documento antes o después de la actualización.

Sintaxis:

db.collection.findOneAndUpdate(filter, update, options)
  • filter: condición de consulta para buscar documentos.
  • update: documento o operadores de actualización que especifican la operación de actualización.
  • options: objeto de parámetros opcional, comoprojection、sort、upsert、returnDocumentetc.

Ejemplo

db.myCollection.findOneAndUpdate(
    { name: "Charlie" },              // condición de filtro
    { $set: { age: 36 } },            // operación de actualización
    { returnDocument: "after" }       // parámetro opcional, devolver el documento actualizado
);

Parámetros de opciones

El parámetro options de estos métodos de actualización generalmente puede incluir las siguientes opciones:

  • upsert: si no hay documentos coincidentes, inserta un nuevo documento.
  • arrayFilters: al actualizar arrays anidados, especifica la condición del elemento del array que se debe actualizar.
  • collation: especifica la collation que se utilizará al comparar cadenas.
  • returnDocument: se utiliza en findOneAndUpdate, especifica si se devuelve el documento antes ("before") o después ("after") de la actualización.

Ejemplo simple

Actualizar un solo documento:

db.myCollection.updateOne(
    { name: "Alice" },
    { $set: { age: 26 } }
);

Actualizar varios documentos:

db.myCollection.updateMany(
    { age: { $lt: 30 } },
    { $set: { status: "active" } }
);

Reemplazar un solo documento:

db.myCollection.replaceOne(
    { name: "Bob" },
    { name: "Bob", age: 31 }
);

Buscar y actualizar un solo documento:

db.myCollection.findOneAndUpdate(
    { name: "Charlie" },
    { $set: { age: 36 } },
    { returnDocument: "after" }
);

En el siguiente ejemplo, reemplazamos los datos del documento con _id 56064f89ade2f21f36b03136:

>db.col.save({
    "_id" : ObjectId("56064f89ade2f21f36b03136"),
    "title" : "MongoDB",
    "description" : "MongoDB 是一个 Nosql 数据库",
    "by" : "Ejemplo",
    "url" : "http://www.example.com",
    "tags" : [
            "mongodb",
            "NoSQL"
    ],
    "likes" : 110
})

Después de un reemplazo exitoso, podemos usar el comando find() para ver los datos reemplazados.

>db.col.find().pretty()
{
        "_id" : ObjectId("56064f89ade2f21f36b03136"),
        "title" : "MongoDB",
        "description" : "MongoDB 是一个 Nosql 数据库",
        "by" : "Ejemplo",
        "url" : "http://www.example.com",
        "tags" : [
                "mongodb",
                "NoSQL"
        ],
        "likes" : 110
}
>

Más ejemplos

Actualizar solo el primer registro:

db.col.update( { "count" : { $gt : 1 } } , { $set : { "test2" : "OK"} } );

Actualizar todos:

db.col.update( { "count" : { $gt : 3 } } , { $set : { "test2" : "OK"} },false,true );

Agregar solo el primero:

db.col.update( { "count" : { $gt : 4 } } , { $set : { "test5" : "OK"} },true,false );

Agregar todos:

db.col.update( { "count" : { $gt : 5 } } , { $set : { "test5" : "OK"} },true,true );

Actualizar todos:

db.col.update( { "count" : { $gt : 15 } } , { $inc : { "count" : 1} },false,true );

Actualizar solo el primer registro:

db.col.update( { "count" : { $gt : 10 } } , { $inc : { "count" : 1} },false,false );
Otras extensiones