MongoDB 배열 내부 문서에서 특정 필드만 프로젝션하는 방법

MongoDB 배열 내부 문서에서 특정 필드만 조회하기

배열 안에 포함된 문서에서 특정 필드만 프로젝션(조회)하려면 위치 연산자($)를 사용하면 됩니다. 위치 연산자는 쿼리 조건과 일치하는 배열 요소의 인덱스를 자동으로 참조하여, 일치하는 해당 요소만 결과로 반환해 주기 때문에 배열 전체를 가져오지 않고도 원하는 데이터만 효율적으로 추출할 수 있습니다.

1. 예제 컬렉션 생성

먼저 실습에 사용할 컬렉션을 생성하고 문서를 삽입해 보겠습니다.

> 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")
}

2. 저장된 전체 문서 확인

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"
      }
   ]
}

3. 위치 연산자($)로 특정 필드 프로젝션하기

이제 배열 내부 문서에서 특정 필드를 프로젝션하는 쿼리를 살펴보겠습니다. 먼저 조회 조건(document)과 프로젝션(projection) 객체를 각각 정의한 뒤, find() 메서드에 함께 전달합니다.

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

실행 결과는 다음과 같습니다.

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

결과 분석

출력 결과를 보면 UniqueId가 101인 문서의 StudentDetails 배열 중에서 StudentName이 'Chris'인 요소 하나만 선택되어 반환된 것을 확인할 수 있습니다. 즉, 위치 연산자($)는 쿼리 조건과 일치하는 첫 번째 배열 요소만 골라내어 프로젝션해 줍니다. 이처럼 위치 연산자를 활용하면 배열 전체를 반환하지 않고도 조건에 맞는 특정 요소만 정확하게 가져올 수 있어, 대용량 배열 데이터를 다룰 때 응답 크기를 줄이고 성능을 개선하는 데 유용합니다.