`mongorestore`

Esta documentación es para la versión 100.18.0 de mongorestore.

Definición

El mongorestore programa carga datos desde un volcado de base de datos binario creado por mongodump o desde la entrada estándar en una mongod mongos instancia o. mongorestore se instala al instalar las herramientas de base de datos de MongoDB.

Puedes usar los MongoDB Database Tools para migrar de una implementación autoalojada a MongoDB Atlas. MongoDB Atlas es el servicio totalmente gestionado para las implementaciones de MongoDB en la nube. Para obtener más información, consulta Propaga con mongorestore.

Para aprender todas las formas en que puede migrar a MongoDB Atlas, consulte Migrar o importar datos.

Puede restaurar los archivos BSON generados desde mongodump en implementaciones de MongoDB que ejecuten la misma versión principal o versión de compatibilidad de funcionalidades entre versiones que la implementación de origen.

mongorestore presenta los siguientes comportamientos y limitaciones:

Se debe ejecutar mongorestore desde la línea de comandos del sistema, no desde el MongoDB Shell.
MongoDB no admite la ejecución simultánea de varios programas mongorestore para la misma colección.
No puedes usar mongorestore con una colección que utiliza Queryable Encryption.

Sintaxis

Utilice la siguiente sintaxis de comando al ejecutar mongorestore:

mongorestore <options> <connection-string> <directory or file to restore>

Consulte Opciones para ver qué opciones puede usar cuando mongorestore ejecute.

Cuando ejecuta mongorestore sin argumentos, la configuración predeterminada es restaurar datos desde un ./dump directorio local a una mongod instancia local que se ejecuta en el 27017 puerto:

mongorestore

También se puede especificar un directorio dump en una ruta diferente. Por ejemplo, el siguiente comando restaura datos desde un directorio en ./downloads/dump a un clúster de Atlas especificado por una cadena de conexión:

mongorestore --uri="<my-connection-string>" ./downloads/dump

A medida que mongorestore se restaura desde el directorio indicado, crea la base de datos y las colecciones según sea necesario y deja un registro del progreso:

2019-07-08T14:37:38.942-0400 preparing collections to restore from
2019-07-08T14:37:38.944-0400 reading metadata for test.bakesales from dump/test/bakesales.metadata.json
2019-07-08T14:37:38.944-0400 reading metadata for test.salaries from dump/test/salaries.metadata.json
2019-07-08T14:37:38.976-0400 restoring test.salaries from dump/test/salaries.bson
2019-07-08T14:37:38.985-0400 no indexes to restore
2019-07-08T14:37:38.985-0400 finished restoring test.salaries (10 documents, 0 failures)
2019-07-08T14:37:39.009-0400 restoring test.bakesales from dump/test/bakesales.bson
2019-07-08T14:37:39.011-0400 restoring indexes for collection test.bakesales from metadata
2019-07-08T14:37:39.118-0400 finished restoring test.bakesales (21 documents, 0 failures)
2019-07-08T14:37:39.118-0400 restoring users from dump/admin/system.users.bson
2019-07-08T14:37:39.163-0400 restoring roles from dump/admin/system.roles.bson
2019-07-08T14:37:39.249-0400 31 document(s) restored successfully. 0 document(s) failed to restore.

También es posible restaurar una colección o colecciones específicas desde el directorio dump. Por ejemplo, la siguiente operación restaura la colección test.purchaseorders desde los archivos de datos correspondientes en el directorio dump:

mongorestore --nsInclude=test.purchaseorders ./dump

Si el directorio dump no contiene el archivo de datos correspondiente para el namespace especificado, mongorestore no se restaura ningún dato. Por ejemplo, el siguiente comando especifica un namespace de colección que no tiene datos correspondientes en el directorio dump:

mongorestore --nsInclude=foo.bar dump/

mongorestore genera los siguientes mensajes:

2019-07-08T14:38:15.142-0400 preparing collections to restore from
2019-07-08T14:38:15.142-0400 0 document(s) restored successfully. 0 document(s) failed to restore.

Si mongorestore no puede encontrar información de la base de datos a partir de la --nsInclude opción, el archivo de metadatos o el nombre del directorio de volcado, restaura a una test base de datos. Por ejemplo, el siguiente mongorestore comando restaura desde un bands.bson archivo:

mongorestore ./bands.bson

Debido a que no hay información de namespace ni una ruta como ./dump/music/bands.bson, mongorestore tiene la siguiente salida:

2026-01-23T11:26:31.821-0500 restoring test.bands from bands.bson
2026-01-23T11:26:31.867-0500 finished restoring test.bands (1 document, 0 failures)
2026-01-23T11:26:31.867-0500 1 document(s) restored successfully. 0 document(s) failed to restore.

mongorestore restaura los datos a una colección bands en la base de datos test. Crea la base de datos y la colección si no existen.

Para más mongorestore ejemplos, consulte Ejemplos de mongorestore.

opciones

Esta sección incluye información sobre todas las opciones disponibles para mongorestore.

--archive=<file>

Restaura desde un archivo creado por mongodump --archive. mongorestore restaura desde el archivo especificado o, si no se especifica un archivo, desde la entrada estándar (stdin).

Para restaurar desde un archivo de archivo, ejecutar mongorestore con la opción --archive y el nombre del archivo de fichero.

Para restaurar desde la entrada estándar, ejecuta mongorestore con la opción --archive y omite el nombre del archivo.

El siguiente ejemplo muestra cómo restaurar desde la entrada estándar:

mongodump --archive | mongorestore --archive

Esta pipeline de comandos primero ejecuta mongodump con la bandera --archive, que imprime su salida en stdout, o salida estándar. Luego, la entrada se canaliza a la entrada estándar de mongorestore utilizando el operador pipe |.

Importante

No se puede utilizar la --archive opción con la opción, que especifica el directorio de --dir volcado.
Las --db opciones y están obsoletas al restaurar desde un archivo de --collection --nsInclude archivo. Para restaurar una base de datos o colección específica, utilice.
Si utiliza la --archive opción con el <path> parámetro, mongorestore <path>ignora.

--authenticationDatabase=<dbname>

Especifica la base de datos de autenticación donde --username se ha creado el especificado. Úselo junto con las opciones --username --password y.

Para obtener más información sobre las bases de datos de autenticación, consulta Base de datos de autenticación.

Si utiliza GSSAPI (Kerberos), PLAIN (LDAP SASL) MONGODB-AWS authentication mechanisms o, debe --authenticationDatabase establecer $external en.

Alternativamente, también puedes especificar la base de datos de autenticación directamente en la URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --authenticationDatabase y ademas se especifica información conflictiva, resultará en error.

--authenticationMechanism=<name>

Por defecto: SCRAM-SHA-1

Especifica el mecanismo de autenticación que la mongorestore instancia utiliza para autenticarse mongod en mongos o.

Modificado en la versión 100.1.0:

A partir de la 100.1.0 versión, mongorestore añade soporte para el MONGODB-AWS mecanismo de autenticación al conectarse a un clúster de MongoDB Atlas.

Valor	Descripción
SCRAM-SHA-1	Mecanismo de autenticación de respuesta de desafío con sal estándarRFC que utiliza la 5802 1 función hash SHA-.
SCRAM-SHA-256	Mecanismo de autenticación de respuesta de desafío con sal estándarRFC que utiliza la 7677 256 función hash SHA-. Se debe establecer featureCompatibilityVersion en `4.0`.
MONGODB-X.509	Autenticación de certificados TLS/SSL de MongoDB.
`MONGODB-AWS`	Autenticación externa utilizando credenciales de AWS IAM para conectarse a un clúster de MongoDB Atlas. Consulte Conéctese a un clúster de MongoDB Atlas usando credenciales de AWS IAM. Nuevo en la versión 100.1.0.
GSSAPI (Kerberos)	Autenticación externa mediante Kerberos. Este mecanismo solo está disponible en MongoDB Enterprise.
PLAIN (SASL LDAP)	Autenticación externa mediante LDAP. También puede utilizar `PLAIN` para autenticar a los usuarios de base de datos. `PLAIN` transmite las contraseñas en texto sin cifrar. Este mecanismo solo está disponible en MongoDB Enterprise.

Alternativamente, también puedes especificar el mecanismo de autenticación directamente en la URI connection string. Proveer una cadena de conexión, mientras también se utiliza --authenticationMechanism y se especifica información conflictiva, resultará en error.

--awsSessionToken=<AWS Session Token>

Si se conecta a un clúster de MongoDB Atlas usando MONGODB-AWS authentication mechanism y usa tokens de sesión además de su ID de clave de acceso de AWS y clave de acceso secreta, puede especificar su token de sesión de AWS en:

este campo,
el AWS_SESSION_TOKEN authMechanismProperties parámetro al,connection string o
la variable de entorno AWS_SESSION_TOKEN.

Consulta Conectar a un clúster de MongoDB Atlas usando credenciales de AWS IAM para obtener un ejemplo de cada uno.

Solo válido cuando se utilizan los valores MONGODB-AWS authentication mechanism y.

--bypassDocumentValidation: Permite a mongorestore omitir la validación de documentos durante la operación. Esto permite insertar documentos que no cumplen con los requisitos de validación.

--collection=<collection>, -c=<collection>

Importante

Se desaconseja el uso de --db las opciones --collection y al restaurar desde un directorio o un archivo comprimido. Para restaurar una base de datos o colección específica desde un archivo comprimido o un directorio, consulte --nsInclude la opción.

Especifica el nombre de la colección de destino donde mongorestore se restaurarán los datos desde un archivo BSON. Si no se --collection especifica, mongorestore se toma el nombre de la colección del archivo de entrada. Si el archivo de entrada tiene una extensión, MongoDB la omite del nombre de la colección.

mongorestore --db=reporting --collection=employeesalaries dump/test/salaries.bson

--compressors=<string>

Especifica el algoritmo de compresión que mongodump utiliza para la comunicación de red entre el cliente mongorestore y el servidor MongoDB. Puede utilizar uno o más de estos valores para la opción --compressors:

snappy
zlib
zstd

Si se especifican varios algoritmos de compresión, mongorestore se debe usar el primero de la lista que sea compatible con la implementación de MongoDB.

Para obtener más información sobre los compresores, consultar la documentación sobre la compresión de red del controlador Go.

--config=<filename>

Nuevo en la versión 100.3.0.

Especifica la ruta completa a un archivo de configuración YAML que contiene valores confidenciales para las siguientes opciones mongorestore:

Esta es la forma recomendada de especificar una contraseña para mongorestore, además de especificarla mediante una solicitud de contraseña. Puedes utilizar cualquier combinación de los argumentos en el archivo.

El archivo de configuración tiene la siguiente estructura:

password: <password>
uri: mongodb://mongodb0.example.com:27017
sslPEMKeyPassword: <password>

Si especifica la opción password sin especificar uri, puede especificar los otros componentes de la cadena de conexión utilizando las opciones de línea de comandos mongorestore, como --username y --host.

Asegúrate de proteger este archivo con los permisos adecuados del sistema de archivos.

Importante

Al utilizar la opción --config, ten en cuenta las siguientes limitaciones y comportamientos:

Si proporcionas el campo password y una cadena de conexión en el campo uri con una contraseña conflictiva, mongorestore resultará en un error.
Si especifica un archivo de configuración con --config y también utiliza las opciones de la línea de comandos --password, --uri o --sslPEMKeyPassword mongorestore, la opción de la línea de comandos anulará la opción correspondiente del archivo de configuración.

--convertLegacyIndexes

Nuevo en la versión 100.0.0.

Remueve cualquier opción de índice no válida especificada en la correspondiente mongodump salida, y reescribe cualquier valor de clave de índice heredado para usar valores válidos.

Las opciones de índice no válidas son aquellas especificadas para un índice que no figuran como campos válidos para el comando. Por createIndexes ejemplo, name y collation son válidas, pero una arbitraria custom_field no lo es. Si --convertLegacyIndexes se especifica, se descartan las opciones de índice no válidas encontradas.
Los valores declave de índice heredados son aquellos que ya no son compatibles con un tipo de índice específico. Por ejemplo, 1 y -1 son valores válidos, pero 0 o una cadena vacía son valores heredados. Si --convertLegacyIndexes se especifica, cualquier valor de clave de índice heredado que se encuentre se reescribe 1 como. Las cadenas no vacías no se reemplazan.

Sin la opción --convertLegacyIndexes especificada, la presencia de opciones de índice no válidas o valores clave de índice heredados podría causar que la creación de índices falle.

Si --noIndexRestore se especifica la opción mongorestore para,--convertLegacyIndexes se ignora la opción.

--db=<database>, -d=<database>

Importante

Especifica la base de datos de destino en la que mongorestore debe restaurar los datos al restaurar desde un archivo BSON. Si la base de datos no existe, mongorestore creará la base de datos. Por ejemplo, el siguiente ejemplo restaura la colección salaries en la base de datos reporting.

mongorestore --db=reporting dump/test/salaries.bson

Si no --db especifica, mongorestore lee el nombre de la base de datos de los archivos de datos.

Alternativamente, también puede especificar la base de datos directamente URI connection string en. Proporcionar una cadena de conexión y, al mismo tiempo,--db usar y especificar información contradictoria dará como resultado un error.

--dir=string

Especifica el directorio de vaciado.

No puede especificar tanto la opción --dir como el argumento <path>, que también especifica el directorio de vaciado, para mongorestore.
No puedes utilizar la opción --archive con la opción --dir.

--drop

Antes de restaurar las colecciones desde la copia de seguridad volcada, elimina las colecciones de la base de datos de destino. no elimina las--drop colecciones que no están en la copia de seguridad.

Cuando la restauración incluye la base de datos admin, mongorestore con--dropelimina todas las credenciales de usuario y las reemplaza con los usuarios definidos en el archivo de volcado. Por lo tanto, en sistemas conauthorizationhabilitado, mongorestore debe poder autenticarse con un usuario existente y con un usuario definido en el archivo de volcado. Si mongorestore no puede autenticarse con un usuario definido en el archivo de volcado, el proceso de restauración fallará, dejando una base de datos vacía.

Si una colección se elimina y se vuelve a crear como parte de la restauración, la colección recién creada tiene un UUID diferente a menos que se --drop use --preserveUUID con.

--dryRun: Ejecuta mongorestore sin importar realmente ningún dato, devolviendo la información resumida de mongorestore. Utilízalo con --verbose para generar información de resumen más detallada.

--fixDottedHashIndex: Crea todos los índices encriptados en campos punteados como índices ascendentes de campo único en la base de datos de destino.

--gssapiHostName=<hostname>

Especifica el nombre de host de un servicio utilizando GSSAPI/Kerberos. Solo es necesario si el nombre de host de una máquina no coincide con el nombre de host resuelto por DNS.

Esta opción solo está disponible en MongoDB Enterprise.

--gssapiServiceName=<serviceName>

Especifique el nombre del servicio usando GSSAPI/Kerberos. Solo es necesario si el servicio no usa el nombre mongodb predeterminado.

Esta opción solo está disponible en MongoDB Enterprise.

--gzip

Restaura desde archivos comprimidos o flujo de datos creado por mongodump --gzip.

Para la restauración desde un directorio de vaciado que contenga archivos comprimidos, ejecuta| mongorestore con la opción --gzip.

Para restaurar desde un archivo comprimido, ejecute mongorestore con --gzip las opciones --archive y.

Nota

Puede utilizar las --nsFrom opciones y --nsTo --gzip con la opción para cambiar el espacio de nombres de la colección que está restaurando.

--help: Devuelve información sobre las opciones y el uso de mongorestore.

--host=<hostname><:port>, -h=<hostname><:port>

Por defecto: localhost:27017

Especifica el nombre de host resoluble de la implementación de MongoDB. Por defecto, mongorestore intenta conectarse a una instancia de MongoDB que se ejecuta en el host local en el número de puerto 27017.

Para conectarse a un conjunto de réplicas, especifique replSetName y una lista semilla de miembros del conjunto, como se muestra a continuación:

--host=<replSetName>/<hostname1><:port>,<hostname2><:port>,<...>

Al especificar el formato de la lista del set de réplicas, mongorestore siempre se conecta al primario.

También puedes conectarte a cualquier Nodo individual del Set de réplicas especificando el host y el puerto de solo ese Nodo:

--host=<hostname1><:port>

Si utilizas IPv6 y el formato <address>:<port>, debes encerrar la parte de una combinación de dirección y puerto entre corchetes (por ejemplo, [<address>]).

Alternativamente, también puedes especificar el nombre de host directamente en el URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --host y ademas se especifica información conflictiva, resultará en error.

--keepIndexVersion: Impide que mongorestore actualice el índice a la versión más reciente durante el proceso de restauración.

--maintainInsertionOrder

Por defecto: false

Si se especifica, mongorestore inserta los documentos en el orden de su aparición en la fuente de entrada. Es decir, se mantienen tanto el orden del agrupamiento de guardado masivo como el orden de los documentos dentro de las agrupaciones.

Especificar --maintainInsertionOrder también habilita y --stopOnError establece numInsertionWorkersPerCollection 1en.

Si no se especifica, mongorestore puede realizar las inserciones en un orden arbitrario.

--noIndexRestore: Impide que mongorestore restaure y construya índices según lo especificado en la salida correspondiente mongodump.

--noOptionsRestore: Impide que mongorestore establezca las opciones de colección, como las especificadas por el collMod comando de base de datos, en las colecciones restauradas.

--nsExclude=<namespace pattern>

Especifica un patrón de espacio de nombres(p. "test.myCollection" "reporting.*""dept*.bar"ej.,,,) para excluir los espacios de nombres coincidentes de la restauración. En el patrón, puede usar asteriscos * como comodines. Para ver un ejemplo del patrón de comodines, consulte Restaurar colecciones con comodines.

Puede especificar varias veces para excluir varios patrones de espacio de --nsExclude nombres.

Si se especifica tanto --nsExclude como --nsInclude, el patrón que --nsExclude especifica tiene prioridad. Por ejemplo, si se especifica tanto --nsExclude="prod.*" como --nsInclude="prod.trips", no se restaurará ninguna colección del namespace prod.

--nsFrom=<namespace pattern>

Utilice para --nsTo renombrar un espacio de nombres durante la operación de restauración. especifica la colección en--nsFrom --nsTo el archivo de volcado, mientras que especifica el nombre que se debe usar en la base de datos restaurada.

--nsFrom acepta un patrón de espacio de nombres como argumento. El patrón de espacio de nombres permite --nsFrom que haga referencia a cualquier espacio de nombres que coincida con el patrón especificado. mongorestore coincide con la ocurrencia válida más pequeña del patrón de espacio de nombres.

Para reemplazos simples, usa asteriscos (*) como comodines. Escapa todos los asteriscos y barras invertidas literales con una barra invertida. Los reemplazos corresponden linealmente a las coincidencias: cada asterisco en --nsFrom debe corresponder a un asterisco en --nsTo, y el primer asterisco en --nsFrom coincide con el primer asterisco en nsTo.

Para reemplazos más complejos, se utilizan signos de dólar para delimitar una variable "comodín" que se usará en el reemplazo. Cambiar namespaces de la colección durante la restauración ofrece un ejemplo de reemplazos complejos con comodines delimitados por signos de dólar.

A diferencia de los reemplazos con asteriscos, los reemplazos con comodines delimitados por el signo de dólar no necesitan ser lineales.

--nsInclude=<namespace pattern>

Especifica un patrón de espacio de nombres(p. "test.myCollection" "reporting.*""dept*.bar"ej.,,,) para restaurar solo los espacios de nombres que coincidan con dicho patrón. En el patrón, puede usar asteriscos * como comodines. Para ver un ejemplo del patrón con comodines, consulte Restaurar colecciones con comodines.

Puede especificar varias veces para incluir varios patrones de espacio de --nsInclude nombres.

Si el directorio o archivo de origen (es decir, el directorio o archivo desde el que estás restaurando los datos) no contiene archivos de datos que coincidan con el patrón de namespace, no se restaurarán datos.

Para los nombres de colección que contienen caracteres no ASCII, mongodump genera los nombres de archivo correspondientes con nombres codificados por porcentaje. Sin embargo, para restaurar estas colecciones, no utilices los nombres codificados. En su lugar, utiliza el namespace con caracteres no ASCII.

Por ejemplo, si el directorio de vaciado contiene dump/test/caf%C3%A9s.bson, especifique --nsInclude "test.cafés".

--nsTo=<namespace pattern>

Utilice para --nsFrom renombrar un espacio de nombres durante la operación de restauración. especifica el nuevo nombre de la colección que--nsTo --nsFrom se utilizará en la base de datos restaurada, mientras que especifica el nombre en el archivo de volcado.

--nsTo acepta un patrón de espacio de nombres como argumento. El patrón de espacio de nombres permite --nsTo que haga referencia a cualquier espacio de nombres que coincida con el patrón especificado. mongorestore coincide con la ocurrencia válida más pequeña del patrón de espacio de nombres.

A diferencia de los reemplazos con asteriscos, los reemplazos con comodines delimitados por el signo de dólar no necesitan ser lineales.

--numInsertionWorkersPerCollection=<int>

Por defecto: 1

Especifica el número de trabajadores de inserción que deben ejecutarse concurrentemente por colección.

Para grandes importaciones, aumentar el número de trabajadores de inserción puede incrementar la velocidad de la importación.

--numParallelCollections=<int>, -j=<int>

Por defecto: 4

El número de colecciones que mongorestore debería restaurar en paralelo.

Si especifica -j al restaurar una sola colección, se-j asigna a la opción en --numInsertionWorkersPerCollection lugar --numParallelCollections de.

--objcheck

Obsoleto desde la versión 9.0.

Obliga mongorestore a a validar todas las solicitudes de los clientes al recibirlas para garantizar que nunca inserten documentos no válidos en la base de datos. Para objetos con un alto grado de anidamiento de subdocumentos, puede tener un pequeño impacto en el--objcheck rendimiento.

A partir de MongoDB 9.0, esta opción no tiene ningún efecto en el comportamiento del servidor. El servidor siempre valida los documentos BSON.

--oplogFile=<path>

Especifica la ruta al archivo oplog que contiene los datos oplog para la restauración. Úselo --oplogReplay con.

Si especifica y hay --oplogFile un oplog.bson archivo en el nivel superior del directorio de volcado, mongorestore devuelve un error.

Advertencia

Utiliza oplogFile con precaución: especificar manualmente las entradas del oplog que se deben aplicar podría causar corrupción e inconsistencias en los datos restaurados.

--oplogLimit=<timestamp>

Impide mongorestore que aplique entradas de oplog con una marca de tiempo posterior o igual <timestamp> a. Especifique <timestamp> los valores en el <time_t>:<ordinal> formato, donde <time_t> son los segundos transcurridos desde la época UNIX y <ordinal> representa un contador de operaciones en el oplog que ocurrieron en el segundo especificado.

Advertencia

Utiliza oplogLimit con precaución: especificar manualmente las entradas del oplog que se deben aplicar podría causar corrupción e inconsistencias en los datos restaurados.

Debe utilizar junto --oplogLimit --oplogReplay con la opción.

--oplogReplay

Después de restaurar el volcado de la base de datos, reproduce las entradas del oplog desde un oplog.bson archivo.

Para aplicar las entradas del oplog del archivo oplog.bson en la restauración, se utiliza mongorestore --oplogReplay. Es posible usar mongodump --oplog junto con mongorestore --oplogReplay para garantizar que los datos estén actualizados y contengan todo lo que se guardó durante la operación de vaciado.

mongorestore busca cualquier fuente válida para el archivo BSON en las siguientes ubicaciones:

El nivel superior del directorio de vaciado, como en el caso de un vaciado creado con mongodump --oplog.
La ruta especificada --oplogFile por.
<dump-directory>/local/oplog.rs.bson, como en el caso de un volcado de la oplog.rs colección en la local base de datos en un mongod que es miembro de un conjunto de réplicas.

Si hay un oplog.bson archivo en el nivel superior del directorio de volcado y una ruta especificada --oplogFile por, mongorestore devuelve un error.

Si hay un archivo oplog.bson en el nivel superior del directorio de vaciado, mongorestore restaura ese archivo como el oplog. Si también hay archivos bson en el directorio dump/local, mongorestore los restaura como colecciones normales.

Si especifica un archivo oplog --oplogFile usando, mongorestore restaura ese archivo como oplog. Si también hay archivos bson en el dump/local directorio, mongorestore los restaura como colecciones normales.

El siguiente mensaje en la salida de reproducción del oplog muestra el número de inserciones antes de la reproducción del oplog. No se incluyen las inserciones realizadas durante la reproducción.

0 document(s) restored successfully. 0 document(s) failed to
restore.

Para ver un ejemplo --oplogReplay de, consulte Usar un archivo Oplog para restaurar datos.

Nota

Al usar mongorestore con para restaurar un conjunto de réplicas,--oplogReplay debe restaurar un volcado completo de un miembro del conjunto mongodump --oplog de réplicas creado con. mongorestore con --oplogReplay falla si usa alguna de las siguientes opciones para limitar los datos que se van a restaurar:

--db
--collection
--nsInclude
--nsExclude
--nsFrom
--nsTo

Advertencia

mongorestore no se puede reproducir un rango de oplog que abarque una conversión de formato de serie de tiempo. El servidor realiza esta conversión cuando cambia la compatibilidad de características entre versiones (FCV) entre MongoDB 8.x y MongoDB 9.0. Para aprender a restaurar a través de una conversión, consulte Reproducción de Oplog a través de una conversión de formato de serie de tiempo.

Tip

--password=<password>, -p=<password>

Especifica una contraseña para autenticarse en una base de datos MongoDB que utiliza autenticación. Úsela junto con las opciones --username --authenticationDatabase y.

Para solicitar la contraseña al usuario, pase la --username opción sin o especifique --password --password una --password=""cadena vacía como valor, como en.

Alternativamente, también puedes especificar la contraseña directamente en la URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --password y ademas se especifica información conflictiva, resultará en error.

Si se conecta a un clúster de MongoDB Atlas MONGODB-AWS authentication mechanismusando, puede especificar su clave de acceso secreta de AWS en:

este campo,
connection stringel, o
la variable de entorno AWS_SECRET_ACCESS_KEY.

Consulta Conectar a un clúster de MongoDB Atlas usando credenciales de AWS IAM para obtener un ejemplo de cada uno.

Advertencia

En algunos sistemas, una contraseña proporcionada directamente mediante la opción --password puede ser visible para programas de estado del sistema, como ps, que pueden ser invocados por otros usuarios. Considera en cambio:

omitiendo la opción --password para recibir un aviso interactivo de contraseña, o
utilizando la opción --config para especificar un archivo de configuración que contenga la contraseña.

<path>

La ruta del directorio o el nombre del archivo BSON desde el cual restaurar los datos.

No puede especificar tanto el argumento <path> como la opción --dir, que también especifica el directorio de vaciado, para mongorestore.

--port=<port>

Por defecto: 27017

Especifica el puerto TCP en el que la instancia de MongoDB escucha las conexiones de los clientes.

Alternativamente, también puedes especificar el puerto directamente en el URI connection string. Proporcionar una cadena de conexión y también utilizar --port y especificar información conflictiva resultará en un error.

--preserveUUID

Las colecciones restauradas utilizan el UUID de los datos de la restauración en lugar de crear un nuevo UUID para las colecciones que se descartan y se recrean como parte de la restauración.

Para usar, también --preserveUUID --drop debe incluir la opción.

--quiet

Ejecuta mongorestore en modo silencioso que intenta limitar la cantidad de salida.

Esta opción suprime:

errors
Salida de los comandos de la base de datos
Actividad de replicación
eventos de aceptación de conexión
eventos de cierre de conexión

--restoreDbUsersAndRoles

Restaura las definiciones de usuario y rol para la base de datos dada. Consulta la colección system.roles y la colección system.users para obtener más información.

Nota

Solo puede usar --restoreDbUsersAndRoles en un vaciado de base de datos que se haya creado con la opción --dumpDbUsersAndRoles.
Restaurar la admin base de datos especificando --db admin restaura automáticamente todos los usuarios y roles. No se puede usar --restoreDbUsersAndRoles en la admin base de datos, e intentar hacerlo genera un error.

--ssl

Permite la conexión a un mongod o que tenga habilitado el soporte mongos TLS/SSL.

Alternativamente, también puedes configurar el soporte TLS/SSL directamente en el URI connection string. Proveer una cadena de conexión, mientras también se utiliza --ssl y se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslAllowInvalidCertificates

Omite las comprobaciones de validación de los certificados del servidor y permite el uso de certificados no válidos. Al usar la allowInvalidCertificates configuración, MongoDB registra como advertencia el uso del certificado no válido.

Advertencia

Aunque está disponible, evita utilizar la opción --sslAllowInvalidCertificates en lo posible. Si necesitas usar --sslAllowInvalidCertificates, utiliza únicamente la opción en los sistemas donde no sea posible la intrusión.

Conectarse a una instancia mongod o sin validar los certificados del servidor supone un riesgo potencial para la seguridad. Si solo necesita deshabilitar la validación del nombre de host en los certificados TLS/SSL,mongos --sslAllowInvalidHostnames consulte.

Alternativamente, también puede desactivar la validación del certificado directamente en el URI connection string. Proporcionar una cadena de conexión mientras también se utiliza --sslAllowInvalidCertificates y especificar información contradictoria dará lugar a un error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslAllowInvalidHostnames

Desactiva la validación de los nombres de host en los certificados TLS/SSL. Permite a mongorestore conectarse a instancias de MongoDB incluso si el nombre de host en sus certificados no coincide con el nombre de host especificado.

Como alternativa, también puedes desactivar la validación del nombre de host directamente en la URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --sslAllowInvalidHostnames y ademas se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslCAFile=<filename>

Especifica el archivo .pem que contiene la cadena de certificados raíz de la Autoridad Certificadora. Especifica el nombre del archivo .pem con rutas relativas o absolutas.

Alternativamente, también puedes especificar el archivo .pem directamente en la URI connection string. Proveer una cadena de conexión, mientras también se utiliza --sslCAFile y se especifica información conflictiva, dará como resultado un error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslCRLFile=<filename>

Especifica el archivo .pem que contiene la Lista de revocación de certificados. Especifica el nombre del archivo .pem con rutas relativas o absolutas.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslPEMKeyFile=<filename>

Especifica el archivo .pem que contiene tanto el certificado TLS/SSL como la clave. Especifica el nombre del archivo .pem con rutas relativas o absolutas.

Esta opción es necesaria cuando se utiliza la opción--sslpara conectarse a unmongodomongosque tieneCAFilehabilitado sinallowConnectionsWithoutCertificates.

Alternativamente, también puedes especificar el archivo .pem directamente en la URI connection string. Proveer una cadena de conexión, mientras también se utiliza --sslPEMKeyFile y se especifica información conflictiva, dará como resultado un error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

--sslPEMKeyPassword=<value>

Especifica la contraseña para descifrar el archivo de clave de certificado (es--sslPEMKeyFile decir,). Utilice la opción solo si el archivo de clave de certificado está cifrado. En todos los casos, la --sslPEMKeyPassword opción mongorestore ocultará la contraseña en todos los registros e informes.

Si la clave privada del archivo PEM está cifrada y no especifica la opción, se --sslPEMKeyPassword le mongorestore pedirá que introduzca una contraseña en la opción.Consulte Contraseña del certificado TLS/SSL.

Alternativamente, también puedes especificar la contraseña directamente en la URI connection string. El ofrecer una cadena de conexión, mientras también se utiliza --sslPEMKeyPassword y ademas se especifica información conflictiva, resultará en error.

Para obtener más información sobre TLS/SSL y MongoDB, consulta Configurar mongod y mongos para TLS/SSL y Configuración de TLS/SSL para clientes.

Advertencia

En algunos sistemas, una contraseña proporcionada directamente mediante la opción --sslPEMKeyPassword puede ser visible para los programas de estado del sistema, como ps, que pueden ser invocados por otros usuarios. En su lugar, considera usar la opción --config para especificar un archivo de configuración que contenga la contraseña.

--stopOnError

Obliga a mongorestore a detener la restauración cuando se encuentra con un error.

Por defecto, mongorestore continúa cuando encuentra errores de validación de claves y documentos duplicados. Para garantizar que el programa se detenga ante estos errores,--stopOnError especifique.

--uri=<connectionString>

Especifica la cadena de conexión URI resoluble de la implementación de MongoDB, entre comillas:

--uri="mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]"

A partir de la versión 100.0 mongorestorede, la cadena de conexión puede proporcionarse alternativamente como un parámetro posicional, sin utilizar la --uri opción:

mongorestore mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]

Como parámetro de posicionamiento, la cadena de conexión puede especificarse en cualquier punto de la línea de comandos, siempre que comience con mongodb:// o mongodb+srv://. Por ejemplo:

mongorestore --username joe --password secret1 mongodb://mongodb0.example.com:27017 --ssl

Solo se puede proporcionar una cadena de conexión. Intentar incluir más de una, ya sea usando la --uri opción o como argumento posicional, generará un error.

Para obtener información sobre los componentes de la cadena de conexión, consulta la documentación del formato URI de la cadena de conexión.

Nota

Algunos componentes en el connection string pueden especificarse alternativamente utilizando sus propias opciones explícitas de línea de comandos, como --username y --password. El proveer una cadena de conexión, mientras también se utiliza una opción explícita y se especifica información conflictiva, resultará en error.

Nota

Si utiliza mongorestore en Ubuntu,18.04 es posible que experimente un cannot unmarshal DNS mensaje de error al usar cadenas de conexión SRV (en el mongodb+srv:// formato) con la opción.--uri En ese caso, utilice una de las siguientes opciones:

la opción --uri con una cadena de conexión que no sea SRV (en el mongodb:// formato)
la opción --host para especificar el host al cual conectarse directamente

Advertencia

En algunos sistemas, una contraseña proporcionada en una cadena de conexión con la opción --uri puede ser visible para programas de estado del sistema como ps que otros usuarios puedan invocar. Considera en su lugar:

omitir la contraseña en la cadena de conexión para recibir un aviso interactivo de contraseña, o
utilizando la opción --config para especificar un archivo de configuración que contenga la contraseña.

--username=<username>, -u=<username>

Especifica un nombre de usuario para autenticarse en una base de datos MongoDB que utiliza autenticación. Úselo junto con las opciones --password --authenticationDatabase y.

Alternativamente, también puede especificar el nombre de usuario directamente en el URI connection string. Proporcionar una cadena de conexión mientras también se utiliza --username y especificar información conflictiva resultará en un error.

Si se conecta a un clúster de MongoDB Atlas MONGODB-AWS authentication mechanismutilizando, puede especificar su ID de clave de acceso de AWS en:

este campo,
connection stringel, o
la variable de entorno AWS_ACCESS_KEY_ID.

Consulta Conectar a un clúster de MongoDB Atlas usando credenciales de AWS IAM para obtener un ejemplo de cada uno.

--verbose, -v: Aumenta la cantidad de reportes internos devueltos en la salida estándar o en las entradas de registro. Aumenta el nivel de verbosidad con la forma -v incluyendo la opción varias veces (por ejemplo, -vvvvv.)

--version: Devuelve el número de la versión mongorestore.

--writeConcern=<document>

Por defecto: mayoría

Especifica la preocupación de escritura para cada operación de escritura que mongorestore realiza.

Especifica el nivel de confirmación de escritura (write concern) como un documento con opciones w:

--writeConcern="{w:'majority'}"

Si la preocupación de escritura también se incluye en el,--uri connection string --writeConcern la línea de comandos anula la preocupación de escritura especificada en la cadena URI.

Obtén más información

Volver

Ejemplos

Compatibilidad e instalación