MongoDB
Explica cómo mover datos con mongoimport, mongoexport, mongodump y mongorestore, sus formatos, límites y diferencias entre migración lógica y respaldo.
Importar, exportar y respaldar son tareas diferentes. / intercambian JSON o CSV; / trabajan con BSON y metadata para copias lógicas. Elegir la herramienta incorrecta puede perder tipos, índices, validators o consistencia.
mongoimportmongoexportmongodumpmongorestoreintercambio de datos → import/export
backup lógico → dump/restore
migración online → proceso especializadoExporta documentos a JSON o CSV:
mongoexport \
--uri="$MONGODB_URI" \
--collection=orders \
--query='{"status":"confirmed"}' \
--out=orders.jsonEs útil para análisis, integración o entrega de subconjuntos. No es un backup integral porque no conserva automáticamente:
JSON estándar no representa ObjectId, Date, Decimal128, Long o Binary sin una convención. Extended JSON conserva esos tipos:
{
"_id": { "$oid": "64f000000000000000000001" },
"createdAt": { "$date": "2026-07-24T12:00:00Z" },
"total": { "$numberDecimal": "18.50" }
}Antes de consumirlo, confirma si el formato es canonical o relaxed y qué espera la herramienta destino.
CSV es plano. Arrays y subdocumentos no encajan naturalmente. Además:
Úsalo para estructuras tabulares controladas, no como representación completa de BSON.
mongoimport \
--uri="$MONGODB_URI" \
--collection=products \
--file=products.json \
--jsonArrayOpciones de modo pueden insertar, upsert o merge. Debes definir claramente la clave de identidad; un upsert por campo no unique puede modificar documentos incorrectos.
Antes de importar:
mongodump --uri="$MONGODB_URI" --archive=backup.archive --gzip
mongorestore --uri="$TARGET_URI" --archive=backup.archive --gzipSon apropiados para backup lógico o migraciones de tamaño razonable. El dump puede incluir metadata de colecciones e índices, pero la cobertura exacta y consistencia dependen de opciones, versión y topología.
No confundas un dump exitoso con restore probado.
Exportar dos colecciones en momentos distintos puede producir una orden sin sus movimientos relacionados. Para datos activos:
Nunca ejecutes una importación masiva sin control:
archivo validado
→ staging collection
→ checks y deduplicación
→ migración por batches
→ índices
→ cutoverUna staging collection permite inspeccionar y transformar antes de tocar la fuente de verdad.
Valida explícitamente:
Ejemplo peligroso:
{ "active": "false" }El string es truthy en JavaScript y no equivale a boolean BSON.
Antes de upsert, protege identidad con índice unique. Una consulta previa no evita carreras. Guarda un sourceId para deduplicar importaciones repetidas:
db.products.createIndex(
{ sourceSystem: 1, sourceId: 1 },
{ unique: true }
);Importar aumenta:
A veces conviene crear ciertos índices después de una carga inicial offline, pero en producción activa debes balancear query availability, uniqueness y coste. No elimines garantías para acelerar sin plan.
Los exports pueden contener PII o secretos. Aplica:
No envíes dumps por correo o enlaces públicos.
En clusters sharded, importaciones sin shard key pueden hacer broadcast o concentrar tráfico. Para dumps/restores completos usa procedimientos compatibles con metadata y topología; no combines exports independientes como si fueran snapshot del cluster.
Después de importar:
explain();Import/export sirve intercambio; dump/restore sirve copia lógica. Extended JSON conserva tipos BSON mejor que JSON simple y CSV. Toda carga necesita identidad, validación, seguridad, control de capacidad y verificación funcional; ningún archivo sustituye un backup restaurado.
mongoexport y mongodump?Monitoreo y observabilidad.