MongoDBでフィールドが存在しない場合のみドキュメントに新規フィールドを挿入する方法

MongoDBでは、$exists演算子と$set演算子を組み合わせることで、「フィールドがまだ存在しない場合にのみ」新しいフィールドをドキュメントに追加できます。既存の値を上書きしたくない場合に役立つテクニックです。この記事では、実際のコマンド例とともに手順を詳しく解説します。

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

まず、ドキュメントを含むコレクションを作成しましょう。ここでは「missingDocumentDemo」というコレクションに学生情報を登録します。

> db.missingDocumentDemo.insertOne({"StudentFirstName":"Adam","StudentLastName":"Smith"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd3fb1eedc6604c74817ce6")
}
> db.missingDocumentDemo.insertOne({"StudentFirstName":"Carol","StudentLastName":"Taylor"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd3fb29edc6604c74817ce7")
}
> db.missingDocumentDemo.insertOne({"StudentFirstName":"David","StudentLastName":"Miller","StudentAge":21});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5cd3fb40edc6604c74817ce8")
}

この時点で、AdamとCarolのドキュメントには「StudentAge」フィールドがなく、Davidのドキュメントだけが「StudentAge: 21」を持っている状態です。

現在のデータを確認する

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

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

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

{
   "_id" : ObjectId("5cd3fb1eedc6604c74817ce6"),
   "StudentFirstName" : "Adam",
   "StudentLastName" : "Smith"
}
{
   "_id" : ObjectId("5cd3fb29edc6604c74817ce7"),
   "StudentFirstName" : "Carol",
   "StudentLastName" : "Taylor"
}
{
   "_id" : ObjectId("5cd3fb40edc6604c74817ce8"),
   "StudentFirstName" : "David",
   "StudentLastName" : "Miller",
   "StudentAge" : 21
}

フィールドが存在しない場合のみ挿入するクエリ

ここからが本題です。以下のクエリでは、「StudentAge」フィールドが存在しないドキュメントに対してのみ、値23の「StudentAge」フィールドを追加しています。{ "multi": true }オプションを指定することで、条件に一致するすべてのドキュメントが一括で更新されます。

> db.missingDocumentDemo.update(
...    { "StudentAge": { "$exists": false } },
...    { "$set": { "StudentAge": 23 } },
...    { "multi": true }
... );
WriteResult({ "nMatched" : 2, "nUpserted" : 0, "nModified" : 2 })

実行結果のWriteResultを見ると、「nMatched: 2」「nModified: 2」と表示されています。これは、条件に合致した2件のドキュメント（AdamとCarol）が更新されたことを意味します。すでに「StudentAge」フィールドを持つDavidのドキュメントは更新対象外となるため、元の値21はそのまま維持されます。

更新結果の確認

改めてコレクション内の全ドキュメントを表示し、結果を確認してみましょう。

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

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

{
   "_id" : ObjectId("5cd3fb1eedc6604c74817ce6"),
   "StudentFirstName" : "Adam",
   "StudentLastName" : "Smith",
   "StudentAge" : 23
}
{
   "_id" : ObjectId("5cd3fb29edc6604c74817ce7"),
   "StudentFirstName" : "Carol",
   "StudentLastName" : "Taylor",
   "StudentAge" : 23
}
{
   "_id" : ObjectId("5cd3fb40edc6604c74817ce8"),
   "StudentFirstName" : "David",
   "StudentLastName" : "Miller",
   "StudentAge" : 21
}

このように、AdamとCarolのドキュメントには新たに「StudentAge: 23」が追加された一方で、Davidの「StudentAge: 21」は上書きされずに保持されていることがわかります。$exists: falseによる条件指定と$setを組み合わせれば、既存データを保護しながら安全にフィールドを追加できるため、スキーマの段階的な拡張やデータ移行の際にも活用できる便利な手法です。