Insertar un documento

Overview

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

Para poder buscar, actualizar y eliminar documentos en MongoDB, debe insertarlos. Puede insertar un documento usando 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 Guía deoperaciones masivas.

El _id campo

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

Las dos opciones para gestionar este campo son:

• Gestione usted mismo este campo, asegurándose de que cada valor que utilice sea único.

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

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

Para obtener más información sobre el campo _id, consulte la entrada del 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.

Tras 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

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

Tras una inserción exitosa, el método InsertMany() devuelve una instancia 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 insertar 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