MongoDB: diseñar documentos que se puedan mantener
Un catálogo ficticio de herramientas explica documentos, campos variables, referencias e índices en MongoDB, con consultas y decisiones de diseño.
Un taladro y una lijadora comparten nombre, categoría y precio de alquiler, pero sus especificaciones no son idénticas. Un modelo de documentos permite representar esa variación. La parte difícil no es guardar un JSON: es decidir qué información vive junta, cuál se repite y cómo se consulta después.
Un documento representa una unidad de trabajo
MongoDB agrupa documentos en colecciones y los almacena en BSON, un formato binario con tipos adicionales a JSON. La documentación de modelado propone partir de cómo accede la aplicación a los datos.
{
"_id": "taladro-01",
"nombre": "Taladro con cable",
"categoria": "perforacion",
"precioDiaCentimos": 1200,
"especificaciones": {
"potenciaW": 750,
"percusion": true
},
"activo": true
}Representación JSON para explicar el modelo. El precio está expresado en céntimos.
Una lijadora podría tener una especificación de diámetro en lugar de percusión. Eso no obliga a cambiar la estructura de todos los documentos. Los campos compartidos, como categoría o precio, siguen necesitando nombres, tipos y criterios consistentes.
Preparar y comprobar la colección en mongosh
Conéctate con mongosh a una instancia de práctica. Ejecuta este bloque una sola vez en una base vacía: crea la colección herramientas y carga dos fichas. No lo ejecutes sobre una colección existente. Int32 expresa el precio en céntimos como entero BSON.
db = db.getSiblingDB("unacosa_practica");
db.createCollection("herramientas", {
validator: {
$jsonSchema: {
bsonType: "object",
required: ["_id", "nombre", "categoria", "precioDiaCentimos", "activo"],
properties: {
_id: { bsonType: "string" },
nombre: { bsonType: "string" },
categoria: { bsonType: "string" },
precioDiaCentimos: { bsonType: "int", minimum: 0 },
activo: { bsonType: "bool" },
especificaciones: { bsonType: "object" }
}
}
},
validationAction: "error"
});
db.herramientas.insertMany([
{ _id: "taladro-01", nombre: "Taladro con cable",
categoria: "perforacion", precioDiaCentimos: Int32(1200),
activo: true, especificaciones: { potenciaW: 750, percusion: true } },
{ _id: "lijadora-01", nombre: "Lijadora orbital",
categoria: "lijado", precioDiaCentimos: Int32(900),
activo: true, especificaciones: { diametroMm: 125 } }
]);Las especificaciones pueden variar. El precio debe ser un entero no negativo; un texto no cumple el validador.
La consulta que viene después devolverá una sola ficha: taladro-01, Taladro con cable, precioDiaCentimos 1200. La lijadora se ha guardado, pero no pertenece a la categoría perforacion.
db.herramientas.insertOne({
_id: "precio-invalido", nombre: "Ficha de prueba",
categoria: "perforacion", precioDiaCentimos: "1200",
activo: true
});Resultado esperado: error de validación del documento. Esta tercera ficha no se guarda porque el precio es texto.
La guía oficial de validación JSON Schema describe createCollection y $jsonSchema. El ejemplo limita unas pocas reglas; no representa un sistema completo de reservas.
Consultar lo que realmente necesita la pantalla
db.herramientas.find(
{ categoria: "perforacion", activo: true },
{ nombre: 1, precioDiaCentimos: 1 }
).sort({ precioDiaCentimos: 1 })Selecciona herramientas activas de una categoría y devuelve los campos indicados, además de _id por defecto.
La consulta dice algo sobre el diseño: esa pantalla filtra por categoría y estado y ordena por precio. Un índice candidato podría incluir esos campos. Su utilidad debe comprobarse con el plan de ejecución y una carga representativa; añadir índices a todo aumenta almacenamiento y trabajo en las escrituras.
Incrustar o referenciar
Las especificaciones de una herramienta pueden guardarse dentro de su ficha porque normalmente se consultan con ella y tienen un tamaño acotado. Su historial completo de alquileres puede crecer sin límite práctico y necesitar consultas propias: ahí tiene sentido estudiar una colección separada con una referencia.
| Dato | Opción inicial para este ejemplo | Motivo |
|---|---|---|
| Especificaciones de la herramienta | Incrustar en la ficha | Se leen juntas y son acotadas |
| Historial de alquileres | Referenciar desde otra colección | Crece y se consulta por fechas |
| Precio acordado de un alquiler | Conservar en ese alquiler | Es un valor histórico |
| Disponibilidad actual | Definir una fuente coherente | Cambia y no admite copias desactualizadas |
Las buenas prácticas oficiales explican este equilibrio entre incrustar y referenciar. Una copia histórica de un precio es deliberada; mantener tres copias del stock actual obliga a coordinarlas. La repetición no es siempre un error, pero tiene que tener un propósito.
Flexibilidad con reglas
Un documento que guarda precioDiaCentimos como texto puede romper una ordenación o un cálculo. La validación de esquema permite exigir tipos y campos concretos. También conviene decidir cómo leer documentos de versiones anteriores cuando añadas una propiedad nueva.
Por ejemplo, si falta activo, ¿se interpreta como disponible o se rechaza la ficha hasta revisarla? Elegir esa respuesta es parte del producto. Un valor por defecto cómodo puede ocultar que el registro todavía no se ha comprobado.
Qué ocurre cuando dos personas cambian lo mismo
Una escritura sobre un solo documento es atómica en MongoDB. Si una operación debe cambiar varios documentos como una unidad, existen transacciones en los despliegues compatibles, con sus costes y condiciones. La documentación de atomicidad detalla el alcance.
En el ejemplo, dos reservas simultáneas de una única herramienta requieren una regla que evite confirmar ambas. Guardar primero y comprobar después puede llegar tarde. El control debe formar parte de la operación diseñada, no depender de que la pantalla siga mostrando disponibilidad.
Para elegir MongoDB frente a un sistema relacional, compara las consultas, las relaciones y el trabajo de mantenerlos. El artículo de SQL y NoSQL ofrece un modo de hacer esa comparación sin convertirla en una competición de etiquetas.


