MongoDBで条件付きアップサートや更新を実行する方法：$max演算子の使い方

MongoDBで条件付きアップサートや更新を実行する方法

MongoDBで条件付きのアップサートや更新を行いたい場合は、$max演算子を使用します。$max演算子は、指定した値とフィールドの現在値を比較し、大きい方の値でフィールドを更新します。そのため、「現在の値より大きい場合のみ更新したい」というケースに最適です。

この記事では、実際にコレクションを作成しながら、$max演算子を使った条件付き更新の手順を解説します。

1. コレクションの作成とドキュメントの挿入

まず、insertOne()メソッドを使って、スコア情報を持つドキュメントを「conditionalUpdatesDemo」コレクションに挿入します。

> db.conditionalUpdatesDemo.insertOne({"_id":100,"StudentFirstScore":89,"StudentSecondScore":78,"BiggestScore":89});
{ "acknowledged" : true, "insertedId" : 100 }
> db.conditionalUpdatesDemo.insertOne({"_id":101,"StudentFirstScore":305,"StudentSecondScore":560,"BiggestScore":1050});
{ "acknowledged" : true, "insertedId" : 101 }
> db.conditionalUpdatesDemo.insertOne({"_id":103,"StudentFirstScore":560,"StudentSecondScore":789,"BiggestScore":880});
{ "acknowledged" : true, "insertedId" : 103 }

2. 挿入したドキュメントの確認

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

> db.conditionalUpdatesDemo.find().pretty();

上記のコマンドを実行すると、次のような出力が得られます。

{
    "_id" : 100,
    "StudentFirstScore" : 89,
    "StudentSecondScore" : 78,
    "BiggestScore" : 89
}
{
    "_id" : 101,
    "StudentFirstScore" : 305,
    "StudentSecondScore" : 560,
    "BiggestScore" : 1050
}
{
    "_id" : 103,
    "StudentFirstScore" : 560,
    "StudentSecondScore" : 789,
    "BiggestScore" : 880
}

3. $max演算子による条件付き更新の実行

それでは、$max演算子を使って条件付き更新を実行してみましょう。ここでは、_idが100のドキュメントに対して「BiggestScore」フィールドを150で更新します。

> db.conditionalUpdatesDemo.update( { _id: 100 }, { $max: { "BiggestScore": 150 } } );
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

実行結果を見ると、1件のドキュメントがマッチし、1件が更新されたことがわかります（nModified : 1）。

4. 更新結果の確認

_idが100のドキュメントの「BiggestScore」が本当に150に更新されたかを確認してみましょう。

> db.conditionalUpdatesDemo.find().pretty();

実行結果：

{
    "_id" : 100,
    "StudentFirstScore" : 89,
    "StudentSecondScore" : 78,
    "BiggestScore" : 150
}
{
    "_id" : 101,
    "StudentFirstScore" : 305,
    "StudentSecondScore" : 560,
    "BiggestScore" : 1050
}
{
    "_id" : 103,
    "StudentFirstScore" : 560,
    "StudentSecondScore" : 789,
    "BiggestScore" : 880
}

ご覧のとおり、_idが100のドキュメントでは、元の値（89）よりも大きい値（150）が指定されたため、「BiggestScore」が89から150に更新されました。他のドキュメントには影響していません。

$max演算子のポイント

• 指定値が現在値より大きい場合： フィールドが指定した値に更新されます。
• 指定値が現在値より小さい場合： フィールドは一切変更されません。
• upsert:true と併用した場合： 条件に一致するドキュメントが存在しなければ、新しいドキュメントが作成されます（アップサート動作）。

このように$max演算子を活用すれば、アプリケーション側で値を比較する処理を書かなくても、データベース側でアトミックに「最大値の維持」を実現できます。ハイスコアの管理や在庫の上限値の保持など、さまざまな場面で役立つテクニックなので、ぜひ活用してください。