MongoDBの$elemMatch演算子を使ってドキュメント内の配列要素を一致させる方法

MongoDBの$elemMatchとは

MongoDBの$elemMatch演算子は、配列フィールド内の要素が指定した複数の条件すべてに一致するドキュメントを検索するために使用されます。配列の中に埋め込みドキュメントが含まれている場合、特定の条件に合致する要素だけを抽出したいときに非常に便利です。

この記事では、実際のコード例を使いながら、$elemMatchを使ったドキュメントの照合方法を解説します。

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

まず、ドキュメントを含むコレクションを作成しましょう。以下のコマンドでは、demo313というコレクションに3つのドキュメントを挿入しています。各ドキュメントには、NameとAgeを持つ埋め込みドキュメントの配列detailsが含まれています。

> db.demo313.insertOne({"_id":100,"details":[{"Name":"Chris","Age":24}]});
{ "acknowledged" : true, "insertedId" : 100 }
> db.demo313.insertOne({"_id":101,"details":[{"Name":"David","Age":22}]});
{ "acknowledged" : true, "insertedId" : 101 }
> db.demo313.insertOne({"_id":102,"details":[{"Name":"Mike","Age":25}]});
{ "acknowledged" : true, "insertedId" : 102 }

insertOne()メソッドは、単一のドキュメントをコレクションに挿入します。実行すると、挿入が成功したことを示すacknowledged: trueと、挿入されたドキュメントのIDが返されます。

find()メソッドですべてのドキュメントを表示する

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

> db.demo313.find();

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

{ "_id" : 100, "details" : [ { "Name" : "Chris", "Age" : 24 } ] }
{ "_id" : 101, "details" : [ { "Name" : "David", "Age" : 22 } ] }
{ "_id" : 102, "details" : [ { "Name" : "Mike", "Age" : 25 } ] }

コレクションには3つのドキュメントが格納されており、それぞれ異なる名前と年齢のデータを持っていることが確認できます。

$elemMatchを使ってドキュメントを照合する

ここからが本題です。$elemMatchを使用して、配列内の要素が特定の条件に一致するドキュメントを検索します。以下のクエリでは、_idが101のドキュメントに対して、details配列内のAgeが22である要素のみを取得しています。

db.demo313.find({_id:101},{details: { $elemMatch: { Age: 22 } } } );

このクエリを実行すると、以下の出力が得られます。

{ "_id" : 101, "details" : [ { "Name" : "David", "Age" : 22 } ] }

$elemMatchのポイント

この結果からわかるように、$elemMatchを使用することで、以下のようなメリットがあります。

• 条件に一致する配列要素のみを返す: 配列全体ではなく、指定した条件に合致した要素だけが投影されます。
• 複数条件の組み合わせに対応: 単一の要素が複数の条件（例：年齢が22以上かつ30未満）をすべて満たす必要がある場合に特に有効です。
• 正確な照合: 通常の配列クエリでは、異なる要素がそれぞれ別の条件を満たしていれば一致とみなされることがありますが、$elemMatchでは同一の要素がすべての条件を満たす必要があります。

このように、MongoDBの$elemMatch演算子を使えば、配列内の埋め込みドキュメントに対して柔軟かつ正確な検索を行うことができます。データ構造が複雑になるほど、その有用性が高まる演算子なので、ぜひ活用してみてください。