Insertar

Inserta uno o varios documentos en una colección.

Inserta documentos con insertOne o insertMany. Cualquier nodo recibe la petición y la lleva al rango que guarda cada documento.

Requisitos

Una conexión con un usuario que tenga readWrite sobre la base.

Insertar un documento

JavaScript

db.pedidos.insertOne({ cliente: "Ana Ruiz", total: 149.5, estado: "pagado" });

Si el documento no lleva _id, el driver le pone un ObjectId antes de mandarlo. La respuesta de insertOne te devuelve ese valor en insertedId.

Insertar varios

JavaScript

db.pedidos.insertMany(
  [
    { cliente: "Luis Gil", total: 32, estado: "pendiente" },
    { cliente: "Marta Sanz", total: 75, estado: "pagado" },
  ],
  { ordered: false },
);

Con ordered: false, un documento que falla no detiene a los demás. La respuesta lista todos los errores.

Comprobar

Después de insertar, db.pedidos.countDocuments() devuelve el número de documentos de la colección, que ha crecido en los que insertaste.

Problemas frecuentes

La inserción falla con DuplicateKey (11000) porque ya hay un documento con ese _id o con ese valor en un índice único.
La inserción falla con DocumentValidationFailure (121) porque el documento no cumple el validador de la colección.

Ver también

AnteriorAntipatrones SiguienteActualizar