Insira documentos

Visão geral

Neste guia, você pode aprender como usar o driver Kotlin Sync para adicionar documentos a uma coleção MongoDB realizando operações de inserção.

Uma operação de inserção insere um ou mais documentos em uma coleção MongoDB . Você pode executar uma operação de inserção utilizando os métodos insertOne() e insertMany() .

data class Restaurant(val name: String, val borough: String)

O campo _id

Em uma coleção MongoDB , cada documento deve conter um campo _id que tenha um valor único.

O MongoDB permite gerenciar este campo de duas maneiras:

• Você mesmo pode definir este campo para cada documento, garantindo que cada valor do campo _id seja único.

• Você pode permitir que o acionador gere automaticamente um valor de ObjectId único para cada documento _id. Se você não definir manualmente um valor _id para um documento, o driver preencherá o campo com uma ObjectId.

A menos que você possa garantir exclusividade, recomendamos deixar o driver gerar automaticamente os valores de _id .

Para saber mais sobre o campo _id, consulte o guia Índices únicos no manual do MongoDB Server .

Para saber mais sobre a estrutura e as regras de documentos, consulte o guia Documentos no manual do MongoDB Server .

Inserir um documento

Para adicionar um único documento a uma coleção MongoDB, chame o método insertOne() e passe o documento que você deseja adicionar.

O exemplo a seguir insere um documento na coleção restaurants :

val doc = Restaurant("Sea Shell Bar", "Queens")
val result = collection.insertOne(doc)

Insira vários documentos

Para adicionar vários documentos a uma coleção MongoDB , use o método insertMany() e passe uma lista de documentos que você deseja adicionar.

O exemplo a seguir insere uma lista de documentos na coleção restaurants :

val docs = listOf(
    Restaurant("Full Moon Grill", "Queens"),
    Restaurant("King's Cup", "Manhattan"),
)
val result = collection.insertMany(docs)

Modificar comportamento de inserção

O método insertOne() aceita opcionalmente um parâmetro InsertOneOptions que define opções para configurar a operação de inserção. Se você não especificar nenhuma opção, o driver executará a operação de inserção com as configurações padrão. Passe as opções como o último parâmetro para o método insertOne() .

A tabela a seguir descreve os métodos de configuração que você pode usar para configurar uma instância InsertOneOptions :

Você pode definir as configurações anteriores no método insertMany() configurando uma instância InsertManyOptions . Você também pode usar o método ordered() para especificar a ordem em que o driver insere documentos no MongoDB:

Passe as opções como o último parâmetro para o método insertMany() .

val opts = InsertManyOptions().bypassDocumentValidation(true)
val docs = listOf(
    Restaurant("Full Moon Grill", "Queens"),
    Restaurant("King's Cup", "Manhattan"),
)
val result = collection.insertMany(docs, opts)

Valor de retorno

O método insertOne() retorna uma instância InsertOneResult e o método insertMany() retorna uma instância InsertManyResult .

Você pode utilizar os seguintes métodos para recuperar informações de uma instância do InsertOneResult :

Você pode utilizar os seguintes métodos para recuperar informações de uma instância do InsertOneResult :

Informações adicionais

Para obter exemplos de código executáveis que demonstram como inserir documentos usando o driver Kotlin Sync, consulte Inserir documentos.