MongoDB에서 $unwind로 하위 문서 배열 쿼리하는 방법

MongoDB에서 하위 문서(subdocument) 배열을 쿼리하려면 집계 파이프라인의 $unwind 연산자를 활용하면 됩니다. $unwind는 배열 필드를 각 요소별로 분해하여 개별 문서처럼 처리할 수 있게 해주며, 이후 $match와 $project 단계를 조합해 원하는 데이터만 정확히 추출할 수 있습니다.

1. 샘플 컬렉션 생성하기

먼저 대학 정보를 담은 하위 문서 배열을 포함하는 컬렉션을 생성해 보겠습니다.

> db.demo499.insertOne({
...   "details": [
...     {
...       Name: "MIT",
...       Rank: 1,
...       "CountryName": "US"
...     },
...     {
...       Name: "Stanford University",
...       Rank: 2
...     },
...     {
...       Name: "University of California, Berkeley",
...       Rank: 3
...     }
...   ]
... });
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e87433d987b6e0e9d18f558")
}

위 예제에서 details 필드는 세 개의 대학 정보를 담고 있는 하위 문서 배열입니다. 각 문서는 대학 이름(Name)과 순위(Rank)를 가지며, MIT 문서에만 국가 이름(CountryName)이 추가로 포함되어 있습니다.

2. find()로 전체 문서 조회하기

find() 메서드를 사용하면 컬렉션의 모든 문서를 확인할 수 있습니다.

> db.demo499.find();

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

{ "_id" : ObjectId("5e87433d987b6e0e9d18f558"), "details" : [ { "Name" : "MIT", "Rank" : 1,
"CountryName" : "US" }, { "Name" : "Stanford University", "Rank" : 2 }, { "Name" : "University
of California, Berkeley", "Rank" : 3 } ] }

3. $unwind로 하위 문서 배열 쿼리하기

이제 집계 파이프라인을 사용해 CountryName 필드가 존재하는 하위 문서만 추출해 보겠습니다.

> db.demo499.aggregate(
...   { $unwind: "$details" },
...   { $match: { "details.CountryName": { $exists: true } } },
...   { $project: { "details.Name": 1, "details.CountryName": 1, "_id": 0 } }
... )

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

{ "details" : { "Name" : "MIT", "CountryName" : "US" } }

쿼리 단계별 설명

• $unwind: details 배열을 분해하여 각 하위 문서를 독립적인 문서로 변환합니다. 즉, 하나의 문서가 세 개의 개별 문서로 펼쳐집니다.
• $match: CountryName 필드가 실제로 존재하는($exists: true) 문서만 필터링합니다. 이 예제에서는 MIT 문서만 해당됩니다.
• $project: 결과에서 Name과 CountryName 필드만 출력하고, _id 필드는 제외(0)하여 깔끔한 결과를 반환합니다.

이처럼 $unwind → $match → $project 순서로 파이프라인을 구성하면, 배열 내부의 특정 조건을 만족하는 하위 문서만 효율적으로 조회할 수 있습니다. 배열 요소 중 일부만 특정 필드를 가지고 있을 때 특히 유용한 패턴입니다.