Docs Menu
Docs Home
/
언어
/
Java
/
Java Reactive Streams 드라이버
/
MongoDB에 데이터 쓰기

문서 업데이트

이 페이지의 내용

  • 개요
  • 샘플 데이터
  • 업데이트 작업
  • 필터
  • 연산자 업데이트
  • 하나의 문서 업데이트
  • 여러 문서 업데이트하기
  • 업데이트 작업 사용자 지정
  • 예시
  • 반환 값
  • 추가 정보
  • API 문서

개요

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

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

샘플 데이터

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

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

중요

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

이 가이드 에서는 Project Reactor 라이브러리를 사용하여 Java Reactive Streams 운전자 메서드에서 반환된 Publisher 인스턴스를 사용합니다. Project 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)
Specifies which array elements an update applies to.
bypassDocumentValidation(Boolean bypassDocumentValidation)
Specifies whether the update operation bypasses document validation. This lets you update documents that don't meet the schema validation requirements, if any exist. For more information about schema validation, see Schema Validation in the MongoDB Server manual.
collation(Collation collation)
Specifies the kind of language collation to use when sorting results. For more information, see Collation in the MongoDB Server manual.
comment(Bson comment)
Attaches a Bson comment to the operation. For more information, see the insert command fields guide in the MongoDB Server manual.
comment(String comment)
Attaches a String comment to the operation. For more information, see the insert command fields guide in the MongoDB Server manual.
hint(Bson hint)
Sets the index for the operation as a Bson value. For more information, see the hint statement in the MongoDB Server manual.
hint(String hint)
Sets the index for the operation as a String value. For more information, see the hint statement in the MongoDB Server manual.
let(Bson variables)
Specifies a map of parameter names and values. Values must be constant or closed expressions that don't reference document fields. For more information, see the let statement in the MongoDB Server manual.
upsert(Boolean upsert)
Specifies whether the update operation performs an upsert operation if no documents match the query filter. For more information, see the upsert statement in the MongoDB Server manual.

예시

다음 코드는 updateMany() 메서드를 사용하여 borough 필드 의 값이 "Manhattan" 인 모든 문서를 찾습니다. 그런 다음 이러한 문서의 borough 값을 "Manhattan (north)" 로 업데이트합니다. upsert 옵션이 true 로 설정하다 되어 있기 때문에 쿼리 필터하다 가 기존 문서와 일치하지 않는 경우 Java Reactive Streams 운전자 는 새 문서 를 삽입합니다.

 Publisher<UpdateResult> updatePublisher = restaurants.updateMany(
         eq("borough", "Manhattan"),
         set("borough", "Manhattan (north)"),
         new UpdateOptions().upsert(true));
 Mono.from(updatePublisher).block();

반환 값

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

메서드
설명
getMatchedCount()
The number of documents that matched the query filter, regardless of how many were updated.
getModifiedCount()
The number of documents modified by the update operation. If an updated document is identical to the original, it is not included in this count.
getUpsertedId()
The ID of the document that was upserted in the database, if the driver performed an upsert. Otherwise null.
wasAcknowledged()
Returns true if the update was acknowledged.

추가 정보

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

Java Reactive Streams 운전자 를 사용하여 문서를 삽입하는 실행 가능한 코드 예제는 MongoDB 에 데이터 쓰기 가이드 를 참조하세요.

API 문서

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

돌아가기

문서 삽입

다음

문서 교체