여러 문서를 삽입합니다.

MongoCollection 객체에서 insertMany() 메서드를 호출하여 한 번의 작업으로 collection에 여러 문서를 삽입할 수 있습니다. 삽입하려면 Document 객체를 List 에 추가하고 해당 List 를 insertMany() 에 인수로 전달합니다. 아직 존재하지 않는 collection에서 insertMany() 메서드를 호출하면 서버에서 collection을 생성합니다.

삽입에 성공하면 insertMany() 은 InsertManyResult 인스턴스를 반환합니다. InsertManyResult 인스턴스에서 getInsertedIds() 메서드를 호출하여 삽입한 문서의 _id 필드와 같은 정보를 검색할 수 있습니다.

삽입 작업이 실패하면 드라이버에서 예외가 발생합니다. 특정 조건에서 발생하는 예외 유형에 대한 자세한 내용은 이 페이지 하단에 링크된 insertMany() 에 대한 API 문서를 참조하세요.

예시

다음 스니펫은 movies collection에 여러 문서를 삽입합니다.

예제를 실행하면 각 값 필드에 삽입된 문서의 ObjectId 값이 포함된 출력이 표시됩니다.

참고

이 예시 에서는 연결 URI를 사용하여 MongoDB 인스턴스 에 연결합니다. MongoDB 인스턴스 에 연결하는 방법에 학습 보려면 연결 가이드 를 참조하세요.

import com.mongodb.MongoException
import com.mongodb.kotlin.client.coroutine.MongoClient
import kotlinx.coroutines.runBlocking
data class Movie(val title: String)
fun main() = runBlocking {
    // Replace the uri string with your MongoDB deployment's connection string
    val uri = "<connection string uri>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Movie>("movies")
    val movieList = listOf(
        Movie("Short Circuit 3"),
        Movie("The Lego Frozen Movie")
    )
    try {
        val result = collection.insertMany(movieList)
        println("Success! Inserted document ids: " + result.insertedIds)
    } catch (e: MongoException) {
        System.err.println("Unable to insert due to an error: $e")
    }
    mongoClient.close()
}

Success! Inserted document ids: {0=BsonObjectId{value=...}, 1=BsonObjectId{value=...}}

이 페이지에 언급된 클래스 및 메서드에 대한 추가 정보는 다음 API 설명서를 참조하세요.

돌아가기

insertOne

업데이트 & 바꾸기