MongoDBでドキュメントの値を1つだけインクリメントする方法

MongoDBでドキュメント内の特定の値だけを更新し、インクリメント（加算）したい場合は、update()メソッドと$inc演算子を組み合わせて使用します。$incは指定したフィールドの数値を増減させるための演算子で、他のフィールドに影響を与えることなくピンポイントで値を変更できるのが特徴です。

サンプルコレクションの作成

まず、ドキュメントを格納したコレクションを作成します。

> db.demo698.insertOne({Score:78});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5ea6d8a4551299a9f98c9398")
}
> db.demo698.insertOne({Score:56});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5ea6d8a7551299a9f98c9399")
}
> db.demo698.insertOne({Score:65});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5ea6d8aa551299a9f98c939a")
}
> db.demo698.insertOne({Score:88});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5ea6d8b0551299a9f98c939b")
}

上記のコマンドでは、「demo698」というコレクションに対して、Scoreフィールドを持つ4つのドキュメントを挿入しています。

コレクション内の全ドキュメントを表示する

find()メソッドを使用すると、コレクション内のすべてのドキュメントを表示できます。

> db.demo698.find();

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

{ "_id" : ObjectId("5ea6d8a4551299a9f98c9398"), "Score" : 78 }
{ "_id" : ObjectId("5ea6d8a7551299a9f98c9399"), "Score" : 56 }
{ "_id" : ObjectId("5ea6d8aa551299a9f98c939a"), "Score" : 65 }
{ "_id" : ObjectId("5ea6d8b0551299a9f98c939b"), "Score" : 88 }

特定の値だけをインクリメントするクエリ

続いて、1つの値だけをインクリメントするクエリを見ていきましょう。ここでは、_idが「5ea6d8b0551299a9f98c939b」であるドキュメントのScoreフィールドに12を加算します。

> db.demo698.update({_id:ObjectId("5ea6d8b0551299a9f98c939b")},{$inc:{Score:12}});
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

実行結果の「nModified」が1となっていることから、該当する1件のドキュメントが正常に更新されたことがわかります。

更新結果の確認

もう一度find()メソッドを実行し、更新後の状態を確認してみましょう。

> db.demo698.find();

出力は以下の通りです。

{ "_id" : ObjectId("5ea6d8a4551299a9f98c9398"), "Score" : 78 }
{ "_id" : ObjectId("5ea6d8a7551299a9f98c9399"), "Score" : 56 }
{ "_id" : ObjectId("5ea6d8aa551299a9f98c939a"), "Score" : 65 }
{ "_id" : ObjectId("5ea6d8b0551299a9f98c939b"), "Score" : 100 }

対象ドキュメントのScoreが「88」から「100」（88＋12）に更新されていることが確認できました。このように、$inc演算子を使えば、条件に一致したドキュメントの指定フィールドだけを効率的にインクリメントできます。なお、負の値を指定すれば減算も可能なので、カウンター管理などさまざまな場面で活用できます。