MongoDB에서 특정 필드 값만 업데이트하는 방법 – $set 연산자 활용 가이드

MongoDB에서 전체 문서를 교체하지 않고 원하는 필드의 값만 변경하고 싶을 때는 $set 연산자를 사용하면 됩니다. 이 글에서는 실제 예제를 통해 컬렉션 생성부터 특정 필드 업데이트, 결과 확인까지 단계별로 살펴보겠습니다.

1. 예제용 컬렉션 생성하기

먼저 insertOne() 메서드를 사용해 테스트용 컬렉션에 문서를 삽입합니다.

> db.demo557.insertOne({Name:"Chris"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e8f28e954b4472ed3e8e864")
}
> db.demo557.insertOne({Name:"David"});
{
   "acknowledged" : true,
   "insertedId" : ObjectId("5e8f28ee54b4472ed3e8e865")
}

2. 저장된 문서 조회하기

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

> db.demo557.find();

위 쿼리를 실행하면 다음과 같은 결과가 출력됩니다.

{ "_id" : ObjectId("5e8f28e954b4472ed3e8e864"), "Name" : "Chris" }
{ "_id" : ObjectId("5e8f28ee54b4472ed3e8e865"), "Name" : "David" }

3. $set으로 특정 필드 값만 업데이트하기

이제 Name 필드가 "Chris"인 문서를 찾아 해당 필드의 값만 "Robert"로 변경해 보겠습니다. 이때 update() 메서드와 함께 $set 연산자를 사용합니다.

> db.getCollection('demo557').update({Name:"Chris"},{$set:{Name:"Robert"}});
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

실행 결과를 보면 nMatched가 1로 조건에 일치하는 문서가 하나 있었고, nModified가 1로 실제로 한 개의 문서가 수정되었음을 알 수 있습니다.

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

다시 find() 메서드로 전체 문서를 조회해 변경 사항이 제대로 반영되었는지 확인합니다.

> db.demo557.find();

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

{ "_id" : ObjectId("5e8f28e954b4472ed3e8e864"), "Name" : "Robert" }
{ "_id" : ObjectId("5e8f28ee54b4472ed3e8e865"), "Name" : "David" }

Name이 "Chris"였던 첫 번째 문서만 "Robert"로 변경되고, 두 번째 문서는 영향을 받지 않은 것을 확인할 수 있습니다.

마무리

MongoDB에서 특정 필드 값만 안전하게 수정하려면 조건 쿼리와 $set 연산자를 함께 사용하는 것이 기본입니다. 최신 버전의 MongoDB에서는 updateOne(), updateMany()처럼 업데이트 대상 문서 수를 명확히 지정할 수 있는 메서드를 사용하는 것이 권장되니, 실무에서는 상황에 맞게 활용하시기 바랍니다.