MongoDB에서 하위 문서 배열 업데이트하기: update()와 $set 활용법

MongoDB 하위 문서 배열 업데이트 개요

MongoDB에서 배열 형태로 저장된 하위 문서(subdocument)의 특정 필드를 수정하려면 update() 메서드와 $set 연산자를 함께 사용하면 됩니다. 특히 위치 연산자 $를 활용하면 조건에 일치하는 배열 요소만 정확하게 찾아서 업데이트할 수 있습니다.

이번 글에서는 실제 예제를 통해 직원 정보 배열 안에 있는 특정 직원의 이름을 변경하는 과정을 단계별로 살펴보겠습니다.

1. 샘플 컬렉션 생성하기

먼저 insertOne() 메서드를 사용해 테스트용 문서가 담긴 컬렉션을 생성합니다.

> db.demo134.insertOne({"EmployeeId":101,"EmployeeDetails":[{"EmployeeName":"Chris","EmployeeAge":27},{"EmployeeName":"Bob","EmployeeAge":28}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e319b2f68e7f832db1a7f7c")
}
> db.demo134.insertOne({"EmployeeId":102,"EmployeeDetails":[{"EmployeeName":"David","EmployeeAge":24},{"EmployeeName":"Carol","EmployeeAge":29}]});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e319b4468e7f832db1a7f7d")
}

각 문서는 EmployeeId와 여러 명의 직원 정보를 담고 있는 EmployeeDetails 배열로 구성되어 있습니다.

2. 저장된 문서 확인하기

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

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

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

{
   "_id" : ObjectId("5e319b2f68e7f832db1a7f7c"),
   "EmployeeId" : 101,
   "EmployeeDetails" : [
      {
         "EmployeeName" : "Chris",
         "EmployeeAge" : 27
      },
      {
         "EmployeeName" : "Bob",
         "EmployeeAge" : 28
      }
   ]
}
{
   "_id" : ObjectId("5e319b4468e7f832db1a7f7d"),
   "EmployeeId" : 102,
   "EmployeeDetails" : [
      {
         "EmployeeName" : "David",
         "EmployeeAge" : 24
      },
      {
         "EmployeeName" : "Carol",
         "EmployeeAge" : 29
      }
   ]
}

3. 하위 문서 배열 업데이트 쿼리 실행하기

이제 핵심인 업데이트 쿼리입니다. EmployeeId가 101인 문서 중, EmployeeDetails 배열 안에서 이름이 "Chris"인 하위 문서를 찾아 이름을 "Robert"로 변경해 보겠습니다.

> db.demo134.update(
...    {
...       "EmployeeId":101,
...       "EmployeeDetails.EmployeeName":"Chris"
...    },
...    {
...       $set: {
...          "EmployeeDetails.$.EmployeeName" : "Robert"
...       }
...    }
... );
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

쿼리 구조 살펴보기

첫 번째 인수(조건): EmployeeId가 101이면서 배열 내 EmployeeName이 "Chris"인 문서를 찾습니다.
두 번째 인수(업데이트 내용): $set 연산자와 위치 연산자 $를 사용해 조건에 일치한 배열 요소의 EmployeeName 필드만 "Robert"로 수정합니다.

nModified : 1이라는 결과는 하나의 문서가 성공적으로 수정되었음을 의미합니다.

4. 업데이트 결과 확인하기

다시 find() 메서드로 전체 문서를 조회해 변경 사항을 확인합니다.

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

결과를 보면 첫 번째 문서의 배열에서 "Chris"였던 이름이 "Robert"로 정상적으로 변경된 것을 확인할 수 있습니다.

{
   "_id" : ObjectId("5e319b2f68e7f832db1a7f7c"),
   "EmployeeId" : 101,
   "EmployeeDetails" : [
      {
         "EmployeeName" : "Robert",
         "EmployeeAge" : 27
      },
      {
         "EmployeeName" : "Bob",
         "EmployeeAge" : 28
      }
   ]
}
{
   "_id" : ObjectId("5e319b4468e7f832db1a7f7d"),
   "EmployeeId" : 102,
   "EmployeeDetails" : [
      {
         "EmployeeName" : "David",
         "EmployeeAge" : 24
      },
      {
         "EmployeeName" : "Carol",
         "EmployeeAge" : 29
      }
   ]
}

정리

MongoDB에서 하위 문서 배열을 업데이트하는 핵심은 다음 세 가지입니다.

update() 메서드의 첫 번째 인수로 문서와 배열 요소를 식별할 조건을 지정합니다.
$set 연산자로 수정할 필드와 새 값을 정의합니다.
경로에 위치 연산자 $(EmployeeDetails.$.)를 사용해 조건에 일치하는 배열 요소만 대상으로 삼습니다.

참고로 최신 MongoDB 버전에서는 update() 대신 updateOne() 또는 updateMany() 사용이 권장되며, 동작 원리는 동일합니다. 이 패턴을 익혀두면 배열 안의 특정 요소만 선택적으로 수정하는 다양한 상황에 유용하게 활용할 수 있습니다.