MongoDB에서 여러 하위 문서(Sub-document)를 필터링하는 방법

MongoDB에서 하나의 문서 안에 포함된 여러 하위 문서(배열 요소)를 동시에 필터링해야 하는 경우가 있습니다. 이럴 때는 aggregate() 메서드와 애그리게이션 파이프라인($match, $unwind, $group, $project)을 활용하면 효과적입니다.

이 글에서는 실제 예제를 통해 두 개의 하위 문서 배열을 각각 조건에 맞게 필터링하는 과정을 단계별로 살펴보겠습니다.

1. 샘플 컬렉션 생성하기

먼저 insertOne() 메서드로 테스트용 문서를 생성합니다.

> db.demo200.insertOne(
...   {
...      "Id":"101",
...      "details1":[
...         {
...            "isActive":true,
...            "SubjectName":"MySQL"
...         },{
...            "isActive":false,
...            "SubjectName":"Java"
...         }
...      ],
...      "details2":[
...         {
...            "isActive":false,
...            "Name":"David"
...         },{
...            "isActive":true,
...            "Name":"Mike"
...         }
...      ]
...   }
...);
{
    "acknowledged" : true,
    "insertedId" : ObjectId("5e3c374f03d395bdc21346e4")
}

2. 저장된 문서 확인하기

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

> db.demo200.find();

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

{
    "_id" : ObjectId("5e3c374f03d395bdc21346e4"), "Id" : "101", "details1" : [
       { "isActive" : true, "SubjectName" : "MySQL" },
       { "isActive" : false, "SubjectName" : "Java" } ], "details2" : [ { "isActive" : false, "Name" : "David" },
       { "isActive" : true, "Name" : "Mike" }
    ]
}

3. 여러 하위 문서를 필터링하는 쿼리 작성하기

아래는 details1과 details2 두 배열에서 각각 isActive가 true인 하위 문서만 추출하는 애그리게이션 쿼리입니다.

핵심 흐름은 다음과 같습니다.

• $match: 문서 수준에서 Id와 isActive 조건으로 1차 필터링합니다.
• $unwind: 배열을 개별 문서로 분해하여 각 요소를 독립적으로 검사할 수 있게 합니다.
• $match: 분해된 하위 문서 중 조건(true)에 맞는 것만 남깁니다.
• $group: 원래 문서 단위로 다시 그룹화하고, $addToSet으로 중복 없이 결과를 모읍니다.
• $project: 최종 출력 형태를 지정합니다.

> var out= [
...   {
...      "$match": {
...          "Id": "101",
...          "details1.isActive": true,
...          "details2.isActive": true
...      }
...   },
...   { "$unwind": "$details1" },
...   { "$unwind": "$details2" },
...   {
...      "$match": {
...          "details1.isActive": true,
...          "details2.isActive": true
...      }
...   },
...   {
...      "$group": {
...          "_id": {
...             "_id": "$_id",
...             "Id": "$Id"
...          },
...          "details2": { "$addToSet" : "$details2" },
...          "details1": { "$addToSet" : "$details1" }
...      }
...   },
...   {
...      "$project": {
...          "_id": 0,
...          "Id": "$_id.Id",
...          "details2": 1,
...          "details1": 1
...      }
...   }
...]
>
> db.demo200.aggregate(out)

4. 실행 결과

쿼리를 실행하면 두 배열 모두에서 isActive가 true인 하위 문서만 정확히 필터링된 것을 확인할 수 있습니다.

{ "details2" : [ { "isActive" : true, "Name" : "Mike" } ], "details1" : [ { "isActive" : true, "SubjectName" : "MySQL" } ], "Id" : "101" }

정리

MongoDB에서 여러 하위 문서를 필터링할 때는 단순한 find() 쿼리만으로는 배열 내부 요소까지 정밀하게 걸러내기 어렵습니다. 위 예제처럼 $match → $unwind → $match → $group → $project 순서의 애그리게이션 파이프라인을 구성하면, 복수의 배열 필드를 원하는 조건에 따라 깔끔하게 필터링할 수 있습니다.