MongoDBクエリで配列フィールドに特定の値が含まれるかチェックする方法

MongoDBで配列内の値を確認するには？

MongoDBでは、$in演算子を使用することで、配列型のフィールド（プロパティ）に特定の値が含まれているかどうかを簡単にチェックできます。この記事では、実際のコード例を通じて、$in演算子の基本的な使い方を解説します。

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

まず、insertOne()メソッドを使ってサンプルドキュメントを含むコレクションを作成しましょう。

> db.valueInArrayDemo.insertOne({"UserName":"John","UserMessage":["Hi","Hello","Bye"]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cd684cf7924bb85b3f48959")
}
> db.valueInArrayDemo.insertOne({"UserName":"Larry","UserMessage":["Thank You","Amazing","Nice"]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cd684d27924bb85b3f4895a")
}
> db.valueInArrayDemo.insertOne({"UserName":"Carol","UserMessage":["Awesome","Bye","Cool"]});
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cd684d87924bb85b3f4895b")
}

上記のコマンドでは、「UserName」と「UserMessage」という2つのフィールドを持つドキュメントを3件挿入しています。「UserMessage」フィールドは文字列の配列になっている点に注目してください。

2. 登録した全ドキュメントの表示

find()メソッドとpretty()メソッドを組み合わせることで、コレクション内のすべてのドキュメントを見やすい形式で表示できます。

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

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

{
    "_id" : ObjectId("5cd684cf7924bb85b3f48959"),
    "UserName" : "John",
    "UserMessage" : [
        "Hi",
        "Hello",
        "Bye"
    ]
}
{
    "_id" : ObjectId("5cd684d27924bb85b3f4895a"),
    "UserName" : "Larry",
    "UserMessage" : [
        "Thank You",
        "Amazing",
        "Nice"
    ]
}
{
    "_id" : ObjectId("5cd684d87924bb85b3f4895b"),
    "UserName" : "Carol",
    "UserMessage" : [
        "Awesome",
        "Bye",
        "Cool"
    ]
}

3. $in演算子で配列内の値を検索する

それでは本題です。$in演算子を使って、配列フィールド「UserMessage」に特定の値（ここでは「Bye」）が含まれているドキュメントを検索してみましょう。

> db.valueInArrayDemo.find({UserMessage:{$in:["Bye"]}});

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

{ "_id" : ObjectId("5cd684cf7924bb85b3f48959"), "UserName" : "John", "UserMessage" : [ "Hi", "Hello", "Bye" ] }
{ "_id" : ObjectId("5cd684d87924bb85b3f4895b"), "UserName" : "Carol", "UserMessage" : [ "Awesome", "Bye", "Cool" ] }

結果の解説

出力結果を見ると、「UserMessage」配列に「Bye」が含まれているのはJohnとCarolの2件のみです。Larryのドキュメントには「Bye」という値が存在しないため、検索結果から除外されています。

補足：複数の値を同時に検索する

$in演算子は複数の値を指定することも可能です。例えば、「Bye」と「Nice」のどちらかが含まれるドキュメントを検索したい場合は、以下のように記述します。

> db.valueInArrayDemo.find({UserMessage:{$in:["Bye", "Nice"]}});

この場合、John・Larry・Carolの全3件が該当することになります。$in演算子はOR条件のように動作し、指定したいずれかの値が配列内に存在すれば、そのドキュメントがマッチします。

まとめ

MongoDBで配列フィールドに特定の値が含まれているかをチェックするには、$in演算子が最もシンプルで効果的な方法です。単一の値だけでなく、複数の値をまとめて指定できるため、柔軟な検索条件を構築できます。配列操作に関する他の演算子（$all、$elemMatchなど）と併せて覚えておくと、より高度なクエリが書けるようになります。