MongoDBで配列内の要素を一致させて検索する方法｜$or演算子とlimit(1)の使い方

MongoDBで配列内の要素を一致させる方法

MongoDBでは、$or演算子にlimit(1)を組み合わせることで、配列内の要素を条件に一致させることができます。この記事では、実際にコレクションを作成しながら、具体的な手順をわかりやすく解説します。

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

まず、ドキュメントを含むコレクションを作成しましょう。以下の例では、学生情報を格納する「matchElementInArrayDemo」というコレクションに対して、insertOne()メソッドで2つのドキュメントを挿入しています。

> db.matchElementInArrayDemo.insertOne(
...   {
...      "StudentName" : "Chris" ,
...      "StudentOtherDetails" :
...      [
...         {"StudentCountryName" : "US" , "StudentSkills" : "MongoDB"},
...         {"StudentCountryName" : "UK" , "StudentSkills" : "Java"}
...      ]
...   }
... );
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cd423282cba06f46efe9ee2")
}
> db.matchElementInArrayDemo.insertOne(
...   {
...      "StudentName" : "Chris" ,
...      "StudentOtherDetails" :
...      [
...         {"StudentCountryName" : "AUS" , "StudentSkills" : "PHP"},
...         {"StudentCountryName" : "US" , "StudentSkills" : "MongoDB"}
...      ]
...   }
... );
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5cd423412cba06f46efe9ee3")
}

実行結果の「acknowledged: true」は、ドキュメントの挿入が正常に完了したことを示しています。各ドキュメントには、学生名（StudentName）と、国名・スキルを含む配列（StudentOtherDetails）が格納されています。

登録済みドキュメントの確認

find()メソッドを使用すると、コレクション内のすべてのドキュメントを表示できます。pretty()を付けることで、整形された読みやすい形式で出力されます。

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

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

{
    "_id" : ObjectId("5cd423282cba06f46efe9ee2"),
    "StudentName" : "Chris",
    "StudentOtherDetails" : [
        {
            "StudentCountryName" : "US",
            "StudentSkills" : "MongoDB"
        },
        {
            "StudentCountryName" : "UK",
            "StudentSkills" : "Java"
        }
    ]
}
{
    "_id" : ObjectId("5cd423412cba06f46efe9ee3"),
    "StudentName" : "Chris",
    "StudentOtherDetails" : [
        {
            "StudentCountryName" : "AUS",
            "StudentSkills" : "PHP"
        },
        {
            "StudentCountryName" : "US",
            "StudentSkills" : "MongoDB"
        }
    ]
}

$or演算子で配列内の要素を一致させるクエリ

それでは、MongoDBの配列内の要素を一致させる本体のクエリを見ていきましょう。ここでは、「StudentCountryName」が「US」であるか、または「StudentSkills」が「MongoDB」であるという条件を$or演算子で指定し、limit(1)によって最初に一致した1件のみを取得しています。

> db.matchElementInArrayDemo.find( { $or : [ {"StudentOtherDetails.StudentCountryName": "US" } ,{"StudentOtherDetails.StudentSkills": "MongoDB" } ] } ).limit(1);

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

{ "_id" : ObjectId("5cd423282cba06f46efe9ee2"), "StudentName" : "Chris", "StudentOtherDetails" : [ { "StudentCountryName" : "US", "StudentSkills" : "MongoDB" }, { "StudentCountryName" : "UK", "StudentSkills" : "Java" } ] }

ポイントまとめ

• $or演算子：複数の条件のうち、いずれか一つでも一致するドキュメントを検索できます。
• ドット記法：ネストされた配列内のフィールドには、「StudentOtherDetails.StudentCountryName」のようにアクセスします。
• limit(1)：一致した結果の最初の1件だけを取得することで、不要なデータの転送を抑え、パフォーマンスを向上させられます。

このように、$or演算子とlimit(1)を組み合わせれば、配列型フィールドを持つドキュメントから目的の要素を柔軟かつ効率的に検索できます。実際のアプリケーション開発でも頻繁に使われるテクニックなので、ぜひマスターしておきましょう。