mongodump y mongorestore para copias de seguridad completas

mongodump crea una instantánea BSON binaria de una base de datos o colección. A diferencia de mongoexport, que genera JSON legible, mongodump conserva exactamente toda la información de tipos BSON —ObjectIds, fechas, decimales y datos binarios— sin ninguna pérdida de fidelidad. Esto la convierte en la herramienta adecuada para realizar copias de seguridad completas y migraciones de bases de datos entre clústeres de MongoDB, mientras que mongoexport es mejor para compartir datos de forma selectiva.

Al ejecutar mongodump sin argumentos, se descargan todas las bases de datos de la instancia local de MongoDB en un directorio dump/. Especifique --uri, --db y, opcionalmente, --collection para limitar el alcance. El directorio de salida contiene un subdirectorio por base de datos, cada uno con archivos .bson y .metadata.json por colección.

Use --collection para volcar únicamente una colección de una base de datos. Esto produce un solo archivo .bson y su archivo .metadata.json correspondiente, que almacena las definiciones de los índices. Los volcados de colecciones específicas resultan útiles para extraer una colección concreta para su migración sin realizar una copia de seguridad de toda la base de datos.

Los volcados BSON grandes pueden consumir mucho espacio en disco. Use --gzip para comprimir los archivos de salida a medida que se escriben. Cada archivo .bson se convierte en un archivo .bson.gz, normalmente con una compresión de entre 5 y 10 veces para colecciones de documentos habituales. La compresión se ejecuta en el proceso de mongodump y requiere una opción --gzip correspondiente en mongorestore para descomprimir.

Use --archive para escribir todo el volcado en un único archivo de archivo en lugar de un árbol de directorios. También puede enviarlo mediante una tubería a gzip o aws s3 cp para realizar en un solo paso la copia de seguridad comprimida y la carga. Este es el formato de volcado más compacto y portátil para automatizar copias de seguridad en CI o mediante tareas cron.

mongorestore lee un directorio o archivo creado por mongodump e inserta los documentos en un clúster de MongoDB de destino. Vuelve a crear las colecciones con sus definiciones de índices, obtenidas de los archivos .metadata.json, después de cargar los datos. Especifique el clúster de destino con --uri y el directorio o archivo de origen con --dir o --archive.

De forma predeterminada, mongorestore restaura la base de datos con el mismo nombre que tenía en el volcado. Use --nsFrom y --nsTo, es decir, espacio de nombres de origen y de destino, para restaurar con un nombre de base de datos o colección diferente. Esto es esencial al clonar datos de producción en una base de datos de staging con otro nombre.

Al igual que mongoimport, mongorestore tiene una opción --drop que elimina cada colección antes de restaurarla. Sin --drop, mongorestore combina los documentos restaurados con los datos existentes, lo que resulta útil para restauraciones parciales. Con --drop, obtiene un reemplazo limpio de la colección, lo que es más seguro para restauraciones completas de bases de datos y evita mezclar datos obsoletos con la copia de seguridad.

En bases de datos con muchas colecciones, mongorestore puede restaurar varias colecciones en paralelo. Use --numParallelCollections, cuyo valor predeterminado es 4, para aumentar el paralelismo en servidores con gran capacidad de E/S. Un mayor número de restauraciones paralelas reduce el tiempo total de restauración, pero aumenta el uso de memoria y CPU tanto en el cliente como en el servidor.

Automatice las copias de seguridad diarias ejecutando un script de shell desde una tarea cron. El script crea un directorio de copia de seguridad con una marca de tiempo, ejecuta mongodump, comprime el resultado y, opcionalmente, lo carga en S3 u otro almacenamiento remoto. Compruebe siempre el código de salida de mongodump para detectar copias de seguridad fallidas antes de sobrescribir la copia anterior.

MongoDB Atlas proporciona copias de seguridad automatizadas Point-in-Time (PIT) que capturan instantáneas cada 6 horas y permiten restaurar cualquier segundo dentro del período de retención, de hasta 35 días en los niveles M10 o superiores. Las copias de seguridad de Atlas no utilizan mongodump; aprovechan instantáneas a nivel del sistema de archivos en el nivel del motor de almacenamiento para realizar copias sin impacto. En MongoDB autogestionado, mongodump es el mecanismo principal de copia de seguridad, pero es una copia de seguridad lógica y no puede capturar transacciones en curso.

En esta lección ha aprendido que mongodump crea copias de seguridad BSON binarias que conservan toda la información de tipos, que mongorestore lee esos volcados y vuelve a crear las colecciones con sus índices y que --drop, --nsFrom/--nsTo y --gzip son opciones esenciales para los flujos de trabajo de copias de seguridad en producción. A continuación escribiremos scripts de carga inicial de Node.js para cargar datos en MongoDB mediante programación durante el desarrollo.