문서 삽입

이 페이지의 내용

개요

샘플 데이터
0}_id 필드
문서 하나 삽입
여러 문서를 삽입합니다.
삽입 동작 수정
삽입 예제 수정
반환 값
추가 정보
API 문서

개요

이 가이드 에서는 코틀린 동기 (Kotlin Sync) 운전자 를 사용하여 삽입 작업 을 수행하여 MongoDB 컬렉션 에 문서를 추가하는 방법을 학습 수 있습니다.

삽입 작업은 하나 이상의 문서를 MongoDB 컬렉션 에 삽입합니다. insertOne() 및 insertMany() 메서드를 사용하여 삽입 작업을 수행할 수 있습니다.

샘플 데이터

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

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

data class Restaurant(val name: String, val borough: String)

`_id` 필드

MongoDB 컬렉션 에서 각 문서 에는 고유한 값을 가진 _id 필드 가 포함 되어야 합니다.

MongoDB를 사용하면 이 필드를 두 가지 방법으로 관리할 수 있습니다.

각 _id 필드 값이 고유하도록 각 문서에 대해 이 필드를 직접 설정할 수 있습니다.
운전자 가 각 문서 _id 에 대해 고유한 ObjectId 값을 자동으로 생성하도록 할 수 있습니다. 문서 에 대해 _id 값을 수동으로 설정하다 하지 않으면 운전자 는 필드 를 ObjectId 으로 채웁니다.

고유성을 보장할 수 없는 경우 드라이버가 _id 값을 자동으로 생성하도록 하는 것이 좋습니다.

참고

중복 _id 오류

컬렉션 에서 중복된 _id 값을 설정하면 고유 인덱스 제약 조건을 위반하여 운전자 가 insertOne() 메서드에서 WriteError 를 반환하거나 insertMany() 메서드에서 BulkWriteError 를 반환합니다.

_id 필드에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 고유 인덱스 가이드를 참조하세요.

문서 구조 및 규칙에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 문서 가이드를 참조하세요.

문서 하나 삽입

MongoDB 컬렉션에 단일 문서를 추가하려면 insertOne() 메서드를 호출하고 추가하려는 문서를 전달합니다.

다음 예시에서는 restaurants 컬렉션에 문서를 삽입합니다.

val doc = Restaurant("Sea Shell Bar", "Queens")
val result = collection.insertOne(doc)

여러 문서를 삽입합니다.

MongoDB 컬렉션 에 여러 문서를 추가하려면 insertMany() 메서드를 사용하여 추가하려는 문서 목록을 전달합니다.

다음 예에서는 restaurants 컬렉션에 문서 목록을 삽입합니다.

val docs = listOf(
    Restaurant("Full Moon Grill", "Queens"),
    Restaurant("King's Cup", "Manhattan"),
)
val result = collection.insertMany(docs)

삽입 동작 수정

insertOne() 메서드는 삽입 작업을 구성하는 옵션을 설정하는 InsertOneOptions 매개 변수를 선택적으로 허용합니다. 옵션을 지정하지 않으면 운전자 는 기본값 설정으로 삽입 작업을 수행합니다. insertOne() 메서드에 마지막 매개변수로 옵션을 전달합니다.

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

메서드	설명
`bypassDocumentValidation()`	If set to `true`, allows the driver to ignore document-level validation. Defaults to `false`.
`comment()`	Sets a comment to attach to the operation. For more information, see the insert command fields guide in the MongoDB Server manual for more information.

InsertManyOptions 인스턴스 를 구성하여 insertMany() 메서드에 대한 앞의 설정하다 을 지정할 수 있습니다. ordered() 메서드 세터 메서드를 사용하여 운전자 가 MongoDB 에 문서를 삽입하는 순서를 지정할 수도 있습니다.

메서드	설명
`ordered()`	If set to `true`, the driver sends documents to the server in the order provided. If an error occurs, the driver cancels all remaining insert operations. Defaults to `true`.

insertMany() 메서드에 마지막 매개변수로 옵션을 전달합니다.

삽입 예제 수정

다음 코드에서는 bypassDocumentValidation() 메서드를 사용하여 문서 유효성 검사 규칙을 무시하는 옵션을 설정하다 합니다. 그런 다음 이 예시 에서는 insertMany() 메서드를 사용하여 restaurants 컬렉션 에 새 문서를 추가합니다.

val opts = InsertManyOptions().bypassDocumentValidation(true)
val docs = listOf(
    Restaurant("Full Moon Grill", "Queens"),
    Restaurant("King's Cup", "Manhattan"),
)
val result = collection.insertMany(docs, opts)

반환 값

insertOne() 메서드는 InsertOneResult 인스턴스 를 반환하고 insertMany() 메서드는 InsertManyResult 인스턴스 반환합니다.

다음 메서드를 사용하여 InsertOneResult 인스턴스 에서 정보를 조회 할 수 있습니다.

메서드	설명
`getInsertedId()`	삽입된 문서 의 `_id` 값을 나타냅니다.
`wasAcknowledged()`	서버 가 결과를 승인하면 `true` 를 반환합니다.

다음 메서드를 사용하여 InsertOneResult 인스턴스 에서 정보를 조회 할 수 있습니다.

메서드	설명
`getInsertedIds()`	삽입된 문서의 `_id` 값을 나타냅니다.
`wasAcknowledged()`	서버 가 결과를 승인하면 `true` 를 반환합니다.

참고

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

추가 정보

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

API 문서

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

돌아가기

데이터 쓰기

Update

개요