대량 쓰기 작업

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트의 및 컬렉션을 사용합니다.sample_restaurants.restaurants sample_mflix.movies 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 Atlas 시작하기 가이드 참조하세요.

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

data class Restaurant(
    val name: String,
    val borough: String,
    val cuisine: String,
    val stars: Int? = null,
)
data class Movie(
    val title: String,
    val year: Int,
    val seen: Boolean? = null,
)

삽입 작업

삽입 작업을 수행하려면 InsertOneModel 인스턴스 를 만들고 삽입하려는 문서 를 지정합니다.

다음 예에서는 InsertOneModel 인스턴스를 만듭니다.

val blueMoon = InsertOneModel(Restaurant("Blue Moon Grill", "Brooklyn", "American"))

여러 문서를 삽입하려면 각 문서 에 대해 InsertOneModel 인스턴스 를 만듭니다.

업데이트 작업

문서 를 업데이트 하려면 UpdateOneModel 인스턴스 를 만들고 다음 인수를 전달합니다.

• 컬렉션의 문서를 일치시키는 데 사용되는 기준을 지정하는 쿼리 필터

• 수행하려는 업데이트 작업입니다. 업데이트 연산자에 대한 자세한 내용은 MongoDB Server 매뉴얼의 필드 업데이트 연산자 가이드 참조하세요.

UpdateOneModel 인스턴스 는 쿼리 필터하다 와 일치 하는 첫 번째 문서 에 대한 업데이트 를 지정합니다.

다음 예에서는 UpdateOneModel 인스턴스를 만듭니다.

val updateOneFilter = Filters.eq(Restaurant::name.name, "White Horse Tavern")
val updateOneDoc = Updates.set(Restaurant::borough.name, "Queens")
val tavernUpdate = UpdateOneModel<Restaurant>(updateOneFilter, updateOneDoc)

여러 문서가 UpdateOneModel 인스턴스 에 지정된 쿼리 필터하다 와 일치하는 경우 작업은 첫 번째 결과를 업데이트합니다. 다음 코드와 같이 UpdateOptions 인스턴스 에서 정렬을 지정하여 서버 업데이트 작업을 수행하기 전에 일치하는 문서에 순서를 적용 할 수 있습니다.

val opts = UpdateOptions().sort(Sorts.ascending(Restaurant::name.name))

여러 문서를 업데이트 하려면 UpdateManyModel UpdateOneModel인스턴스 를 만들고 와 동일한 인수를 전달합니다. UpdateManyModel 클래스는 쿼리 필터하다 와 일치하는 모든 문서에 대한 업데이트를 지정합니다.

다음 예시 UpdateManyModel 의 인스턴스 만들어 운전자 일치하는 모든 문서를 업데이트 하도록 지시합니다.

val updateManyFilter = Filters.eq(Restaurant::name.name, "Wendy's")
val updateManyDoc = Updates.set(Restaurant::cuisine.name, "Fast food")
val wendysUpdate = UpdateManyModel<Restaurant>(updateManyFilter, updateManyDoc)

대체 작업

바꾸기 작업은 지정된 문서 의 모든 필드와 값을 제거하고 사용자가 지정한 새 필드와 값으로 바꿉니다. 대체 작업을 수행하려면 ReplaceOneModel 인스턴스 를 만들고 쿼리 필터하다 와 일치하는 문서 를 대체할 필드 및 값을 전달합니다.

다음 예에서는 ReplaceOneModel 인스턴스를 만듭니다.

val replaceFilter = Filters.eq(Restaurant::name.name, "Cooper Town Diner")
val replaceDoc = Restaurant("Smith Town Diner", "Brooklyn", "American")
val replacement = ReplaceOneModel(replaceFilter, replaceDoc)

여러 문서가 ReplaceOneModel 인스턴스 에 지정된 쿼리 필터하다 와 일치하는 경우 작업은 첫 번째 결과를 대체합니다. 다음 코드와 같이 ReplaceOptions 인스턴스 에서 정렬을 지정하여 서버 바꾸기 작업을 수행하기 전에 일치하는 문서에 순서를 적용 할 수 있습니다.

val opts = ReplaceOptions().sort(Sorts.ascending(Restaurant::name.name))

삭제 작업

문서 를 삭제 하려면 DeleteOneModel 인스턴스 를 만들고 삭제 하려는 문서 를 지정하는 쿼리 필터하다 를 전달합니다. DeleteOneModel 인스턴스 는 쿼리 필터하다 와 일치 하는 첫 번째 문서 만 삭제 하는 지침을 제공합니다.

다음 예에서는 DeleteOneModel 인스턴스를 만듭니다.

val deleteOne = DeleteOneModel<Restaurant>(Filters.eq(
    Restaurant::name.name,
    "Morris Park Bake Shop"
))

여러 문서를 삭제 하려면 DeleteManyModel 인스턴스 를 만들고 삭제 하려는 문서 를 지정하는 쿼리 필터하다 를 전달합니다. DeleteManyModel 인스턴스 는 쿼리 필터하다 와 일치하는 모든 문서를 제거 하는 지침을 제공합니다.

다음 예에서는 DeleteManyModel 인스턴스를 만듭니다.

val deleteMany = DeleteManyModel<Restaurant>(Filters.eq(
    Restaurant::cuisine.name,
    "Experimental"
))

대량 작업 수행

수행하려는 각 작업에 대한 모델 인스턴스 를 정의한 후 이러한 인스턴스 목록을 bulkWrite() 메서드에 전달합니다. 기본값 으로 이 메서드는 모델 목록에 지정된 순서대로 작업을 실행합니다.

다음 예시 에서는 bulkWrite() 메서드를 사용하여 여러 쓰기 (write) 작업을 수행합니다.

val insertOneMdl = InsertOneModel(Restaurant("Red's Pizza", "Brooklyn", "Pizzeria"))
val updateOneMdl = UpdateOneModel<Restaurant>(
    Filters.eq(Restaurant::name.name, "Moonlit Tavern"),
    Updates.set(Restaurant::borough.name, "Queens")
)
val deleteManyMdl = DeleteManyModel<Restaurant>(
    Filters.eq(Restaurant::name.name, "Crepe")
)
val bulkResult = collection.bulkWrite(
    listOf(insertOneMdl, updateOneMdl, deleteManyMdl)
)
println(bulkResult)

AcknowledgedBulkWriteResult{insertedCount=1, matchedCount=5, removedCount=3,
modifiedCount=2, upserts=[], inserts=[BulkWriteInsert{index=0,
id=BsonObjectId{value=...}}]}

쓰기 (write) 작업 중 하나라도 실패하면 코틀린 동기 (Kotlin Sync) 운전자 BulkWriteError 를 발생시키고 추가 작업을 수행하지 않습니다. BulkWriteError 은(는) 실패한 작업과 예외에 대한 세부 정보가 포함된 details 필드 제공합니다.

대량 쓰기 작업 사용자 지정

bulkWrite() 메서드는 대량 쓰기 (write) 작업을 구성하는 데 사용할 수 있는 옵션을 지정하는 매개 변수를 선택적으로 허용합니다. 옵션을 지정하지 않으면 운전자 는 기본값 설정으로 대량 작업을 수행합니다.

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

다음 코드는 옵션을 생성하고 ordered(false) 옵션을 사용하여 순서가 지정되지 않은 대량 쓰기 (write) 를 지정합니다. 그런 다음 이 예시 에서는 bulkWrite() 메서드를 사용하여 대량 작업을 수행합니다.

val opts = BulkWriteOptions().ordered(false)
collection.bulkWrite(bulkOperations, opts)

순서가 지정되지 않은 대량 쓰기 (write) 의 쓰기 (write) 작업 중 하나라도 실패하면 코틀린 동기 (Kotlin Sync) 운전자 는 모든 작업을 시도한 후에만 오류를 보고합니다.

반환 값

bulkWrite() 메서드는 BulkWriteResult 객체 를 반환합니다. BulkWriteResult 인스턴스 에서 다음 정보에 액세스 할 수 있습니다.

삽입 작업

이 예시 두 개의 문서를 삽입하기 위한 지침이 포함된 모델을 만드는 방법을 보여 줍니다. 한 문서 sample_restaurants.restaurants 컬렉션 에 삽입되고 다른 문서 sample_mflix.movies 컬렉션 에 삽입됩니다. MongoNamespace 인스턴스 각 쓰기 (write) 작업이 적용되는 대상 데이터베이스 및 컬렉션 정의합니다.

val restaurantToInsert = ClientNamespacedWriteModel
    .insertOne(
        MongoNamespace("sample_restaurants", "restaurants"),
        Restaurant("Blue Moon Grill", "Brooklyn", "American")
    )
val movieToInsert = ClientNamespacedWriteModel
    .insertOne(
        MongoNamespace("sample_mflix", "movies"),
        Movie("Silly Days", 2022)
    )

업데이트 작업

다음 예시 bulkWrite() 메서드를 사용하여 sample_restaurants.restaurants 및 sample_mflix.movies 컬렉션의 기존 문서를 업데이트 방법을 보여 줍니다.

val restaurantUpdate = ClientNamespacedWriteModel
    .updateOne(
        MongoNamespace("sample_restaurants", "restaurants"),
        Filters.eq(Restaurant::name.name, "Villa Berulia"),
        Updates.inc(Restaurant::stars.name, 1)
    )
val movieUpdate = ClientNamespacedWriteModel
    .updateMany(
        MongoNamespace("sample_mflix", "movies"),
        Filters.eq(Movie::title.name, "Carrie"),
        Updates.set(Movie::seen.name, true)
    )

이 예시 restaurants 컬렉션 에서 name 값이 "Villa Berulia" 인 문서 에서 stars 필드 의 값을 1 만큼 증가시킵니다. 또한 movies 컬렉션 에서 title 값이 "Carrie" 인 모든 문서에서 seen 필드 값을 true 로 설정합니다.

여러 문서가 ClientNamespacedUpdateOneModel 인스턴스 에 지정된 쿼리 필터하다 와 일치하는 경우 작업은 첫 번째 결과를 업데이트합니다. 다음 코드와 같이 서버 업데이트 작업을 수행하기 전에 ClientUpdateOneOptions 인스턴스에서 정렬 순서를 지정하여 일치하는 문서에 순서를 적용할 수 있습니다.

val options =  ClientUpdateOneOptions
    .clientUpdateOneOptions()
    .sort(Sorts.ascending("_id"))

대체 작업

다음 예시 sample_restaurants.restaurants 및 sample_mflix.movies 컬렉션의 기존 문서를 대체하는 모델을 만드는 방법을 보여 줍니다.

val restaurantReplacement = ClientNamespacedWriteModel
    .replaceOne(
        MongoNamespace("sample_restaurants", "restaurants"),
        Filters.eq("_id", 1),
        Restaurant("Smith Town Diner", "Brooklyn", "American")
    )
val movieReplacement = ClientNamespacedWriteModel
    .replaceOne(
        MongoNamespace("sample_mflix", "movies"),
        Filters.eq("_id", 1),
        Movie("Loving Sylvie", 1999)
    )

이 예시 성공적으로 실행되면 restaurants 컬렉션 에서 _id 값이 1 인 문서 새 문서 로 대체됩니다. movies 컬렉션 의 _id 값이 1 인 문서 도 새 문서 로 대체됩니다.

여러 문서가 ClientNamespacedReplaceOneModel 인스턴스 에 지정된 쿼리 필터하다 와 일치하는 경우 작업은 첫 번째 결과를 대체합니다. 다음 코드에 표시된 것처럼 운전자 바꾸기 작업을 수행하기 전에 ClientReplaceOneOptions 인스턴스 에서 정렬 순서를 지정하여 일치하는 문서에 순서를 적용 할 수 있습니다.

val options =  ClientReplaceOneOptions
    .clientReplaceOneOptions()
    .sort(Sorts.ascending("_id"))

대량 작업 수행

수행하려는 각 작업에 대해 ClientNamespacedWriteModel 인스턴스 정의한 후 이러한 인스턴스 목록을 클라이언트 bulkWrite() 메서드에 전달합니다. 기본값 으로 이 메서드는 지정된 순서대로 작업을 실행합니다.

다음 예시 에서는 bulkWrite() 메서드를 사용하여 여러 쓰기 (write) 작업을 수행합니다.

val restaurantNamespace = MongoNamespace("sample_restaurants", "restaurants")
val movieNamespace = MongoNamespace("sample_mflix", "movies")
val bulkOperations = listOf(
    ClientNamespacedWriteModel
        .insertOne(
            restaurantNamespace,
            Restaurant("Drea's", "Brooklyn", "Mexican")
        ),
    ClientNamespacedWriteModel
        .replaceOne(
            movieNamespace,
            Filters.eq("_id", 1),
            Movie("Underneath It All", 2002)
        )
)
val clientBulkResult = mongoClient
    .bulkWrite(bulkOperations)
println(clientBulkResult.toString())

AcknowledgedSummaryClientBulkWriteResult{insertedCount=1, matchedCount=1, ...}

쓰기 (write) 작업 중 하나라도 실패하면 운전자 ClientBulkWriteException 를 발생시키고 더 이상 개별 작업을 수행하지 않습니다. ClientBulkWriteException 에는 개별 장애에 대한 세부 정보를 제공하는 ClientBulkWriteException.getWriteErrors() 메서드를 사용하여 액세스할 수 있는 BulkWriteError 가 포함되어 있습니다.

대량 쓰기 사용자 지정

ClientBulkWriteOptions 인스턴스 bulkWrite() 메서드에 전달하여 운전자 대량 쓰기 (write) 작업을 수행하는 방식을 사용자 지정할 수 있습니다.

val namespace = MongoNamespace("sample_restaurants", "restaurants")
val options = ClientBulkWriteOptions
    .clientBulkWriteOptions()
    .ordered(false)
val bulkOps = listOf(
    ClientNamespacedWriteModel.insertOne(
        namespace,
        Document("_id", 1).append("name", "Freezyland")
    ),
    // Causes a duplicate key error
    ClientNamespacedWriteModel.insertOne(
        namespace,
        Document("_id", 1).append("name", "Coffee Stand No. 1")
    ),
    ClientNamespacedWriteModel.insertOne<Any>(
        namespace,
        Document("name", "Kelly's Krepes")
    )
)
val result = mongoClient
    .bulkWrite(bulkOps, options)

API 문서

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

• 컬렉션 대량 쓰기

  • bulkWrite()를 호출합니다.

  • InsertOneModel

  • UpdateOneModel

  • UpdateManyModel

  • ReplaceOneModel

  • DeleteOneModel

  • DeleteManyModel

  • BulkWriteResult

  • BulkWriteError

  • MongoBulkWriteException

• 클라이언트 대량 쓰기

  • bulkWrite()를 호출합니다.

  • ClientNamespacedWriteModel

  • MongoNamespace

  • ClientBulkWriteOptions

  • ClientBulkWriteResult