MongoDBでサブオブジェクト（ネストされたフィールド）を更新する方法

MongoDBでは、$set 演算子とドット表記（dot notation）を組み合わせることで、ドキュメント内のサブオブジェクト（ネストされたフィールド）を簡単に更新できます。既存のサブオブジェクト全体を置き換えることなく、特定のフィールドだけを追加・変更できるのがポイントです。

この記事では、実際のコード例を通して、サブオブジェクトの更新手順を順番に解説します。

1. テスト用コレクションの作成

まず、サブオブジェクトを持つドキュメントを含むコレクションを作成します。insertOne() メソッドを使用します。

> db.updateSubObjectDemo.insertOne(
...    {
...       "ClientId" : 100,
...       "ClientDetails" : {
...          "ClientFirstName" : "Adam"
...       }
...    }
... );
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd31434b64f4b851c3a13e9")
}

この例では、「ClientDetails」というサブオブジェクトの中に「ClientFirstName」というフィールドが格納されています。

2. 作成したドキュメントの確認

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

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

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

{
   "_id" : ObjectId("5cd31434b64f4b851c3a13e9"),
   "ClientId" : 100,
   "ClientDetails" : {
      "ClientFirstName" : "Adam"
   }
}

3. $set 演算子でサブオブジェクトを更新する

続いて、MongoDBでサブオブジェクトを更新するクエリを見ていきます。ここでは、ドット表記「ClientDetails.ClientLastName」を指定し、$set 演算子で新しいフィールド「ClientLastName」を追加しています。

> db.updateSubObjectDemo.update({ClientId : 100}, { $set : { "ClientDetails.ClientLastName" : "Smith"}});
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

実行結果の「nModified : 1」は、1件のドキュメントが正常に更新されたことを示しています。

4. 更新後のドキュメントを確認する

最後に、もう一度 find() メソッドを実行して、更新結果を確認しましょう。

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

出力は次のようになります。

{
   "_id" : ObjectId("5cd31434b64f4b851c3a13e9"),
   "ClientId" : 100,
   "ClientDetails" : {
      "ClientFirstName" : "Adam",
      "ClientLastName" : "Smith"
   }
}

ご覧のとおり、「ClientDetails」サブオブジェクト内に「ClientLastName : Smith」というフィールドが追加されました。このように、既存の「ClientFirstName」フィールドはそのまま維持され、必要な部分だけが更新されていることが分かります。

まとめ

• サブオブジェクトの更新には $set 演算子を使用する
• ネストされたフィールドはドット表記（例：「親フィールド.子フィールド」）で指定する
• 存在しないフィールドを指定した場合は自動的に新規作成される

$set とドット表記を正しく使いこなせば、MongoDBのネストされたデータ構造も柔軟かつ安全に操作できます。ぜひ実際のプロジェクトでも活用してみてください。