Overview
En esta guía, puedes aprender cómo insertar documentos en MongoDB.
Puedes usar MongoDB para recuperar, actualizar y borrar información que ya está almacenada en MongoDB. Para almacenar información, utiliza una operación de inserción.
Una operación de inserción introduce uno o más documentos en una colección de MongoDB. El controlador de Node.js proporciona los siguientes métodos para realizar operaciones de inserción:
insertOne()insertMany()bulkWrite()
Tip
Interactive Lab
Esta página incluye un breve laboratorio interactivo que demuestra cómo insertar datos utilizando el método insertOne(). Se puede completar este laboratorio directamente en la ventana del navegador sin instalar MongoDB ni un editor de código.
Para iniciar el laboratorio, haga clic en el botón Open Interactive Tutorial en la parte superior de la página. Para ampliar el laboratorio a un formato de pantalla completa, haga clic en el botón de pantalla completa (⛶) en la esquina superior derecha del panel del laboratorio.
Las siguientes secciones se centran en insertOne() y insertMany(). Para un ejemplo sobre cómo usar el método bulkWrite(), consulta la sección Ejemplo de bulkWrite(): archivo completo de la guía Operaciones en bloque.
Una nota acerca de _id
Al insertar un documento, MongoDB aplica una restricción en sus documentos por defecto. Cada documento debe contener un campo _id único.
Existen dos maneras de gestionar este campo:
El mismo usuario puede gestionar este campo y asegurarse de que cada valor que use sea único.
Puedes permitir que el controlador genere automáticamente valores únicos de
ObjectIdcon la fábrica de llave primaria.
A menos que hayas proporcionado garantías sólidas de singularidad, recomendamos que dejes que el controlador genere automáticamente valores de _id.
Nota
Los valores duplicados de _id infringen las restricciones de índice único, lo que resulta en un WriteError.
Para obtener más información sobre _id, consulte la entrada del manual del servidor sobre Índices Únicos.
Inserta un solo documento
Utilice el método insertOne() cuando desee insertar un solo documento.
Tras una inserción exitosa, el método devuelve una instancia de InsertOneResult que representa el _id del nuevo documento.
Ejemplo
El siguiente ejemplo utiliza el método insertOne() para insertar un nuevo documento en la colección myDB.pizzaMenu:
const myDB = client.db("myDB");const myColl = myDB.collection("pizzaMenu");
const doc = { name: "Neapolitan pizza", shape: "round" };const result = await myColl.insertOne(doc);console.log( `A document was inserted with the _id: ${result.insertedId}`,);El resultado se parece al siguiente texto:
A document was inserted with the _id: 60c79c0f4cc72b6bb31e3836Para obtener más información sobre las clases y métodos mencionados en esta sección, consulta los siguientes recursos:
Documentación de la API en insertOne()
Documentación de la API sobre InsertOneResult
Entrada manual del servidor en insertOne()
Ejemplo de insertOne(): Archivo completo
Nota
Configuración de ejemplo
Este ejemplo se conecta a una instancia de MongoDB utilizando un URI de conexión. Para aprender más sobre cómo realizar la conexión a la instancia de MongoDB, se debe consultar la guía Conexión a MongoDB. Este ejemplo también usa la colección movies en la base de datos sample_mflix incluida en los conjuntos de datos de muestra de Atlas. Se pueden cargar en la base de datos en un clúster gratuito en MongoDB Atlas siguiendo la guía de Introducción a MongoDB.
El siguiente código es un archivo completo y autónomo que realiza una operación de inserción única:
import { MongoClient } from "mongodb";
// Replace the uri string with your MongoDB deployment's connection string.const uri = "<connection string uri>";
// Create a new client and connect to MongoDBconst client = new MongoClient(uri);
async function run() { try { // Connect to the "sample_mflix" database and access its "movies" collection const database = client.db("sample_mflix"); const movies = database.collection("movies"); // Create a document to insert const doc = { title: "Charade", genres: ["Comedy", "Romance", "Thriller"], year: 1963, cast: ["Cary Grant", "Audrey Hepburn", "Walter Matthau"], } // Insert the defined document into the "movies" collection const result = await movies.insertOne(doc);
// Print the ID of the inserted document console.log(`A document was inserted with the _id: ${result.insertedId}`); } finally { // Close the MongoDB client connection await client.close(); }}// Run the function and handle any errorsrun().catch(console.dir);import { MongoClient } from "mongodb";
// Replace the uri string with your MongoDB deployment's connection string.const uri = "<connection string uri>";
const client = new MongoClient(uri);
interface Movie { title: string; content: string[]; year: number; cast: string[];}
async function run() { try { const database = client.db("sample_mflix"); // Specifying a Schema is optional, but it enables type hints on // finds and inserts const movies = database.collection<Movie>("movies"); const result = await movies.insertOne({ title: "Charade", genres: ["Comedy", "Romance", "Thriller"], year: 1963, cast: ["Cary Grant", "Audrey Hepburn", "Walter Matthau"], }); console.log(`A document was inserted with the _id: ${result.insertedId}`); } finally { await client.close(); }}run().catch(console.dir);Al ejecutar el ejemplo anterior, se produce el siguiente resultado:
A document was inserted with the _id: ...Inserta varios documentos
Utiliza el método insertMany() cuando desees insertar varios documentos. Este método inserta documentos en el orden especificado hasta que ocurra una excepción, si es que hay alguna.
Por ejemplo, suponga que desea insertar los siguientes documentos:
{ "_id": 1, "color": "red" }{ "_id": 2, "color": "purple" }{ "_id": 1, "color": "yellow" }{ "_id": 3, "color": "blue" }Cuando pasas los documentos anteriores al método insertMany(), el driver inserta los dos primeros documentos, pero lanza un WriteError para el tercer documento porque el ID 1 es un duplicado. El driver no inserta ningún documento después de este error.
Nota
Utilice un bloque try-catch para obtener una confirmación de los documentos procesados con éxito antes de que ocurra el error:
const myDB = client.db("myDB");const myColl = myDB.collection("colors");
try { const docs = [ { "_id": 1, "color": "red"}, { "_id": 2, "color": "purple"}, { "_id": 1, "color": "yellow"}, { "_id": 3, "color": "blue"} ];
const insertManyresult = await myColl.insertMany(docs); let ids = insertManyresult.insertedIds;
console.log(`${insertManyresult.insertedCount} documents were inserted.`); for (let id of Object.values(ids)) { console.log(`Inserted a document with id ${id}`); }} catch(e) { console.log(`A MongoBulkWriteException occurred, but there are successfully processed documents.`); let ids = e.result.result.insertedIds; for (let id of Object.values(ids)) { console.log(`Processed a document with id ${id._id}`); } console.log(`Number of documents inserted: ${e.result.result.nInserted}`);}El resultado consiste en documentos que MongoDB puede procesar y se asemeja a lo siguiente:
A MongoBulkWriteException occurred, but there are successfully processed documents.Processed a document with id 1Processed a document with id 2Processed a document with id 1Processed a document with id 3Number of documents inserted: 2Si se mira dentro de la colección, se verán los siguientes documentos:
{ "_id": 1, "color": "red" }{ "_id": 2, "color": "purple" }Tras una inserción exitosa, el método devuelve una instancia de InsertManyResult que representa el número de documentos insertados y el _id del nuevo documento.
Ejemplo
El siguiente ejemplo utiliza el método insertMany() para insertar tres nuevos documentos en la colección myDB.pizzaMenu:
const myDB = client.db("myDB");const myColl = myDB.collection("pizzaMenu");
const docs = [ { name: "Sicilian pizza", shape: "square" }, { name: "New York pizza", shape: "round" }, { name: "Grandma pizza", shape: "square" }];
const insertManyresult = await myColl.insertMany(docs);let ids = insertManyresult.insertedIds;
console.log(`${insertManyresult.insertedCount} documents were inserted.`);
for (let id of Object.values(ids)) { console.log(`Inserted a document with id ${id}`);}El resultado es similar a lo siguiente:
3 documents were inserted.Inserted a document with id 60ca09f4a40cf1d1afcd93a2Inserted a document with id 60ca09f4a40cf1d1afcd93a3Inserted a document with id 60ca09f4a40cf1d1afcd93a4Para obtener más información sobre las clases y métodos mencionados en esta sección, consulta los siguientes recursos:
Documentación de la API sobre insertMany()
Documentación de la API sobre InsertManyResult
Documentación de la API en PkFactory
Entrada manual del servidor en insertMany()
insertMany() Ejemplo: archivo completo
Nota
Configuración de ejemplo
Este ejemplo se conecta a una instancia de MongoDB utilizando un URI de conexión. Para aprender más sobre cómo realizar la conexión a la instancia de MongoDB, se debe consultar la guía Conexión a MongoDB. Este ejemplo también usa la colección movies en la base de datos sample_mflix incluida en los conjuntos de datos de muestra de Atlas. Se pueden cargar en la base de datos en un clúster gratuito en MongoDB Atlas siguiendo la guía de Introducción a MongoDB.
El siguiente código es un archivo completo y autónomo que realiza una operación de inserción múltiple:
import { MongoClient } from "mongodb";
// Replace the uri string with your MongoDB deployment's connection string.const uri = "<connection string uri>";
const client = new MongoClient(uri);
async function run() { try {
// Get the database and collection on which to run the operation const database = client.db("sample_mflix"); const movies = database.collection("movies");
// Create an array of documents to insert const moviesToInsert = [ { title: "Arsenic and Old Lace", genres: ["Comedy", "Romance"], year: 1944, cast: ["Cary Grant", "Priscilla Lane", "Raymond Massey"] }, { title: "Ball of Fire", genres: ["Comedy", "Romance"], year: 1941, cast: ["Gary Cooper", "Barbara Stanwyck", "Oskar Homolka"] }, { title: "I Married a Witch", genres: ["Comedy", "Fantasy", "Romance"], year: 1942, cast: ["Veronica Lake", "Fredric March", "Susan Hayward"] }, ];
// Prevent additional documents from being inserted if one fails const options = { ordered: true };
// Execute insert operation const result = await movies.insertMany(moviesToInsert, options); // Print result console.log(`${result.insertedCount} documents were inserted`); } finally { await client.close(); }}run().catch(console.dir);import { MongoClient } from "mongodb";
// Replace the uri string with your MongoDB deployment's connection string.const uri = "<connection string uri>";
const client = new MongoClient(uri);
interface Movie { title: string; genres: string[]; year: number; cast: string[];}
async function run() { try { const database = client.db("sample_mflix"); // Specifying a schema is optional, but it enables type hints on // finds and inserts const movies = database.collection<Movie>("movies");
const result = await movies.insertMany( { title: "Arsenic and Old Lace", genres: ["Comedy", "Romance"], year: 1944, cast: ["Cary Grant", "Priscilla Lane", "Raymond Massey"] }, { title: "Ball of Fire", genres: ["Comedy", "Romance"], year: 1941, cast: ["Gary Cooper", "Barbara Stanwyck", "Oskar Homolka"] }, { title: "I Married a Witch", genres: ["Comedy", "Fantasy", "Romance"], year: 1942, cast: ["Veronica Lake", "Fredric March", "Susan Hayward"] }, { ordered: true } ); console.log(`${result.insertedCount} documents were inserted`); } finally { await client.close(); }}run().catch(console.dir);Al ejecutar el ejemplo anterior, se produce el siguiente resultado:
3 documents were insertedDocumentación de la API
Para aprender más sobre cualquiera de los tipos o métodos discutidos en esta guía, consulta la siguiente documentación de la API: