Cargar datos en un clúster Atlas Infinite.

Configure un usuario de base de datos en la implementación de origen.

Si la implementación de origen exige autenticación, mongodump debe autenticarse como un usuario de base de datos con permisos de lectura para todas las bases de datos que migre. El rol backup en la base de datos admin otorga estos privilegios.

Si no existe ningún usuario con esas características en su implementación de origen, créelo. Para obtener información sobre cómo crear y administrar usuarios de base de datos, consulte la siguiente página correspondiente a su tipo de implementación:

• Para clústeres administrados por Atlas, consulte Configurar usuarios de la base de datos.

• Para implementaciones autogestionadas, consulte la sección "Administrar usuarios y roles en implementaciones autogestionadas".

Configure un usuario de base de datos en el clúster Atlas Infinite de destino.

El usuariomongorestore debe autenticarse como un usuario de base de datos con permisos de escritura para todas las bases de datos que migre. El rol Atlas admin en el clúster Atlas Infinite de destino otorga estos privilegios.

Si no existe ningún usuario con esas características en el clúster de Atlas Infinite de destino, créelo. Para obtener información sobre cómo crear y administrar usuarios de base de datos en Atlas, consulte Configurar usuarios de base de datos.

Conceda a su red host acceso a las implementaciones de origen y destino.

Asegúrese de que el host donde ejecuta mongodump y mongorestore pueda acceder a ambas implementaciones:

• Agregue el host a la lista de control de acceso IP del proyecto que contiene su clúster Atlas Infinite de destino. Para obtener información sobre cómo agregar un host a una lista de control de acceso IP, consulte Configurar entradas de la lista de control de acceso IP.

• Si su implementación de origen es un clúster Atlas Core en un proyecto diferente, agregue también el host a la lista de acceso IP de ese proyecto. Si su implementación de origen es autogestionada, configure su firewall para que acepte conexiones desde el host. Para obtener más información, consulte Refuerzo de la red y la configuración.

Si configura el emparejamiento de VPC, puede agregar el bloque CIDR de la VPC del par, una subred o el grupo de seguridad de la VPC del par a la lista de acceso IP. Para obtener más información, consulte Lista de acceso IP.

Ejecutar mongodump.

1. Ensamble el comando mongodump.

   La siguiente plantilla de comando mongodump se conecta a un conjunto de réplicas de origen o a un clúster independiente utilizando su cadena de conexión y genera un archivo comprimido del volcado en un archivo.

   Copie la plantilla en su editor de texto preferido y reemplace el marcador de posición <connectionString> con la cadena de conexión para su implementación de origen, y <fileName> con el nombre del archivo de archivo que se creará.

   mongodump --uri "<connectionString>" --archive=<fileName>.archive

   Para aprender a construir una cadena de conexión para la implementación de su fuente, consulte la sección Cadenas de conexión.

   Nota

   Si se usa mongodump o mongorestore en Ubuntu 18.04, puede que experimentes un mensaje de error cannot unmarshal DNS al usar cadenas de conexión SRV (en la forma mongodb+srv://) con la opción --uri. En ese caso, utiliza una de las siguientes opciones en su lugar:

   • la opción --uri con una cadena de conexión que no sea SRV (en el formato mongodb://)

   • la opción --host para especificar el host al cual conectarse directamente

2. Ejecute el comando completado desde una terminal o símbolo del sistema en un host que tenga acceso de red a su implementación de origen.

   Ejemplo

   El siguiente comando mongodump se conecta a un clúster Atlas Core de origen mediante una cadena de conexión SRV, que contiene el nombre de usuario (mySourceUsername) y la contraseña (mySourcePassword) de un usuario de base de datos con el rol backup en la base de datos admin. El comando genera un archivo comprimido del volcado en un archivo llamado mongodump.archive en el directorio de trabajo actual.

   mongodump --uri "mongodb+srv://mySourceUsername:mySourcePassword@cluster0.example.mongodb.net" \
             --archive="mongodump.archive"

Ejecutar mongorestore.

1. Ensamble el comando mongorestore.

   La siguiente plantilla de comando mongorestore se conecta a su clúster Atlas Infinite de destino utilizando su cadena de conexión y restaura el archivo creado por mongodump. Utiliza --nsExclude para excluir las bases de datos admin y config, que son administradas por Atlas.

   Copie la plantilla en su editor de texto preferido y reemplace los siguientes marcadores de posición con los valores apropiados:

   • <connectionString>Sustituya esto por la cadena de conexión SRV de su clúster Atlas Infinite de destino. Para obtener o crear una cadena de conexión para su clúster de destino, consulte Cadenas de conexión.

     Incluya el nombre de usuario y la contraseña de un usuario de base de datos con el rol Atlas admin en la cadena de conexión.

   • <filePath>: reemplace esto con la ruta al archivo de archivo creado por mongodump.

   Nota

   Si el nombre de usuario o la contraseña incluye los siguientes caracteres, deben convertirse mediante la codificación porcentual:

   $ : / ? # [ ] @

   mongorestore --uri "<connectionString>" \
                --archive="<filePath>" \
                --nsExclude "admin.*" \
                --nsExclude "config.*"

2. Ejecute el comando completado desde una terminal o símbolo del sistema en un host que tenga acceso al archivo de archivo creado por mongodump.

   Ejemplo

   El siguiente comando mongorestore se conecta a un clúster de Atlas Infinite mediante una cadena de conexión SRV, que contiene el nombre de usuario (myDestinationUsername) y la contraseña (myDestinationPassword) de un usuario de base de datos con el rol Atlas admin. El comando restaura el archivo ubicado en mongodump.archive creado por mongodump, excluyendo las bases de datos admin y config.

   mongorestore --uri "mongodb+srv://myDestinationUsername:myDestinationPassword@cluster0.example.mongodb.net" \
             --archive="mongodump.archive" \
             --nsExclude "admin.*" \
             --nsExclude "config.*"

Verificar la migración.

Una vez finalizada la migración, conéctese a su clúster de Atlas Infinite y verifique que los datos se hayan migrado correctamente. Puede ejecutar consultas para comprobar la presencia de sus colecciones y documentos en el clúster de destino.

Actualice sus aplicaciones para que apunten al clúster Atlas Infinite.

Tras verificar la migración, actualice sus aplicaciones para que se conecten al clúster de Atlas Infinite en lugar de a la implementación de origen. Asegúrese de utilizar la cadena de conexión y las credenciales correctas para el clúster de Atlas Infinite.

En Atlas, ve a la página Database & Network Access de tu proyecto.

1. Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.

2. Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.

3. En la barra lateral, haz clic en Database & Network Access en la sección Security.

La página de acceso a la base de datos y a la red se mostrará después de completar los pasos anteriores.

Configure un usuario de base de datos en el clúster Atlas de destino.

Para ejecutar mongoimport y escribir en un clúster de Atlas, debe especificar un usuario de base de datos con permisos de lectura y escritura en la base de datos a la que se importarán los datos. Por ejemplo, un usuario con el rol Atlas admin proporciona estos permisos.

Si no existe tal usuario, cree uno:

1. Si aún no se muestra, haz clic en la pestaña Database Users.

2. Haga clic en Add New Database User.

3. Agrega un usuario Atlas admin.

En Atlas, ve a la página Clusters de tu proyecto.

1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

3. En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

Haga clic en Connect.

Haz clic en Connect para el clúster de Atlas al que deseas migrar los datos.

Actualizar la lista de acceso IP.

Si el host donde vas a ejecutar mongoimport no está en la Lista de acceso IP, actualiza la lista. Puedes especificar uno de los dos:

• La dirección IP pública del servidor en el que mongoimport se ejecutará, o

• Si se configura para el emparejamiento VPC, se necesita el bloque CIDR (o una subred) de VPC del par o el Security Group de VPC del par, si has seleccionado AWS como el proveedor de nube.

Copie la URI del clúster de destino / información del host.

Puedes conectarte a tu clúster de Atlas utilizando su URI de cadena de conexión. En el cuadro de diálogo de conexión, realiza los siguientes pasos:

1. Haga clic en Drivers.

2. Copie la cadena de conexión encontrada en el paso 1.

3. Reemplace PASSWORD por la contraseña del usuario root y DATABASE por el nombre de la base de datos a la que desea conectarse.

   Importante

   Se debe escapar de cualquier instancia del carácter @ en el <PASSWORD> proporcionado. Por ejemplo, p@ssword debería ser p%40ssword.

Esta cadena de conexión se especifica en mongoimport en la opción --uri.

Cuando se utiliza --host, si el clúster de Atlas es un set de réplicas, también se debe recuperar el nombre del set de réplicas. Por ejemplo:

myAtlasRS/atlas-host1:27017,atlas-host2:27017,atlas-host3:27017

Ejecuta mongoimport.

Conéctese a su clúster Atlas Infinite.

Para ejecutar las operaciones de escritura masiva descritas en este procedimiento, conéctese a su clúster mediante mongosh. Para obtener más información, consulte Conectarse a un clúster de Atlas.

También puede ejecutar operaciones de escritura masiva desde el código de la aplicación con un controlador de MongoDB, desde la interfaz de usuario de Atlas o desde cualquier otra interfaz que se conecte a su clúster. Para obtener información sobre las operaciones equivalentes en cada interfaz, consulte Operaciones de escritura masiva.

Ejecutar la operación de escritura masiva.

Para escribir en una sola colección, ejecute bulkWrite(). Para obtener más información sobre los tipos de operaciones de escritura y las opciones de escritura masiva, consulte bulkWrite().

Por ejemplo, el siguiente comando inserta dos documentos en la colección inventory:

db.inventory.bulkWrite( [
   { insertOne: { document: {
      _id: ObjectId("68b1c2d3e4f5a6b7c8d9e0f1"),
      item: "notebook",
      qty: 50
   } } },
   { insertOne: { document: {
      _id: ObjectId("68b1c2d3e4f5a6b7c8d9e0f2"),
      item: "pencil",
      qty: 100
   } } }
] )

Para escribir en varias colecciones o bases de datos en una sola solicitud, ejecute bulkWrite() y especifique el espacio de nombres para cada operación. Por ejemplo, el siguiente comando inserta un documento en la colección sales.inventory y otro en la colección supplies.inventory:

db.getMongo().bulkWrite( [
   {
      namespace: "sales.inventory",
      name: "insertOne",
      document: { item: "notebook", qty: 50 }
   },
   {
      namespace: "supplies.inventory",
      name: "insertOne",
      document: { item: "pencil", qty: 100 }
   }
] )

De forma predeterminada, las operaciones de escritura masiva se ejecutan en orden y se detienen ante el primer error. Para obtener información sobre cómo configurar el orden de ejecución, consulte la sección Ejecución de operaciones.

Verifique los resultados.

Revise los recuentos que devuelve la operación y confirme la cantidad de documentos en cada colección de destino. Para obtener más información, consulte la sección Salida.

Para obtener información sobre cómo gestionar los errores en las operaciones de escritura masiva, consulte la sección Gestión de errores.