4 façons de mettre à jour un document dans MongoDB

MongoDB propose différentes manières de mettre à jour un document. La méthode que vous utiliserez dépendra exactement de la manière dont vous souhaitez effectuer la mise à jour.

Cet article présente 4 façons de mettre à jour un document dans MongoDB.

Le db.collection.updateOne() Méthode

Le db.collection.updateOne() La méthode fait exactement ce que son nom promet - elle met à jour un document.

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 pourrions mettre à jour un document comme celui-ci :

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

Résultat :

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

Cela n'a mis à jour qu'un seul document, même si deux documents correspondent aux critères du filtre (les critères étant type: "Dog" ).

Nous pouvons vérifier les résultats comme ceci :

db.pets.find()

Résultat :

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

Le premier document a maintenant un type de Cow au lieu de Dog , mais le deuxième document n'a pas été affecté, même s'il correspondait également aux critères de filtrage.

Le db.collection.updateMany() Méthode

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

Utilisons les documents originaux de la collection :

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

Encore une fois, 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" }

Le db.collection.update() Méthode

Le db.collection.update() peut mettre à jour un seul document ou plusieurs documents dans 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

Utilisons à nouveau la collection de documents d'origine :

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

Nous pourrions mettre à jour un 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

Revenons à nouveau à la collection de documents d'origine :

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

Et maintenant 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 .

Le db.collection.replaceOne() Méthode

Le db.collection.replaceOne() La méthode remplace un seul document dans la collection en fonction du filtre.

Toujours en utilisant la collection d'origine :

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

Voyons ce qui se passe lorsque nous utilisons le db.collection.replaceOne() méthode contre elle.

db.pets.replaceOne( 
    { type: "Dog" },
    { type: "Cow" }
    )

Résultat :

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

Un document a été mis à jour.

Jetons un coup d'œil.

db.pets.find()

Résultat :

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

Cette fois, tout le document a été remplacé par le nouveau document (sauf pour le _id domaine).

Cette méthode remplace tout le document (sauf pour le _id champ).

Mise à jour

Toutes les méthodes ci-dessus acceptent 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 la requête, mais s'il n'y a pas de correspondance, un nouveau document est inséré.

Exemple :

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

Résultat :

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

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, "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
{ "_id" : ObjectId("5fe1d5aad991410169410165"), "name" : "Wag", "type" : "Cow" }