Actualización de MongoDB ()

En MongoDB el db.collection.update() El método modifica un documento o documentos existentes en una colección.

Por defecto, solo actualiza un único documento. Pero si multi: true se especifica, luego actualiza todos los documentos que coinciden con los criterios de consulta.

Actualizar un solo documento

Supongamos que tenemos la colección llamada pets con los siguientes documentos:

{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Podemos actualizar un solo documento como este:

db.pets.update( 
    { type: "Dog" },
    { $set: { type: "Cow" } }
    )

Resultado:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

Solo se actualizó un documento. Esto se confirma cuando consultamos la colección.

db.pets.find()

Resultado:

{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Actualizar varios documentos

Usemos los documentos originales de nuevo:

{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Esta vez agregaremos multi: true a nuestra operación de actualización para actualizar todos los documentos que coincidan con los criterios de consulta:

db.pets.update( 
    { type: "Dog" },
    { $set: { type: "Cow" } },
    { multi: true }
    )

Resultado:

WriteResult({ "nMatched" : 2, "nUpserted" : 0, "nModified" : 2 }) 

Así que esta vez se compararon y actualizaron dos documentos.

Veamos nuestra colección de nuevo:

db.pets.find()

Resultado:

{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Cow" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Como era de esperar, ambos documentos ahora tienen un type de Cow .

Inserción

El db.collection.update() método acepta un upsert argumento que le permite realizar una operación upsert.

Cuando upsert: true , el documento se actualiza si coincide con los criterios de filtro, pero si no coincide, se inserta un nuevo documento.

Empecemos de nuevo con los documentos originales:

{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Ejemplo:

db.pets.update( 
    { name: "Bubbles" },
    { $set: { type: "Fish" } },
    { upsert: true }
    )

Resultado:

 WriteResult({
 "nMatched" : 0,
 "nUpserted" : 1,
 "nModified" : 0,
 "_id" : ObjectId("5fe2c925d9914101694102e1")
 }) 

En este caso, no hubo coincidencias, por lo que se alteró un documento.

Revisemos la colección.

db.pets.find()

Resultado:

 { "_id" : 1, "name" : "Wag", "type" : "Dog" }
 { "_id" : 2, "name" : "Bark", "type" : "Dog" }
 { "_id" : 3, "name" : "Meow", "type" : "Cat" }
 { "_id" : ObjectId("5fe2c925d9914101694102e1"), "name" : "Bubbles", "type" : "Fish" } 

Documentos incrustados

También puede usar db.collection.update() para actualizar documentos incrustados.

Supongamos que tenemos el siguiente documento:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"specs" : {
		"height" : 400,
		"weight" : 15,
		"color" : "brown"
	}
}

Podemos usar el siguiente código para actualizar el documento incrustado.

db.pets.update({ 
    _id: 1 
    }, { 
        $set: { 
            "specs.weight": 20, 
            "specs.color": "blue"
        } 
})

Resultado:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) 

Entonces podemos ver que un documento fue emparejado y modificado.

Revisemos el documento.

db.pets.find({
    _id: 1
    }).pretty()

Resultado:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"specs" : {
		"height" : 400,
		"weight" : 20,
		"color" : "blue"
	}
}

Podemos ver que el documento incrustado se actualizó según lo especificado.

Arreglos

Usemos db.collection.update() para actualizar una matriz.

Supongamos que tenemos el siguiente documento:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"awards" : [
		"Top Dog",
		"Best Dog",
		"Biggest Dog"
	]
}

Actualicemos dos de los elementos de la matriz y el nombre del perro.

db.pets.update({ 
    _id: 1 
    }, { 
        $set: { 
            "name": "Bark",
            "awards.0": "Bottom Dog", 
            "awards.1": "Worst Dog"
        } 
})

Resultado:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) 

Podemos ver que un documento fue emparejado y modificado.

Y ahora mira el documento.

db.pets.find().pretty()

Resultado:

{
	"_id" : 1,
	"name" : "Bark",
	"type" : "Dog",
	"awards" : [
		"Bottom Dog",
		"Worst Dog",
		"Biggest Dog"
	]
}

El parámetro arrayFilters

También puede usar los arrayFilters parámetro y el posicional $ operador para determinar qué elementos de la matriz actualizar.

Por ejemplo, supongamos que tenemos una colección llamada players con los siguientes documentos:

{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 17, 18 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] }

Podríamos ejecutar la siguiente consulta para actualizar solo aquellos elementos de la matriz que tengan un valor superior a cierta cantidad (en este caso, 10).

db.players.update(
   { scores: { $gte: 10 } },
   { $set: { "scores.$[e]" : 10 } },
   { arrayFilters: [ { "e": { $gte: 10 } } ] }
)

Resultado:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) 

Como era de esperar, esto solo actualiza un documento, aunque dos documentos coincidan con los criterios (porque no especificamos multi: true ).

Así es como se ven los documentos ahora.

db.players.find()

Resultado:

{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 10, 10 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] }

El documento 2 tenía dos elementos de matriz actualizados, porque esos elementos coincidían con los criterios.

Más información

El db.collection.update() El método también acepta otros parámetros, como writeConcern , collation y hint .

Consulte la documentación de MongoDB para db.collections.update() para más información.