MongoDBで配列内のドキュメントから特定のフィールドを投影する方法

MongoDBでは、配列内にネストされたドキュメントから特定のフィールドだけを取得したい場合があります。そんなときに役立つのが、位置演算子「$」を使った投影（プロジェクション）です。この記事では、実際のコード例を通して、その具体的な方法をわかりやすく解説します。

位置演算子（$）とは

位置演算子「$」を使用すると、クエリ条件に一致した配列内の最初の要素だけを投影できます。これにより、配列全体ではなく、必要な要素の必要なフィールドのみを効率的に取得することが可能になります。

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

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

> db.projectSpecificFieldDemo.insertOne(
    ... {
      ... "UniqueId": 101,
      ... "StudentDetails" : [{"StudentName" : "Chris", "StudentCountryName" : "US"},
        ... {"StudentName" : "Robert", "StudentCountryName" : "UK"},
      ... ]
      ... }
... );
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5ca27aeb6304881c5ce84ba2")
}
> db.projectSpecificFieldDemo.insertOne( { "UniqueId": 102, "StudentDetails" :
   [{"StudentName" : "Robert", "StudentCountryName" : "UK"}, {"StudentName" : "David",
   "StudentCountryName" : "AUS"}] } );
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5ca27b106304881c5ce84ba3")
}

この例では、学生の一意なID（UniqueId）と、学生詳細情報（StudentDetails）の配列を持つドキュメントを作成しました。各詳細情報には学生名（StudentName）と国名（StudentCountryName）が含まれています。

登録したドキュメントの確認

find()メソッドを使用すると、コレクション内のすべてのドキュメントを表示できます。

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

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

{
   "_id" : ObjectId("5ca27aeb6304881c5ce84ba2"),
   "UniqueId" : 101,
   "StudentDetails" : [
      {
         "StudentName" : "Chris",
         "StudentCountryName" : "US"
      },
      {
         "StudentName" : "Robert",
         "StudentCountryName" : "UK"
      }
   ]
}
{
   "_id" : ObjectId("5ca27b106304881c5ce84ba3"),
   "UniqueId" : 102,
   "StudentDetails" : [
      {
         "StudentName" : "Robert",
         "StudentCountryName" : "UK"
      },
      {
         "StudentName" : "David",
         "StudentCountryName" : "AUS"
      }
   ]
}

配列内の特定のフィールドを投影するクエリ

それでは本題です。位置演算子「$」を使って、配列内のドキュメントから条件に一致する要素のみを投影してみましょう。

> var myDocument = { UniqueId : 101, 'StudentDetails.StudentName' : 'Chris' };
> var myProjection = {'StudentDetails.$': 1 };
> db.projectSpecificFieldDemo.find(myDocument , myProjection).pretty();

ここでは、検索条件としてUniqueIdが101であり、かつStudentDetails配列内のStudentNameが「Chris」である要素を指定しています。そして投影部分で「StudentDetails.$」を指定することにより、条件に一致した配列要素だけを取得します。

実行結果は以下のようになります。

{
   "_id" : ObjectId("5ca27aeb6304881c5ce84ba2"),
   "StudentDetails" : [
      {
         "StudentName" : "Chris",
         "StudentCountryName" : "US"
      }
   ]
}

まとめ

このように、位置演算子「$」を活用すれば、配列内の条件に一致する最初のドキュメントだけを抽出し、不要なデータを除外した形で結果を取得できます。大量の配列データを扱う場合でも、必要な情報だけを効率よく取り出せるため、アプリケーションのパフォーマンス向上にもつながります。ぜひ実際の開発で活用してみてください。