MongoDB updateMany()

Dans MongoDB, le db.collection.updateMany() met à jour tous les documents qui correspondent au filtre spécifié pour une collection.

Exemple

Supposons que nous ayons une collection appelée pets qui contient les documents suivants :

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

Nous pouvons voir que deux documents ont Dog comme leur type .

Nous pouvons mettre à jour les deux documents à la fois comme ceci :

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

Résultat :

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

Cela nous montre que deux documents correspondent et deux ont été mis à jour.

Nous pouvons vérifier la collection :

db.pets.find()

Résultat :

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

Mise à jour

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

Lorsque upsert: true , tous les documents correspondant aux critères de filtre sont mis à jour, 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.updateMany( 
    { name: "Bubbles" },
    { $set: { type: "Fish" } },
    { upsert: true }
    )

Résultat :

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

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("5fe27e1dd991410169410244"), "name" : "Bubbles", "type" : "Fish" } 

Documents intégrés

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

Supposons que nous insérions les documents suivants :

db.pets.insertMany([
    {
        "_id" : 1,
        "name" : "Wag",
        "type" : "Dog",
        "specs" : {
            "height" : 400,
            "weight" : 15,
            "color" : "white"
        }
    },  
    {
        "_id" : 2,
        "name" : "Bark",
        "type" : "Dog",
        "specs" : {
            "height" : 200,
            "weight" : 12,
            "color" : "white"
        }
    }
])

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

db.pets.updateMany({ 
    type: "Dog" 
    }, { 
        $set: { 
            "specs.color": "brown",
            "specs.gooddog": false
        } 
})

Résultat :

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

Nous pouvons donc voir que les deux documents ont été mis à jour.

Vérifions le document.

db.pets.find({
    type: "Dog"
    }).pretty()

Résultat :

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"specs" : {
		"height" : 400,
		"weight" : 15,
		"color" : "brown",
		"gooddog" : false
	}
}
{
	"_id" : 2,
	"name" : "Bark",
	"type" : "Dog",
	"specs" : {
		"height" : 200,
		"weight" : 12,
		"color" : "brown",
		"gooddog" : false
	}
}

Nous pouvons voir que les documents intégrés ont été mis à jour comme spécifié.

Tableaux

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

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 ] } 

Mettons à jour deux éléments de tableau dans tous les documents.

db.players.updateMany({}, 
{ 
        $set: {
            "scores.0": 20, 
            "scores.1": 26
        } 
})

Résultat :

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

Nous pouvons voir que les trois documents ont été mis à jour. C'est parce que j'ai laissé les critères de filtre vides (j'ai utilisé {} pour les critères de filtrage).

Et regardons le document.

db.players.find()

Résultat :

 { "_id" : 1, "scores" : [ 20, 26, 3 ] }
 { "_id" : 2, "scores" : [ 20, 26, 18 ] }
 { "_id" : 3, "scores" : [ 20, 26, 8 ] } 

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, en regardant notre document précédent :

 { "_id" : 1, "scores" : [ 20, 26, 3 ] }
 { "_id" : 2, "scores" : [ 20, 26, 18 ] }
 { "_id" : 3, "scores" : [ 20, 26, 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, 15).

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

Résultat :

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

Comme prévu, tous les documents correspondent aux critères et sont donc mis à jour. Cependant, tous les éléments du tableau n'ont pas été mis à jour.

Voici à quoi ressemblent les documents maintenant.

db.players.find()

Résultat :

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

Les seuls éléments de tableau mis à jour étaient ceux dont la valeur était supérieure à 15.

Plus d'informations

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

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