Comportamiento, acceso y uso de mongodump

Usando mongodump sin un authSource

Si no se especificaauthSourceen la URI de MongoDB, se utiliza el nombre de la base de datos especificado en--dbpara autenticar la sesión mongodump y ​​para indicar la base de datos que se va a volcar. Para ver un ejemplo del uso de una base de datos diferente para la autenticación al usar mongodump, consulte Autenticación con una base de datos específica.

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.

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.

preferencia de lectura

De forma predeterminada, mongodump usa primary la preferencia de lectura. Para anularla, puede especificar la preferencia de lectura en la opción de línea de comandos --readPreference o --uri connection string en.

Si se especifica la preferencia de lectura tanto en la cadena URI como en la opción,--readPreference el --readPreference valor anula la preferencia de lectura especificada en la cadena URI.

Exclusión de datos

Si especifica --db las opciones --collection y, mongodump vuelca la colección especificada.

Si solo especifica la --db opción, mongodump vuelca esa base de datos con las siguientes exclusiones:

• Si el valor de --db es admin:

  • Si no estás conectado a un proxy de Atlas, mongodump realiza un vaciado de la base de datos pero excluye la colección system.keys.

  • Si está conectado a un Atlas Proxy, mongodump intenta realizar un vaciado de la base de datos pero se produce un error.

• Si el valor de --db es config, mongodump vuelca todas las colecciones en esa base de datos.

• Si el valor de --db es local, mongodump vuelca todas las colecciones en esa base de datos.

• Para todas las demás bases de datos, mongodump excluye todas las colecciones que comienzan con system., excepto system.js.

Si omite la opción --db, se aplicarán las siguientes exclusiones:

• mongodump excluye la base de datos local.

• mongodump solo incluye las siguientes colecciones en la salida para la base de datos config:

  • chunks

  • collections

  • databases

  • settings

  • shards

  • tags

  • version

• Si está conectado a un proxy Atlas, mongodump excluye la base de datos admin.

mongodump producción:

• Contiene los documentos en la base de datos y las definiciones de índice.

• No contiene los datos del índice.

mongorestore o mongod debe reconstruir los índices después de restaurar los datos.

Si está utilizando vistas:

• De forma predeterminada, solomongodump mongodump exporta los metadatos de una vista. no crea una exportación binaria de los documentos incluidos en la vista.

• Para exportar los documentos en una vista,--viewsAsCollections utilice.

Metadata Output

Si genera una salida a un directorio, la salida contiene metadatos de colección que incluyen las siguientes mongodump propiedades:

• Nombres de colecciones

• Tipos de colección

• Opciones de configuración de la colección

• UUID

• Indexes

Si genera la salida mongodump estándarstdout (), esta no incluye metadatos. Para más información, consulte la --out opción.

Metadata Format

mongodump Utiliza el formato JSON Extendido v2.0 (Canónico) para los archivos de metadatos. Para analizar estos archivos y restaurarlos,mongorestore utilice, que admite el formato JSON2 0 Extendido v. (Canónico o modo relajado).

Sobrescribir archivos

mongodump Sobrescribe los archivos de salida si existen en la carpeta de datos de respaldo. Antes de ejecutar el comando mongodump varias veces, asegúrese de que ya no necesite los archivos de la carpeta de salida (la carpeta predeterminada es dump/) o cambie el nombre de las carpetas o archivos.

mongodump Durante la re-fragmentación

mongodump falla si:

• mongodump Se inicia cuando una operación de re-segmentación está en progreso.

• El comando se ejecuta durante reshardCollection una mongodump operación.

Manejo de la compresión de datos

Cuando se ejecuta en una mongod instancia que utiliza el motor de almacenamiento WiredTiger, mongodump genera datos sin comprimir.

Conjunto de trabajo

mongodump Puede afectar negativamente el rendimiento de mongod. Si sus datos superan la memoria del sistema, mongodump desplazará el conjunto de trabajo fuera de la memoria.

FIPS

mongodump crea automáticamente conexiones compatibles con FIPS a un mongod o mongos que estén configurados para usar el modo FIPS.

Uso mongodump de en clústeres Atlas de nivel gratuito y compartido

En los clústeres Atlas de nivel gratuito (M0) y compartido (M2 y M5), se aplican las siguientes limitaciones:

• No se puede ejecutar mongodump en la admin base de datos. Por defecto, mongodump omite esta base de datos. Si se usa la opción para configurar la base de datos de --db destino admin en, el programa devuelve un error.

• No puedes utilizar las siguientes opciones con el programa mongodump:

  • --dumpDbUsersAndRoles

  • --oplog

Implementaciones independientes y conjuntos de réplicas

Para un conjunto independiente o de réplicas, mongodump puede ser parte de una estrategia de respaldo con mongorestore para respaldos parciales basados ​​en una consulta, sincronización desde entornos de producción a entornos de desarrollo o ensayo, o cambio del motor de almacenamiento de un conjunto independiente.

Para obtener detalles sobre el uso de mongodump con mongorestore como parte de una estrategia de respaldo y recuperación, consulte:

• Realiza copias de seguridad y restauraciones con las herramientas de MongoDB

• Métodos de copia de seguridad de 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:

• MongoDB Atlas

• MongoDB Cloud Manager

• MongoDB Ops Manager