Advertencia
Conflictos de volcado y restauración de datos con el prefijo $ en los campos
A partir de MongoDB 5.0, los nombres de campos de documentos pueden tener como prefijo un carácter de dólar ($). Sin embargo, mongodump y no funcionarán con nombres de campo que tengan como prefijo un carácter de dólar en las opciones de una mongorestore colección.
MongoDB Extended JSON (v)2 no puede diferenciar entre contenedores de tipos y campos con el mismo nombre que estos. No utilice formatos JSON extendidos si la representación BSON correspondiente podría incluir claves con el $ prefijo. El mecanismo DBRefs es una excepción a esta regla general.
Comportamiento
Restaurar a la versión del servidor coincidente
Al usar para cargar mongorestore mongodump archivos de datos creados por, las versiones de MongoDB de sus implementaciones de origen y destino deben ser:
La misma versión principal.
La misma versión de compatibilidad de características.
Por ejemplo, si su volcado se creó a partir de una implementación de MongoDB que ejecuta la versión 4.4, la implementación de MongoDB que restaure también debe ejecutar la versión 4.4 o tener su FCV configurado en 4.4.
Para cambiar la versión de compatibilidad de funciones,setFeatureCompatibilityVersion consulte.
Nota
Puede restaurar los archivos BSON generados desde mongodump en implementaciones de MongoDB que ejecuten la misma versión o una más reciente que la implementación de origen. Sin embargo, restaurar los archivos en una implementación con una versión más reciente no es la forma recomendada de actualizar su implementación. Para saber cómo actualizar su implementación, consulte la documentación de actualización.
Esta garantía no aplica a metadatos, archivos de archivo ni archivos de reproducción de registros de operaciones. Si intenta restaurar estos archivos con diferentes versiones de implementación de origen y destino, el proceso mongorestore podría provocar un fallo, un fallo silencioso o metadatos dañados.
Además, asegúrese de usar la misma versión demongorestorepara cargar los archivos de datos que la versión demongodumpque usó para crearlos. Por ejemplo, si usómongodumpversión 100.14.1 para crear el volcado, usemongorestoreversión 100.14.1 para restaurarlo.
Sólo insertar
mongorestore Puede crear una nueva base de datos o agregar datos a una existente. Sin embargo, mongorestore solo realiza inserciones, no actualizaciones. Si restaura documentos en una base de datos y colección existentes, y los documentos existentes tienen el mismo valor _id en el campo que los documentos a restaurar, mongorestore no sobrescribirá esos documentos.
Orden de documentos
De forma predeterminada, mongorestore puede insertar documentos en orden aleatorio. Para conservar el orden de los documentos durante el proceso de restauración,--maintainInsertionOrder utilice.
Reconstruir índices
mongorestore recrea los índices registrados por después de restaurar los mongodump datos.
Nota
Para las instalaciones de MongoDB con featureCompatibilityVersion (FCV) configurado en "4.0" o anterior, la creación de índices generará un error si una clave de índice en un documento existente excede el límite.
Para evitar este problema, considere usar índices hash o indexar un valor calculado. Para resolver el problema del índice después de restaurar los datos, puede deshabilitar la validación predeterminada de la longitud de la clave de índice en la base de datos de destino estableciendo el parámetro de la instancia mongod failIndexKeyTooLong en falso.
Excluir system.profile Colección
mongorestore no restaura los system.profile datos de la colección.
FIPS
mongorestore crea automáticamente conexiones compatibles con FIPS a un mongod/mongos que está configurado para usar el modo FIPS.
Nivel de confirmación de escritura
Si especifica la preocupación de escritura tanto en la opción--writeConcerncomo en la opción de cadena de conexión--uri, el valor--writeConcernanula la preocupación de escritura especificada en la cadena URI.
Colecciones de series de tiempo
A partir de MongoDB,5.0 puede usar mongorestore para restaurar colecciones de series temporales. Para obtener más información, consulte Restaurar una colección de series temporales.
Uso mongorestore de en clústeres Atlas Free y Flex
En los clústeres gratuitos (M0) y Flex, se aplican las siguientes limitaciones:
No se puede ejecutar
mongorestoreen laadminbase de datos. Por defecto,mongorestoreomite esta base de datos. Si se usa la opción para configurar la base de datos de--dbdestinoadminen, el programa devuelve un error.No puedes utilizar las siguientes opciones con el programa
mongorestore:
Nota
Reversiones del clúster de destino
Si el clúster se revierte durante el proceso de restauración, elimine todos los datos restaurados o importados y repita el proceso desde el principio. Consulte la documentación de reversión para obtener más información.
Acceso requerido
Para restaurar datos en una implementación de MongoDB que tiene habilitado el control de acceso, el rol proporciona los privilegios restore necesarios para restaurar datos de las copias de seguridad si los datos no incluyen system.profile datos de recopilación y ejecuta mongorestore sin la --oplogReplay opción.
Si los datos de copia de seguridad incluyen los datos de una colección system.profile o si ejecutas mongorestore con la opción --oplogReplay, necesitas privilegios adicionales:
| Si los datos de la copia de seguridad incluyen Tanto los roles integrados |
| Para ejecutar con, Otorgar sólo a usuarios que deben ejecutar |
Uso en la estrategia de backup
Conjuntos independientes/réplicas
Para obtener una descripción general del mongorestore uso de como parte de una estrategia de copia de seguridad y recuperación, consulte Realizar copias de seguridad y restaurar con herramientas MongoDB.
Clústeres fragmentados
Para utilizar mongodump y como estrategia de respaldo para clústeres fragmentados, consulte Realizar mongorestore una copia de seguridad de un clúster fragmentado autoadministrado con un volcado de base de datos.
Los clústeres fragmentados también pueden usar uno de los siguientes procesos coordinados de copia de seguridad y restauración, que garantizan la atomicidad entre los fragmentos y al mismo tiempo aceptan escrituras: