/ /

문서 업데이트

개요

이 가이드 에서는 업데이트 작업을 수행하여 Java Reactive Streams 운전자 를 사용하여 MongoDB 컬렉션 의 문서를 업데이트 하는 방법을 학습 수 있습니다.

업데이트 작업은 MongoDB 컬렉션 에 있는 하나 이상의 문서를 업데이트합니다. updateOne() 또는 updateMany() 메서드를 사용하여 업데이트 작업을 수행할 수 있습니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트의 sample_restaurants 데이터베이스 의 restaurants 컬렉션 을 사용합니다.

무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 시작하기 튜토리얼을 참조하세요.

중요

프로젝트 리액터 라이브러리

이 가이드 에서는 Project Reactor 라이브러리를 사용하여 Java Reactive Streams 운전자 메서드에서 반환된 Publisher 인스턴스를 사용합니다. 프로젝트 Reactor 라이브러리와 사용 방법에 대해 자세히 학습 Reactor 문서에서 시작하기 참조하세요. 이 가이드에서 Project Reactor 라이브러리 메서드를 사용하는 방법에 대해 자세히 학습하려면 MongoDB에 데이터 쓰기 가이드를 참조하세요.

업데이트 작업

다음 방법을 사용하여 MongoDB에서 업데이트 작업을 수행할 수 있습니다.

updateOne()검색 조건과 일치하는 첫 번째 문서가 업데이트됩니다.
updateMany()검색 조건과 일치하는 모든 문서가 업데이트됩니다.

각 업데이트 방법에는 다음 매개변수가 필요합니다.

쿼리 필터하다 문서: 업데이트 할 문서를 결정합니다. 쿼리 필터 사용에 대한 자세한 내용은 필터 섹션을 참조하세요.
업데이트 문서 는 업데이트 연산자 (수행할 업데이트 의 종류)와 변경할 필드 및 값을 지정합니다. 업데이트 연산자 섹션을 참조하세요.

필터

각 업데이트 메서드에는 업데이트를 위해 선택할 문서를 결정하는 검색 기준을 지정하는 쿼리 필터하다 가 필요합니다. 필터하다 객체를 쉽게 만들 수 있도록 운전자 는 필터하다 조건 헬퍼 메서드를 제공하는 Filters 클래스를 제공합니다.

Filters 헬퍼 목록을 보려면 Filters API 문서를 참조하세요. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필터 문서 쿼리 섹션 을 참조하세요.

연산자 업데이트

문서 에서 필드 를 변경하기 위해 MongoDB 는 업데이트 연산자를 제공합니다. 업데이트 연산자를 사용하여 수행할 수정을 지정하려면 업데이트 문서 를 만듭니다. 업데이트 문서를 쉽게 만들 수 있도록 운전자 는 필터하다 조건 헬퍼 메서드가 포함된 Updates 헬퍼 클래스를 제공합니다.

중요

_id 필드는 변경할 수 없으므로 문서에서 _id 필드의 값을 변경할 수 없습니다.

업데이트 연산자에 학습 보려면 서버 매뉴얼의 업데이트 연산자 를 참조하세요.

하나의 문서 업데이트

MongoDB 컬렉션 에서 단일 문서 업데이트 하려면 updateOne() 메서드를 호출하고 쿼리 필터하다 및 업데이트 연산자를 전달합니다. 그런 다음 updateOne() 결과를 Mono의 정적 Mono.from() 메서드에 전달합니다. Mono 는 Project Reactor 라이브러리의 클래스입니다. Java Reactive Streams에서 운전자 메서드는 콜드 Publisher 인스턴스를 반환하므로 반환된 Publisher를 구독 않는 한 해당 작업이 발생하지 않습니다. 이 가이드 Project Reactor 라이브러리를 사용하여 이를 사용합니다. Mono에 대해 자세히 학습하려면 Project Reactor 문서에서 Mono 를 참조하세요.

다음 예시 에서는 updateOne() 메서드를 사용하여 일치하는 문서 의 name 값을 "Bagels N Buns" 에서 "2 Bagels 2 Buns" 로 업데이트 합니다.

 Publisher<UpdateResult> updatePublisher =
         restaurants.updateOne(eq("name", "Bagels N Buns"),
                 set("name", "2 Bagels 2 Buns"));
 Mono.from(updatePublisher).block();

여러 문서 업데이트하기

MongoDB 컬렉션 에서 여러 문서를 업데이트 하려면 updateMany() 메서드를 호출하고 쿼리 필터하다 및 업데이트 연산자를 전달합니다. 그런 다음 updateMany() 결과를 Mono의 정적 Mono.from() 메서드에 전달합니다. Mono 는 Project Reactor 라이브러리의 클래스입니다. Java Reactive Streams에서 운전자 메서드는 콜드 Publisher 인스턴스를 반환하므로 반환된 Publisher를 구독 않는 한 해당 작업이 발생하지 않습니다. 이 가이드 Project Reactor 라이브러리를 사용하여 이를 사용합니다. Mono에 대해 자세히 학습하려면 Project Reactor 문서에서 Mono 를 참조하세요.

다음 예시 에서는 updateMany() 메서드를 사용하여 cuisine 값이 "Pizza" 인 모든 문서를 cuisine 값이 "Pasta" 로 업데이트 합니다.

 Publisher<UpdateResult> updatePublisher =
         restaurants.updateMany(eq("cuisine", "Pizza"),
                 set("cuisine", "Pasta"));
 Mono.from(updatePublisher).block();

업데이트 작업 사용자 지정

UpdateOptions 클래스에는 업데이트 메서드의 동작을 수정하는 메서드가 포함되어 있습니다. UpdateOptions 클래스를 사용하려면 클래스의 새 인스턴스 를 구성한 다음 해당 메서드 중 하나 이상을 호출하여 업데이트 작업을 수정합니다. 이러한 메서드 호출을 함께 연결할 수 있습니다. 업데이트 작업의 동작을 수정하려면 클래스 인스턴스 와 연결된 메서드 호출을 updateOne() 또는 updateMany() 메서드에 세 번째 인수로 전달합니다.

UpdateOptions 클래스에서 다음과 같은 선택적 메서드를 사용하여 업데이트 작업을 수정할 수 있습니다.

메서드	설명
`arrayFilters(List<? extends Bson> arrayFilters)`	업데이트 적용할 배열 요소를 지정합니다.
`bypassDocumentValidation(Boolean bypassDocumentValidation)`	업데이트 작업에서 문서 유효성 검사를 우회할지 여부를 지정합니다. 이를 통해 스키마 유효성 검사 요구 사항을 충족하지 않는 문서(있는 경우)를 업데이트할 수 있습니다. 스키마 유효성 검사에 대한 자세한 내용은 MongoDB Server 매뉴얼의 스키마 유효성 검사를 참조하세요.
`collation(Collation collation)`	결과를 정렬할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 을 참조하세요.
`comment(BsonValue comment)`	작업에 `Bson` 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드 참조하세요.
`comment(String comment)`	작업에 `String` 주석을 첨부합니다. 자세한 내용은 MongoDB Server 매뉴얼의 명령 필드 삽입 가이드 참조하세요.
`hint(Bson hint)`	작업의 인덱스 `Bson` 값으로 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 성명서 참조하세요.
`hintString(String hint)`	작업의 인덱스 `String` 값으로 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 힌트 성명서 참조하세요.
`let(Bson variables)`	매개변수 이름과 값의 맵을 지정합니다. 값은 문서 필드를 참조하지 않는 상수 또는 닫힌 표현식이어야 합니다. 자세한 내용은 MongoDB Server 매뉴얼의 let 성명서 참조하세요.
`sort(Bson sort)`	작업에 적용 할 정렬 기준을 설정합니다. 여러 문서가 `updateOne()` 메서드에 전달한 쿼리 필터하다 와 일치하는 경우 작업은 첫 번째 결과를 업데이트합니다. 이 옵션을 설정하다 일치하는 문서에 순서를 적용 업데이트되는 문서 더 잘 제어할 수 있습니다.
`upsert(Boolean upsert)`	쿼리 필터와 일치하는 문서가 없는 경우 업데이트 작업에서 업서트 작업을 수행할지 여부를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼의 upsert 문 을 참조하세요.

업서트 예시

upsert 작업은 쿼리 필터와 일치하는 문서를 업데이트하고, 쿼리 필터와 일치하는 문서가 없으면 새 문서를 삽입합니다.

다음 코드는 updateMany() 메서드를 사용하여 borough 필드에 "Manhattan" 값이 있는 모든 문서를 찾습니다. 그리고 이 문서의 borough 값을 "Manhattan (north)"(으)로 업데이트합니다. upsert 옵션이 true(으)로 설정되어 있으므로 쿼리 필터가 기존 문서와 일치하지 않는 경우 Java Reactive Streams 드라이버가 새 문서를 삽입합니다. 예시는 쿼리 필터와 일치하는 문서 수와 업서트 작업에 의해 수정된 문서 수를 반환합니다.

Bson filter = Filters.eq("borough", "Manhattan");
Bson update = Updates.set("borough", "Manhattan (north)");
UpdateOptions options = new UpdateOptions().upsert(true);
Publisher<UpdateResult> updateManyPublisher = restaurants.updateMany(filter, update, options);
UpdateResult result = Mono.from(updateManyPublisher).block();
System.out.println("Matched: " + result.getMatchedCount()
        + ", Modified: " + result.getModifiedCount()
        + ", Upserted ID: " + result.getUpsertedId());

Matched: 10259, Modified: 10259, Upserted ID: null

반환 값

updateOne() 및 updateMany() 메서드는 각각 UpdateResult 객체 를 반환합니다. UpdateResult 유형에는 다음과 같은 인스턴스 메서드가 포함되어 있습니다.

메서드	설명
`getMatchedCount()`	업데이트된 문서 수에 관계없이 쿼리 필터와 일치하는 문서 수입니다.
`getModifiedCount()`	업데이트 작업으로 수정된 문서 수입니다. 업데이트된 문서가 원본과 동일한 경우 이 계산에 포함되지 않습니다.
`getUpsertedId()`	드라이버가 업서트를 수행한 경우 데이터베이스에 업서트된 문서의 ID입니다. 그렇지 않으면 `null`.
`wasAcknowledged()`	업데이트 승인된 경우 true를 반환합니다.

추가 정보

업데이트 연산자에 대한 자세한 내용은 MongoDB Server 매뉴얼에서 업데이트 연산자를 참조하세요.

Java Reactive Streams 드라이버를 사용하여 문서를 삽입하는 실행 가능한 코드 예제는 CRUD 작업 가이드를 참조하세요.

API 문서

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

돌아가기

지리 공간적 Atlas Search

문서 교체