MongoDB集計パイプラインでドキュメント配列内のオブジェクトの各プロパティ値を合計する方法

MongoDBでドキュメント内の配列に格納されたオブジェクトの個別プロパティを合計するには、aggregate()メソッドを使用します。本記事では、$unwindや$groupといった集計パイプライン演算子を組み合わせて、プレイヤーごとのスコア合計を算出する具体的な手順を解説します。

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

まず、ドキュメントを格納したコレクションを作成しましょう。以下の例では、「PlayerScore（スコア）」と「PlayerName（プレイヤー名）」を持つオブジェクトを含む「Details」配列を持つドキュメントを挿入しています。

> db.demo131.insertOne(
...     {
...        "_id": 101,
...        "Details": [
...           {
...              "PlayerScore": 500,
...              "PlayerName": "Chris"
...           },
...           {
...              "PlayerScore": 400,
...              "PlayerName": "David"
...           }
...        ]
...     }
... );
{ "acknowledged" : true, "insertedId" : 101 }
> db.demo131.insertOne(
...     {
...        "_id": 102,
...        "Details": [
...           {
...              "PlayerScore": 600,
...              "PlayerName": "Chris"
...           },
...           {
...              "PlayerScore": 200,
...              "PlayerName": "David"
...           }
...        ]
...     }
... );
{ "acknowledged" : true, "insertedId" : 102 }

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

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

> db.demo131.find();

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

{ "_id" : 101, "Details" : [ { "PlayerScore" : 500, "PlayerName" : "Chris" }, { "PlayerScore" : 400, "PlayerName" : "David" } ] }
{ "_id" : 102, "Details" : [ { "PlayerScore" : 600, "PlayerName" : "Chris" }, { "PlayerScore" : 200, "PlayerName" : "David" } ] }

配列内のプロパティを合計する集計クエリ

続いて、配列内のオブジェクトが持つ個々のプロパティ（ここではPlayerScore）を、プレイヤー名ごとに合計するクエリを紹介します。

> db.demo131.aggregate([
...    { $unwind: "$Details" },
...    {
...       $group: {
...          _id:"$Details.PlayerName",
...          Value:{$sum:"$Details.PlayerScore"}
...       }
...    },
... {
...    $group: {
...       _id: 0,
...       Details:{ $push: {Details:"$_id",Value:"$Value"}}
...       }
...    },
... {
...    $project:{Details:1,_id:0}
... } ])

クエリのポイント

• $unwind：Details配列を展開し、各要素を独立したドキュメントとして扱えるようにします。
• $group（1回目）：PlayerNameごとにグループ化し、$sumでPlayerScoreの合計値を算出します。
• $group（2回目）：$pushを使って、各プレイヤー名とその合計値を1つのDetails配列へまとめ直します。
• $project：必要なフィールドのみを出力し、_idを除外して結果を見やすくします。

実行結果

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

{ "Details" : [ { "Details" : "David", "Value" : 600 }, { "Details" : "Chris", "Value" : 1100 } ] }

結果を見ると、Chrisのスコアは500＋600で1100、Davidのスコアは400＋200で600となっており、複数ドキュメントにまたがる配列内データでも、プレイヤーごとの合計値が正しく集計できていることが確認できます。この手法は、売上明細やアクセスログなど、ネストされた配列データの統計処理にも幅広く応用できます。