MongoDB
Explica cómo populate resuelve referencias en Mongoose, qué consultas adicionales genera y cuándo conviene reemplazarlo por agregaciones o lecturas específicas.
reemplaza referencias almacenadas —normalmente ObjectId— por documentos obtenidos desde otra colección. Es una comodidad de Mongoose, no un join gratuito ni una operación ejecutada dentro del documento original.
populate()documentos base
→ recopilar referencias
→ consultas adicionales
→ asociar resultadosSu utilidad depende del access pattern, cardinalidad y tamaño del resultado.
const order = await Order.findById(orderId)
.populate({
path: 'customerId',
select: 'name email'
});El documento base conserva customerId; Mongoose consulta el Model referenciado y sustituye el valor en la respuesta hidratada.
customerId: {
type: Schema.Types.ObjectId,
ref: 'Customer',
required: true
}ref identifica el Model, no crea una foreign key ni garantiza que el documento exista. Un delete puede dejar referencias huérfanas.
Population sin select puede traer documentos completos:
.populate({
path: 'customerId',
select: 'name avatarUrl'
})Reducir campos limita payload y exposición. No incluyas password hashes, tokens o información privada por comodidad.
.populate({
path: 'productId',
match: { active: true },
select: 'name price'
})match filtra el documento poblado; normalmente no elimina el documento padre. El resultado poblado puede quedar null o vacío. No confundas esto con filtrar órdenes que tengan un producto activo.
Para filtrar por datos relacionados puede ser más apropiado $lookup, denormalización o consultar primero la entidad relacionada.
.populate({
path: 'comments',
options: {
sort: { createdAt: -1 },
limit: 10
}
})Un límite global puede distribuirse de forma distinta a “diez por documento”. perDocumentLimit ofrece semántica por padre, pero puede generar más consultas. Comprueba versión y número real de round trips.
.populate({
path: 'customerId',
populate: {
path: 'organizationId'
}
})Cada nivel aumenta coste, payload y dificultad de autorización. Tres niveles de population suelen indicar que la API está reconstruyendo un grafo completo para una pantalla.
Mongoose agrupa algunas referencias, pero ciertas combinaciones de limits, nested population o paths dinámicos pueden generar muchas consultas.
Instrumenta command monitoring y cuenta operaciones. No evalúes solo la legibilidad del código.
Permite resolver relación inversa sin guardar array de IDs en el padre:
customerSchema.virtual('orders', {
ref: 'Order',
localField: '_id',
foreignField: 'customerId'
});Evita un array creciente, pero la consulta sigue necesitando índice en foreignField:
{ customerId: 1, createdAt: -1 }Plugins de autopopulate ocultan consultas detrás de cualquier lectura. Riesgos:
Prefiere population explícita por caso de uso.
Poblar una referencia no prueba que el usuario pueda verla. En multi-tenant:
Una orden válida podría referenciar accidentalmente un customer de otro negocio si la integridad no se valida.
Ninguno corrige un modelo relacional excesivo.
Prefiere embedding cuando los datos:
Prefiere snapshot cuando la orden debe conservar nombre y precio históricos, en lugar de poblar el producto actual.
Population funciona con lean bajo opciones compatibles. Los resultados poblados también son objetos simples, sin métodos, getters ni virtuals normales.
Prueba transforms y TypeScript: el tipo de un path cambia de ObjectId a documento poblado, lo que puede volver ambiguo el modelo.
Evita una interfaz donde customerId sea simultáneamente ObjectId | CustomerDocument en todo el sistema. Define tipos específicos:
type OrderStored = {
customerId: ObjectId;
};
type OrderWithCustomer = {
customerId: {
id: string;
name: string;
};
};Mejor aún, transforma a DTO después de la query.
Population no ofrece snapshot consistente entre consultas por defecto. El documento relacionado puede cambiar entre leer padres y referencias. Si necesitas una vista histórica, usa snapshot; si necesitas consistencia transaccional, diseña la lectura y concerns explícitamente.
match produce null;limit no es por documento;select y secretos.$lookup.Population simplifica resolver referencias, pero añade consultas, payload y estados nulos. Úsalo de manera explícita, con selección, límites, índices y autorización. Cuando la relación se lee siempre junta, necesita historia o crece sin límite, reconsidera el modelo antes de añadir más populate().
populate()?match no filtra siempre al padre?$lookup?Middleware de Mongoose.