데이터베이스 및 컬렉션

개요

이 가이드에서는 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

• 쓰기 고려