Insertar un documento

Puede insertar un solo documento en una colección utilizando la insertOne() método en un objeto MongoCollection. Para insertar un documento, construye un objeto Document que contenga los campos y valores que deseas almacenar. Si llamas al método insertOne() en una colección que aún no existe, el servidor la crea automáticamente para ti.

Tras una inserción exitosa, insertOne() devuelve una instancia de InsertOneResult. Puede recuperar información, como el campo _id del documento que insertó, llamando al método getInsertedId() en la instancia InsertOneResult.

Si tu operación de inserción falla, el driver genera una excepción. Para obtener más información sobre los tipos de excepciones generadas bajo condiciones específicas, consultar la documentación de la API para insertOne(), enlazada en la parte inferior de esta página.

Ejemplo

El siguiente snippet inserta un único documento en la colección movies.

Cuando ejecutes el ejemplo, deberías ver la salida con el ObjectId del documento insertado en el campo de valor:

Nota

Este ejemplo se conecta a una instancia de MongoDB utilizando un URI de conexión. Para obtener más información sobre cómo conectarse a tu instancia de MongoDB, consulta el guía de conexión.

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=...}

Para obtener información adicional sobre las clases y métodos mencionados en esta página, revisa la siguiente documentación API: