Bancos de dados e coleções

Visão geral

Este guia mostra como usar reconhecimento de data center e collection do MongoDB com o driver Kotlin do MongoDB.

O MongoDB organiza os dados em uma hierarquia dos seguintes níveis:

1. Bancos de dados: bancos de dados são o nível mais alto de organização de dados em uma instância do MongoDB.

2. collection: O reconhecimento de data center são organizados em collection que contêm documento.

3. Documentos: os documentos contêm dados literais, como strings, números e datas, bem como outros documentos incorporados. Para obter mais informações sobre os tipos de campo de documento e estrutura, consulte a documentação do servidor sobre documentos.

Com o driver MongoDB Kotlin , você pode modelar dados usando classes de dados Kotlin ou usando a classe Documento para armazenar e recuperar dados do MongoDB.

Para saber mais sobre o uso de classes de dados, consulte o guia sobre o Formato de dados da classe de dados. Para saber mais sobre como usar a classe Document , consulte o guia sobre o Formato de dados do documento.

Acessar um banco de dados

Use o getDatabase() de uma MongoClient instância para acessar um MongoDatabase em uma instância do MongoDB .

O exemplo a seguir acessa um banco de dados denominado testDatabase :

val database = client.getDatabase("testDatabase")

Acessar uma coleção

Use o método getCollection() de uma MongoDatabase instância para acessar um MongoCollection em um banco de dados de sua instância MongoDB conectada.

O exemplo a seguir acessa uma collection chamada testCollection de um MongoDatabase que contém documento do tipo 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])

Criar uma coleção

Use o método createCollection() de uma MongoDatabase instância do para criar uma coleção em um banco de dados de dados de sua instância MongoDB conectada.

O exemplo a seguir cria uma collection chamada exampleCollection:

database.createCollection("exampleCollection")

Você pode especificar opções de coleta, como tamanho máximo e regras de validação de documento, usando as opções CreateCollectionOptions aula. O método createCollection() aceita uma instância de CreateCollectionOptions como um segundo parâmetro opcional.

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

Obter uma lista de coleções

Você pode executar uma consulta de uma lista de coleções em um banco de dados utilizando MongoDatabase.listCollectionNames() :

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

[movies, exampleCollection]

Solte uma coleção

Você pode remover uma coleção do banco de dados usando o método MongoCollection.drop() :

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

Especifique o read preference, read concern e write concern

As preferências de leitura, as write concerns e as read concerns controlam como o driver direciona as operações de leitura e espera a confirmação das operações de leitura e gravação quando conectado a um conjunto de réplicas do MongoDB. As preferências de leitura e as preocupações de leitura se aplicam a todas as operações de leitura; as write concerns se aplicam a todas as operações de gravação.

MongoDatabase instâncias herdam suas configurações de write concern, read concern e write preference do MongoClient usado para criá-las. instâncias MongoCollection herdam suas configurações de write concern, read concern e write preference do MongoDatabase usado para criá-las. No entanto, você pode usar os seguintes métodos para obter uma instância de um MongoDatabase ou MongoCollection com uma read preference, read concern ou write preference que difere da configuração que elas normalmente herdariam:

• MongoDatabase.withReadConcern()

• MongoDatabase.withReadPreference()

• MongoDatabase.withWriteConcern()

• MongoCollection.withReadConcern()

• MongoCollection.withReadPreference()

• MongoCollection.withWriteConcern()

Para obter mais informações sobre esses tópicos, consulte as seguintes páginas no manual do servidor:

• readPreference

• Preocupação de leitura

• Escreva preocupação