MongoDBで特定の値より大きい配列要素を持つドキュメントを照会する方法（$elemMatch活用）

MongoDBで配列内の値を条件に照合するには

MongoDBでは、$elemMatch 演算子を使用することで、指定したすべてのクエリ条件に一致する要素が少なくとも1つ含まれる配列フィールドを持つドキュメントを照合できます。

ここでは、配列内の値が特定の値より大きいドキュメントを検索する方法を、具体的なサンプルコードとともに解説します。

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

まず、ドキュメントを含むコレクションを作成します。

> db.demo701.insertOne({"ListOfValues":[100,200,300]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5ea6e8cf551299a9f98c93b0")
}
> db.demo701.insertOne({"ListOfValues":[500,700,1000]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5ea6e8d8551299a9f98c93b1")
}
> db.demo701.insertOne({"ListOfValues":[300,350,450]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5ea6e8e1551299a9f98c93b2")
}

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

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

> db.demo701.find();

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

{ "_id" : ObjectId("5ea6e8cf551299a9f98c93b0"), "ListOfValues" : [ 100, 200, 300 ] }
{ "_id" : ObjectId("5ea6e8d8551299a9f98c93b1"), "ListOfValues" : [ 500, 700, 1000 ] }
{ "_id" : ObjectId("5ea6e8e1551299a9f98c93b2"), "ListOfValues" : [ 300, 350, 450 ] }

3. 特定の値より大きい配列値を持つドキュメントを照合するクエリ

次のクエリでは、$elemMatch 演算子と $gt（より大きい）演算子を組み合わせて、「500より大きい値」を少なくとも1つ含む配列を持つドキュメントのみを抽出しています。

> db.demo701.find({"ListOfValues":{$elemMatch:{$gt:500}}});

4. クエリの実行結果

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

{ "_id" : ObjectId("5ea6e8d8551299a9f98c93b1"), "ListOfValues" : [ 500, 700, 1000 ] }

ポイント解説

• 配列フィールドに対して単純に {"field": {$gt: 値}} を指定した場合も動作しますが、複数条件を組み合わせる場合は $elemMatch が必須です。
• $elemMatch を使うことで、「同一の配列要素」がすべての条件を満たすことを保証できます。
• $gt のほかにも $gte（以上）、$lt（未満）、$lte（以下）などの比較演算子を組み合わせられます。

このように、$elemMatch を活用すれば、配列内の特定の条件を満たす要素を持つドキュメントを効率的かつ正確に照合できます。