Insertar un documento

Overview

En esta guía, puedes aprender cómo insertar documentos en una colección de MongoDB.

Antes de que puedas encontrar, actualizar y borrar documentos en MongoDB, debes insertar esos documentos. Puedes insertar un documento utilizando el InsertOne() método, o inserte varios documentos utilizando el método InsertMany() o BulkWrite().

Las siguientes secciones se centran en InsertOne() y InsertMany(). Para aprender a usar el método BulkWrite(), consulte el Guía sobre operaciones en bloque.

El campo _id

En MongoDB, cada documento debe contener un campo _id único.

Las dos opciones para gestionar este campo son:

• Gestionar este campo por tu cuenta, asegurándote de que cada valor que utilices sea único.

• Permitir que el controlador genere automáticamente valores únicos de ObjectId. El controlador genera valores únicos de ObjectId para documentos para los que no se especifica explícitamente un _id.

A menos que proporciones sólidas garantías de unicidad, MongoDB te recomienda dejar que el controlador genere automáticamente valores _id.

Para obtener más información sobre el campo _id, consulta la entrada manual del servidor en Unique Indexes.

Para aprender más sobre la estructura y las reglas de los documentos, consultar la entrada del Manual del Servidor sobre Documentos.

Insertar un documento

Utilice el método InsertOne() para insertar un solo documento en una colección.

Después de una inserción exitosa, el método devuelve una instancia InsertOneResult que contiene el _id del nuevo documento.

type Book struct {
	Title  string
	Author string
}

coll := client.Database("db").Collection("books")
doc := Book{Title: "Atonement", Author: "Ian McEwan"}
result, err := coll.InsertOne(context.TODO(), doc)
fmt.Printf("Inserted document with _id: %v\n", result.InsertedID)

Inserted document with _id: ObjectID("...")

opts := options.InsertOne().SetBypassDocumentValidation(true)

Inserta varios documentos

Utiliza el método InsertMany() para insertar varios documentos en una colección.

Después de una inserción exitosa, el método InsertMany() devuelve una instancia de InsertManyResult que contiene los campos _id de los documentos insertados.

coll := client.Database("myDB").Collection("favorite_books")
docs := []interface{}{
    Book{Title: "Cat's Cradle", Author: "Kurt Vonnegut Jr."},
    Book{Title: "In Memory of Memory", Author: "Maria Stepanova"},
    Book{Title: "Pride and Prejudice", Author: "Jane Austen"},
}
result, err := coll.InsertMany(context.TODO(), docs)
fmt.Printf("Documents inserted: %v\n", len(result.InsertedIDs))
for _, id := range result.InsertedIDs {
    fmt.Printf("Inserted document with _id: %v\n", id)
}

Documents inserted: 3
Inserted document with _id: ObjectID("...")
Inserted document with _id: ObjectID("...")
Inserted document with _id: ObjectID("...")

opts := options.InsertMany().SetBypassDocumentValidation(true).SetOrdered(false)

{ "_id": 1, "title": "Where the Wild Things Are" }
{ "_id": 2, "title": "The Very Hungry Caterpillar" }
{ "_id": 1, "title": "Blueberries for Sal" }
{ "_id": 3, "title": "Goodnight Moon" }

type Book struct {
    ID    int `bson:"_id"`
    Title string
}
...
docs := []interface{}{
    Book{ID: 1, Title: "Where the Wild Things Are"},
    Book{ID: 2, Title: "The Very Hungry Caterpillar"},
    Book{ID: 1, Title: "Blueberries for Sal"},
    Book{ID: 3, Title: "Goodnight Moon"},
}
result, err := coll.InsertMany(context.TODO(), docs)
if err != nil {
    fmt.Printf("A bulk write error occurred, but %v documents were still inserted.\n", len(result.InsertedIDs))
}
for _, id := range result.InsertedIDs {
    fmt.Printf("Inserted document with _id: %v\n", id)
}

A bulk write error occurred, but 2 documents were still inserted.
Inserted document with _id: 1
Inserted document with _id: 2

{ "_id": 1, "title": "Where the Wild Things Are" }
{ "_id": 2, "title": "The Very Hungry Caterpillar" }

Información Adicional

Para ejemplos ejecutables de las operaciones de inserción, consulte los siguientes ejemplos de uso:

• Ejemplo de inserción de un documento

• Inserta varios documentos

Para obtener más información sobre cómo realizar las operaciones mencionadas, consulte las siguientes guías:

• Especifica un query

• Operaciones masivas