/ /

문서 업데이트

개요

이 가이드 에서는 코틀린 동기 (Kotlin Sync) 운전자 를 사용하여 updateOne() 및 updateMany() 메서드를 통해 MongoDB 컬렉션 의 문서를 업데이트 하는 방법을 학습 수 있습니다.

샘플 데이터

이 sample_restaurants.restaurants 가이드의 예시에서는 Atlas 샘플 데이터 세트 컬렉션을 사용합니다. 무료 MongoDB 배포서버를 생성하고 샘플 데이터 세트를 로드하는 방법을 알아보려면 MongoDB 시작하기 가이드를 참조하세요.

이 컬렉션 의 문서는 다음 코틀린 (Kotlin) 데이터 클래스에 따라 모델링됩니다.

data class Restaurant(
    val name: String,
    val borough: String,
    val cuisine: String,
    val address: Document
)

업데이트 작업

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

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

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

업데이트 할 문서를 일치시키는 쿼리 필터하다 입니다. 쿼리 필터에 학습 보려면 쿼리 지정 가이드 를 참조하세요.
업데이트 연산자 또는 수행할 업데이트의 종류, 업데이트 할 필드와 값을 지정하는 업데이트 문서 입니다. 업데이트 연산자 목록과 그 사용법은 MongoDB Server 매뉴얼의 필드 업데이트 연산자 가이드 페이지 를 참조하세요.

하나의 문서 업데이트

다음 예시 에서는 updateOne() 메서드를 사용하여 문서 의 name 값을 "Happy Garden" 에서 "Mountain House" 로 업데이트 합니다.

val filter = eq(Restaurant::name.name, "Happy Garden")
val update = set(Restaurant::name.name, "Mountain House")
val result = collection.updateOne(filter, update)

다수 문서 업데이트

다음 예시 에서는 updateMany() 메서드를 사용하여 name 값이 "Starbucks" 인 모든 문서를 업데이트 합니다. 이 업데이트 는 address 필드 의 이름을 location 로 바꿉니다.

val filter = eq(Restaurant::name.name, "Starbucks")
val update = rename(Restaurant::address.name, "location")
val result = collection.updateMany(filter, update)

업데이트 작업 사용자 지정

updateOne() 및 updateMany() 메서드는 업데이트 작업을 구성하는 옵션을 설정하는 매개변수를 선택적으로 허용합니다. 옵션을 지정하지 않으면 운전자 는 기본값 설정으로 업데이트 작업을 수행합니다.

다음 표에서는 UpdateOptions 인스턴스 를 구성하는 데 사용할 수 있는 setter 메서드에 대해 설명합니다.

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

문서 업서트 예시

다음 코드는 updateOne() 메서드를 사용하여 name 필드 값이 "Sunrise Pizzeria" 인 문서를 일치시킵니다. 그런 다음 첫 번째 일치하는 문서 의 borough 값을 "Queens" 로 설정하고 cuisine 값을 "Italian" 로 설정합니다.

upsert 옵션이 true 로 설정하다 되어 있으므로 쿼리 필터하다 가 기존 문서와 일치하지 않는 경우 운전자 는 업데이트 문서 에 지정된 필드 및 값이 있는 새 문서 를 삽입합니다.

val opts = UpdateOptions().upsert(true)
val filter = eq(Restaurant::name.name, "Sunrise Pizzeria")
val update = combine(
    set(Restaurant::borough.name, "Queens"),
    set(Restaurant::cuisine.name, "Italian")
)
collection.updateOne(filter, update, opts)

반환 값

updateOne() 및 updateMany() 메서드는 각각 UpdateResult 객체 를 반환합니다. 다음 메서드를 사용하여 UpdateResult 인스턴스 의 정보에 액세스 할 수 있습니다.

속성	설명
`getMatchedCount()`	수행된 업데이트 수에 관계없이 쿼리 필터하다 와 일치하는 문서 수를 반환합니다.
`getModifiedCount()`	업데이트 작업으로 수정된 문서 수를 반환합니다. 업데이트된 문서 원본과 동일한 경우 이 계산에 포함되지 않습니다.
`wasAcknowledged()`	서버 결과를 승인한 경우 `true` 를 반환합니다.
`getUpsertedId()`	운전자 업서트 수행한 경우 데이터베이스 에 업서트된 문서 의 `_id` 값을 반환합니다.

참고

wasAcknowledged() 메서드가 false 을 반환하는 경우 UpdateResult 인스턴스 에서 다른 정보에 액세스 하려고 하면 InvalidOperation 예외가 발생합니다. 서버 가 쓰기 (write) 작업을 승인하지 않으면 운전자 는 이러한 값을 결정할 수 없습니다.

추가 정보

코틀린 동기 (Kotlin Sync) 운전자 사용하여 문서를 업데이트 방법을 보여주는 실행 가능한 코드 예제를 보려면 문서 삽입을 참조하세요.

API 문서

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

돌아가기

커서에서 데이터 액세스

문서 교체