데이터베이스 및 컬렉션

개요

이 가이드에서는 MongoDB 코틀린(Kotlin) 드라이버로 MongoDB 데이터베이스 및 컬렉션을 사용하는 방법에 대해 설명합니다.

MongoDB는 데이터를 다음 수준의 계층 구조로 구성합니다.

1. 데이터베이스: 데이터베이스는 MongoDB 인스턴스에서 데이터 조직의 최상위 수준입니다.

2. collection: 데이터베이스는 문서 가 포함된 collection으로 구성됩니다.

3. 문서: 문서에는 문자열, 숫자, 날짜 등의 리터럴 데이터와 기타 내장된 문서가 포함됩니다. 문서 필드 유형 및 구조에 대한 자세한 내용은 문서에 대한 서버 설명서를 참조하세요.

MongoDB 코틀린( 코틀린 (Kotlin) ) 운전자 를 사용하면 코틀린( 코틀린 (Kotlin) ) 데이터 클래스를 사용하거나 문서 클래스를 사용하여 MongoDB 에서 데이터를 저장 하고 조회 합니다.

데이터 클래스 사용에 학습 보려면 데이터 클래스 데이터 형식 가이드 를 참조하세요. Document 클래스 사용에 학습 보려면 문서 데이터 형식에 대한 가이드 를 참조하세요.

데이터베이스에 액세스

getDatabase() MongoClient 사용 인스턴스 의 MongoDatabase 메서드를 사용하여 MongoDB 인스턴스 의 에 액세스 .

다음 예제에서는 testDatabase 데이터베이스에 액세스합니다.

val database = client.getDatabase("testDatabase")

컬렉션에 액세스

getCollection() 사용 인스턴스의 메서드를 사용하여 MongoDatabase MongoCollection 연결된 MongoDB 인스턴스의 데이터베이스에 있는 에 액세스합니다.

다음 예시에서는 유형의 문서가 포함된 에서 collection에 testCollection MongoDatabase ExampleDataClass액세스합니다.

data class ExampleDataClass(
    @BsonId val id: ObjectId = ObjectId(),
    val exampleProperty: String,
)

val collection = database.getCollection<ExampleDataClass>("testCollection")

data class Fruit(
    @BsonId val id: Int,
    val name: String,
    val qty: Int,
    val seasons: List<String>
)

val collection =
    database.getCollection<Fruit>("fruits")
// Define a data class for returned documents
data class NewFruit(
    @BsonId val id: Int,
    val name: String,
    val quantity: Int,
    val seasons: List<String>
)
val filter = Filters.eq(Fruit::name.name, "strawberry")
val update = Updates.combine(
    Updates.rename(Fruit::qty.name, "quantity"),
    Updates.push(Fruit::seasons.name, "fall"),
)
val options = FindOneAndUpdateOptions()
    .returnDocument(ReturnDocument.AFTER)
// Specify the class for returned documents as the type parameter in withDocumentClass()
val result = collection
    .withDocumentClass<NewFruit>()
    .findOneAndUpdate(filter, update, options)
println(result)

NewFruit(id=1, name=strawberry, quantity=205, seasons=[summer, fall])

컬렉션 생성

createCollection() 인스턴스 의 메서드를 사용하여 MongoDatabase 연결된 MongoDB 인스턴스 의 데이터베이스 에 컬렉션 을 생성합니다.

다음 예에서는 exampleCollection 이라는 collection을 만듭니다.

database.createCollection("exampleCollection")

CreateCollectionOptions 를 사용하여 최대 크기 및 문서 유효성 검사 규칙과 같은 컬렉션 옵션을 지정할 수 있습니다. 클래스. createCollection() 메서드는 CreateCollectionOptions 의 인스턴스를 두 번째 매개 변수로 허용합니다(선택 사항).

val collOptions: ValidationOptions = ValidationOptions().validator(
    Filters.or(
        Filters.exists("title"),
        Filters.exists("name")
    )
)
database.createCollection(
    "movies",
    CreateCollectionOptions().validationOptions(collOptions)
)

컬렉션 목록 가져오기

MongoDatabase.listCollectionNames() 메서드 를 사용하여 데이터베이스의 컬렉션 목록을 메서드:

val collectionList = database.listCollectionNames().toList()
println(collectionList)

[movies, exampleCollection]

제거 collection

MongoCollection.drop() 메서드 를 사용하여 데이터베이스 에서 컬렉션 을 제거 할 수 있습니다. 메서드:

val collection =
    database.getCollection<ExampleDataClass>("movies")
collection.drop()

읽기 설정, 읽기 고려, 쓰기 고려 지정하기

읽기 설정, 읽기 고려, 쓰기 고려는 드라이버가 읽기 작업을 라우팅하고 MongoDB 복제본 세트에 연결될 때 읽기 및 쓰기 작업에 대한 승인을 기다리는 방법을 제어합니다. 읽기 설정 및 읽기 고려는 모든 읽기 작업에 적용되고 쓰기 고려는 모든 쓰기 작업에 적용됩니다.

MongoDatabase 인스턴스는 인스턴스를 생성할 때 사용한 MongoClient의 쓰기 고려, 읽기 고려, 쓰기 설정을 상속합니다. MongoCollection 인스턴스는 인스턴스를 생성할 때 사용한 MongoDatabase의 쓰기 고려, 읽기 고려, 쓰기 설정을 상속합니다. 하지만 다음 메서드를 사용하여 읽기 설정, 읽기 고려 또는 쓰기 고려가 일반적으로 상속되는 설정과 다른 MongoDatabase 또는 MongoCollection 인스턴스를 가져올 수 있습니다.

• MongoDatabase.withReadConcern()

• MongoDatabase.withReadPreference()

• MongoDatabase.withWriteConcern()

• MongoCollection.withReadConcern()

• MongoCollection.withReadPreference()

• MongoCollection.withWriteConcern()

이러한 주제에 대한 자세한 내용은 서버 매뉴얼의 다음 페이지를 참조하세요.

• 읽기 설정

• readConcern

• 쓰기 고려