MongoDB updateOne()

In MongoDB il db.collection.updateOne() il metodo aggiorna un singolo documento all'interno della raccolta in base al filtro.

Esempio

Supponiamo di avere una collezione chiamata pets che contiene i seguenti documenti:

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

Possiamo aggiornare un documento in questo modo:

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

Risultato:

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

Ciò ha aggiornato solo un documento, anche se due documenti corrispondono ai criteri di filtro (i criteri sono type: "Dog" ).

Possiamo controllare i risultati in questo modo:

db.pets.find()

Risultato:

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

Il primo documento ora ha un type di Cow invece di Dog , ma il secondo documento non ha subito modifiche, anche se soddisfaceva anche i criteri di filtro.

Ribaltamento

Il db.collection.updateOne() il metodo accetta un upsert argomento che consente di eseguire un'operazione di inserimento.

Quando upsert: true , il documento viene aggiornato se c'è una corrispondenza con i criteri del filtro, ma se non c'è corrispondenza, viene inserito un nuovo documento.

Ricominciamo con i documenti originali:

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

Esempio:

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

Risultato:

{
	"acknowledged" : true,
	"matchedCount" : 0,
	"modifiedCount" : 0,
	"upsertedId" : ObjectId("5fe1e94dd991410169410199")
}

In questo caso, non c'erano corrispondenze, quindi un documento è stato sostituito.

Controlliamo la collezione.

db.pets.find()

Risultato:

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

Documenti incorporati

Puoi anche usare db.collection.updateOne() per aggiornare i documenti incorporati.

Supponiamo di avere il seguente documento:

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

Possiamo utilizzare il codice seguente per aggiornare il documento incorporato.

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

Risultato:

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

Quindi possiamo vedere che un documento è stato aggiornato.

Controlliamo il documento.

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

Risultato:

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

Possiamo vedere che il documento incorporato è stato aggiornato come specificato.

Array

Usiamo db.collection.updateOne() per aggiornare un array.

Supponiamo di avere il seguente documento:

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

Aggiorniamo due degli elementi dell'array e il nome del cane.

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

Risultato:

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

Possiamo vedere che un documento è stato aggiornato.

E diamo un'occhiata al documento.

db.pets.find().pretty()

Risultato:

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

Gli arrayFilters Parametro

Puoi anche usare gli arrayFilters parametro e il $ posizionale per determinare quali elementi dell'array aggiornare.

Ad esempio, supponiamo di avere una raccolta chiamata players con i seguenti documenti:

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

Potremmo eseguire la seguente query per aggiornare solo quegli elementi dell'array che hanno un valore superiore a un determinato importo (in questo caso 10).

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

Risultato:

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 } 

Come previsto, questo aggiorna solo un documento, anche se due documenti corrispondono ai criteri.

Ecco come sono ora i documenti.

db.players.find()

Risultato:

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

Nel documento 2 sono stati aggiornati due elementi dell'array, poiché tali elementi corrispondevano ai criteri.

Maggiori informazioni

Il db.collection.updateOne() accetta anche altri parametri, come writeConcern , collation e hint .

Consulta la documentazione di MongoDB per db.collections.updateOne() per ulteriori informazioni.