MongoDBのsave()メソッドの正しい使い方を徹底解説

MongoDBのsave()メソッドとは

db.collection.save()は、ドキュメントのパラメータに応じて、既存ドキュメントの更新または新規ドキュメントの挿入を行うためのメソッドです。ドキュメントに_idフィールドが含まれており、そのIDがコレクション内に存在する場合は更新（update）として動作し、存在しない場合や_idがない場合は新規挿入（insert）として動作します。

注意： save()メソッドはMongoDB 4.2以降で非推奨（deprecated）となっています。新しいプロジェクトでは、代わりにinsertOne()やreplaceOne()などの使用が推奨されます。

ドキュメントを挿入するサンプルコード

まず、ドキュメントを含むコレクションを作成してみましょう。

> db.demo481.save({"FirstName":"Chris","LastName":"Brown"});
WriteResult({ "nInserted" : 1 })
> db.demo481.save({"FirstName":"David","LastName":"Miller"});
WriteResult({ "nInserted" : 1 })
> db.demo481.save({"FirstName":"John","LastName":"Doe"});
WriteResult({ "nInserted" : 1 })
> db.demo481.save({"FirstName":"John","LastName":"Smith"});
WriteResult({ "nInserted" : 1 })

各操作の結果としてWriteResult({ "nInserted" : 1 })が返され、1件ずつドキュメントが正常に挿入されたことが確認できます。

find()メソッドで全ドキュメントを表示する

次に、find()メソッドを使って、コレクション内のすべてのドキュメントを表示します。

> db.demo481.find();

このクエリを実行すると、以下のような出力が得られます。

{ "_id" : ObjectId("5e82db39b0f3fa88e227909c"), "FirstName" : "Chris", "LastName" : "Brown" }
{ "_id" : ObjectId("5e82db45b0f3fa88e227909d"), "FirstName" : "David", "LastName" : "Miller" }
{ "_id" : ObjectId("5e82db4db0f3fa88e227909e"), "FirstName" : "John", "LastName" : "Doe" }
{ "_id" : ObjectId("5e82db52b0f3fa88e227909f"), "FirstName" : "John", "LastName" : "Smith" }

save()とupdate()の違い

save()は_idの有無によって挿入と更新を自動的に切り替える便利なメソッドですが、意図しない上書きを防ぐためにも、更新処理にはupdateOne()やreplaceOne()、新規追加にはinsertOne()を明示的に使うことがベストプラクティスとされています。