➕ Insertar documentos (Insert)

➕ Insertar documentos (Insert)

En MongoDB, insertar datos significa añadir documentos dentro de una colección. A diferencia de las bases de datos SQL donde se agregan filas en tablas, aquí trabajamos con documentos en formato JSON, mucho más flexible.

Puedes insertar documentos usando MongoDB Compass, la Mongo Shell (mongosh) o desde tu aplicación usando un driver como Node.js, Python o PHP. En esta entrada aprenderás a insertar datos paso a paso usando los métodos más comunes.

---

📘 1️⃣ ¿Qué es un documento en MongoDB?

Un documento es un objeto con estructura JSON que representa un registro. Ejemplo:

{
  "nombre": "Carlos Pérez",
  "edad": 28,
  "correo": "carlos@correo.com"
}

Cada documento insertado recibe automáticamente un campo único _id generado por MongoDB si no lo especificas.

---

🖥️ 2️⃣ Insertar documentos usando MongoDB Compass

MongoDB Compass es la herramienta gráfica oficial y la forma más sencilla de insertar datos.

1. Abre Compass e inicia sesión en tu servidor mongodb://localhost:27017.
2. Selecciona la base de datos, por ejemplo tiendaOnline.
3. Elige la colección donde insertarás documentos, por ejemplo usuarios.
4. Haz clic en Insert Document.

Ejemplo de documento a insertar:

{
  "nombre": "Ana Torres",
  "correo": "ana@correo.com",
  "edad": 35,
  "rol": "cliente"
}

Para insertar varios documentos a la vez, usa Insert Many y pega un arreglo:

[
  {
    "nombre": "Luis Martín",
    "correo": "luis@correo.com",
    "edad": 41,
    "rol": "administrador"
  },
  {
    "nombre": "Claudia Ruiz",
    "correo": "claudia@correo.com",
    "edad": 29,
    "rol": "cliente"
  }
]

---

⌨️ 3️⃣ Insertar documentos con la Mongo Shell (mongosh)

Si prefieres trabajar desde consola, mongosh es rápido y muy práctico.

➡️ Seleccionar la base de datos:

use tiendaOnline

➡️ Insertar un documento:

db.usuarios.insertOne({
  nombre: "Carlos Pérez",
  correo: "carlos@correo.com",
  edad: 28,
  rol: "cliente"
});

➡️ Insertar varios documentos:

db.usuarios.insertMany([
  {
    nombre: "Ana Torres",
    correo: "ana@correo.com",
    edad: 35,
    rol: "cliente"
  },
  {
    nombre: "Luis Martín",
    correo: "luis@correo.com",
    edad: 41,
    rol: "administrador"
  }
]);

---

🛒 4️⃣ Ejemplo real: Insertar productos para una tienda online

En un proyecto de ecommerce, los productos se guardan dentro de la colección productos.

db.productos.insertOne({
  nombre: "Auriculares Bluetooth",
  precio: 29.99,
  stock: 120,
  categoria: "audio",
  descripcion: "Auriculares inalámbricos con cancelación de ruido.",
  activo: true
});

Varios productos:

db.productos.insertMany([
  {
    nombre: "Teclado Mecánico RGB",
    precio: 59.99,
    stock: 80,
    categoria: "periféricos",
    activo: true
  },
  {
    nombre: "Mouse Gamer 7200 DPI",
    precio: 19.99,
    stock: 200,
    categoria: "periféricos",
    activo: true
  }
]);

---

🧠 5️⃣ Notas importantes

• MongoDB genera automáticamente el campo _id.
• No requiere un esquema fijo, pero puedes usar validación si quieres estructura.
• Compass es ideal para principiantes; mongosh para trabajar rápido.
• Los documentos pueden tener diferente estructura, aunque no es recomendable.

---

🧭 6️⃣ Resumen rápido

1. Elige tu base de datos con use.
2. Usa insertOne o insertMany para agregar documentos.
3. Puedes insertar desde Compass o desde la consola.
4. MongoDB trabaja con documentos JSON, no con filas ni tablas.

---

← Volver al índice