Mise à jour MongoDB()

Dans MongoDB, le db.collection.update() modifie un document existant ou des documents d'une collection.

Par défaut, il ne met à jour qu'un seul document. Mais si multi: true est spécifié, puis il met à jour tous les documents qui correspondent aux critères de requête.

Mettre à jour un seul document

Supposons que nous ayons la collection appelée pets avec les documents suivants :

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

Nous pouvons mettre à jour un seul document comme celui-ci :

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

Résultat :

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

Un seul document a été mis à jour. Ceci est confirmé lorsque nous interrogeons la collection.

db.pets.find()

Résultat :

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

Mettre à jour plusieurs documents

Utilisons à nouveau les documents originaux :

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

Cette fois, nous allons ajouter multi: true à notre opération de mise à jour pour mettre à jour tous les documents correspondant aux critères de requête :

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

Résultat :

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

Donc, deux documents ont été appariés et mis à jour cette fois.

Reprenons notre collection :

db.pets.find()

Résultat :

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

Comme prévu, les deux documents ont maintenant un type de Cow .

Mise à jour

Le db.collection.update() la méthode accepte un upsert argument qui vous permet d'effectuer une opération upsert.

Lorsque upsert: true , le document est mis à jour s'il y a une correspondance avec les critères de filtre, mais s'il n'y a pas de correspondance, un nouveau document est inséré.

Recommençons avec les documents originaux :

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

Exemple :

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

Résultat :

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

Dans ce cas, il n'y avait pas de correspondance, donc un document a été mis à jour.

Vérifions la collection.

db.pets.find()

Résultat :

 { "_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" } 

Documents intégrés

Vous pouvez également utiliser db.collection.update() pour mettre à jour les documents intégrés.

Supposons que nous ayons le document suivant :

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

Nous pouvons utiliser le code suivant pour mettre à jour le document intégré.

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

Résultat :

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

Nous pouvons donc voir qu'un document a été mis en correspondance et modifié.

Vérifions le document.

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

Résultat :

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

Nous pouvons voir que le document intégré a été mis à jour comme spécifié.

Tableaux

Utilisons db.collection.update() pour mettre à jour un tableau.

Supposons que nous ayons le document suivant :

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

Mettons à jour deux des éléments du tableau et le nom du chien.

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

Résultat :

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

Nous pouvons voir qu'un document a été mis en correspondance et modifié.

Et maintenant regardez le document.

db.pets.find().pretty()

Résultat :

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

Le paramètre arrayFilters

Vous pouvez également utiliser les arrayFilters paramètre et le positionnel $ opérateur pour déterminer les éléments du tableau à mettre à jour.

Par exemple, supposons que nous ayons une collection appelée players avec les documents suivants :

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

Nous pourrions exécuter la requête suivante pour mettre à jour uniquement les éléments du tableau dont la valeur est supérieure à un certain montant (dans ce cas, 10).

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

Résultat :

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

Comme prévu, cela ne met à jour qu'un seul document, même si deux documents correspondent aux critères (car nous n'avons pas spécifié multi: true ).

Voici à quoi ressemblent les documents maintenant.

db.players.find()

Résultat :

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

Le document 2 avait deux éléments de tableau mis à jour, car ces éléments correspondaient aux critères.

Plus d'informations

Le db.collection.update() La méthode accepte également d'autres paramètres, tels que writeConcern , collation , et hint .

Voir la documentation MongoDB pour db.collections.update() pour plus d'informations.