문서 삽입

MongoCollection 객체의 insertOne() 메서드를 사용하여 단일 문서를 컬렉션에 삽입할 수 있습니다. 문서를 삽입하려면 저장하려는 필드와 값이 포함된 Document 객체를 생성합니다. 아직 존재하지 않는 컬렉션에서 insertOne() 메서드를 호출하면 서버에서 자동으로 컬렉션을 생성합니다.

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

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

예시

다음 스니펫은 movies 컬렉션에 단일 문서를 삽입합니다.

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

참고

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

import com.mongodb.MongoException
import com.mongodb.kotlin.client.coroutine.MongoClient
import kotlinx.coroutines.runBlocking
import org.bson.codecs.pojo.annotations.BsonId
import org.bson.types.ObjectId
data class Movie(@BsonId val id: ObjectId, val title: String, val genres: List<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")
    try {
        val result = collection.insertOne(
            Movie(ObjectId(), "Ski Bloopers", listOf("Documentary", "Comedy"))
        )
        println("Success! Inserted document id: " + result.insertedId)
    } catch (e: MongoException) {
        System.err.println("Unable to insert due to an error: $e")
    }
    mongoClient.close()
}

Success! Inserted document id: BsonObjectId{value=...}

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

돌아가기

Insert

다수 삽입