Para cargar sus propios datos en un clúster Atlas Infinite, utilice uno de los siguientes métodos:
mongodump y mongorestore:
mongodumpcrea una exportación binaria de los datos de un MongoDB autónomo o set de réplicas existente, incluido un clúster Atlas Core, ymongorestorecarga los datos en un clúster Atlas Infinite. Utilice este método cuando sus datos de origen estén en una implementación de MongoDB. Para aprender cómo, consulta restauración de datos de una implementación de MongoDB.mongoimport:
mongoimportcarga documentos desde un archivoJSONoCSVen un clúster Atlas Infinite. Utilice este método cuando sus datos de origen estén en un archivo externo a MongoDB. El archivo puede provenir demongoexporto de una herramienta de exportación de terceros. Para aprender cómo, consulte Importar datos de un archivo JSON o CSV.Operaciones de escritura masiva: Los métodos de base de datos de MongoDB guardan lotes de documentos en un clúster Atlas Infinite. Utilice este método cuando genere o transforme los documentos usted mismo desde una aplicación,
mongosh, Atlas Interfaz de Usuario, o desde otra interfaz. Para aprender cómo, consulte Guardar datos que genere.
Cada uno de estos métodos consume capacidad de guardar en el clúster Atlas Infinite de destino. Para limitar el efecto en sus aplicaciones, ejecute grandes cargas de datos durante el uso del sistema fuera de las horas pico o un periodo de mantenimiento programado.
Requisitos previos
Complete los siguientes requisitos previos:
Crea un clúster de Atlas Infinite de destino. Para aprender más, consulte Crear un clúster Atlas Infinite o Atlas Core.
Para usar
mongodump,mongorestoreomongoimport, instale la última versión estable de lanzamiento de MongoDB Database Tools en ese host. Para aprender cómo, consulte la guía de instalación de MongoDB Database Tools.
Restauración de datos de una implementación de MongoDB
mongodump crea una exportación binaria de un MongoDB autónomo o set de réplicas existente, y mongorestore carga esa exportación en un clúster Atlas Infinite. La exportación incluye datos, metadatos e índices de la implementación de origen. Para obtener orientación sobre cómo copiar datos desde un clúster particionado de MongoDB existente, consulta la solicitud de soporte.
También puede utilizar este procedimiento para migrar datos desde un clúster gratuito o un clúster Flex en Atlas Core a un clúster dedicado en Atlas Infinite. Para escalar un clúster gratuito o un clúster Flex in situ en lugar de migrar datos, consulte Escalar un clúster gratuito o un clúster Flex a un clúster dedicado.
Este procedimiento requiere tiempo de inactividad. Detenga las operaciones de guardar en su implementación de origen, ejecute mongodump y mongorestore, luego migre sus aplicaciones al clúster Atlas Infinite.
Considerations
Antes de ejecutar este procedimiento, tenga en cuenta los siguientes comportamientos:
Usuarios y roles: Atlas gestiona los usuarios de base de datos, por lo que
mongorestoreno puede migrar los usuarios o roles de base de datos existentes al clúster de destino. Cree los usuarios de base de datos que sus aplicaciones necesitan en el clúster Atlas Infinite de destino. Para aprender más, consulta Configurar usuarios de base de datos.namespaces excluidos: Los directorios
adminyconfigen el vaciado contienen información de usuario quemongorestoreno puede añadir a un clúster Atlas Infinite, por lo que el procedimiento excluyeadmin.*yconfig.*.Recursos del host:
mongodumpse ejecuta en un host con acceso a la red a su implementación de origen, ymongorestorese ejecuta en un host con acceso al fichero de archivo y acceso a la red a su implementación de destino. Ambas herramientas utilizan CPU y memoria en el host, lo que puede afectar el rendimiento de ese host.
Pasos
Configurar un usuario de base de datos en la implementación de origen.
Si la implementación de origen aplica la autenticación, mongodump debe autenticarse como un usuario de base de datos que pueda leer todas las bases de datos que migre. El rol de backup en la base de datos admin otorga estos privilegios.
Si no existe un usuario de este tipo en su implementación de origen, cree uno. Para aprender a crear y gestionar usuarios de base de datos, consulte la siguiente página para su tipo de implementación:
Para clústeres gestionados por Atlas, consultar Configurar usuarios de base de datos.
Para implementaciones autogestionadas, consulta Gestiona usuarios y roles en implementaciones autogestionadas.
Configure un usuario de base de datos en el clúster Atlas Infinite de destino.
mongorestore debe autenticarse como un usuario de base de datos que pueda guardar en cada base de datos que migre. El Atlas admin rol en el clúster Atlas Infinite de destino otorga estos privilegios.
Si no existe dicho usuario en su clúster Atlas Infinite de destino, créelo. Para aprender a crear y gestionar usuarios de bases de datos en Atlas, consulta Configurar usuarios de bases de datos.
Conceda acceso de red a su host a las implementaciones de origen y destino.
Asegúrese de que el host donde ejecute mongodump y mongorestore pueda acceder a ambas implementaciones:
Agregue el host a la lista de acceso IP para el Proyecto que contiene su clúster Atlas Infinite de destino. Para aprender cómo añadir un host a una lista de acceso IP, consulta Configurar entradas de la lista de acceso IP.
Si su implementación de origen es un clúster de Atlas Core en un Proyecto diferente, añada el host a la lista de acceso IP de ese Proyecto también. Si su implementación de origen es autogestionada, configure su firewall para aceptar conexiones del host. Para aprender más, consulte Reforzamiento de red y configuración.
Si configura el VPC emparejamiento, puede agregar el bloque CIDR de la VPC del par o una subred, o el grupo de seguridad de la VPC del par a la lista de acceso IP. Para obtener más información, consultar lista de acceso IP.
Ejecuta mongodump.
Ensamble el comando
mongodump.La siguiente plantilla de comando
mongodumpse conecta a un set de réplicas de origen o a un clúster autónomo mediante su cadena de conexión y genera un fichero del vaciado en un archivo.Copie la plantilla en su editor de texto preferido y reemplace el marcador de posición
<connectionString>por la cadena de conexión de su implementación de origen, y<fileName>por el nombre del fichero de archivo que desea crear.mongodump --uri "<connectionString>" --archive=<fileName>.archivePara aprender a construir una cadena de conexión para su implementación de origen, consulte Cadenas de conexión.
Nota
Si se usa
mongodumpomongorestoreen Ubuntu 18.04, puede que experimentes un mensaje de errorcannot unmarshal DNSal usar cadenas de conexión SRV (en la formamongodb+srv://) con la opción--uri. En ese caso, utiliza una de las siguientes opciones en su lugar:la opción
--uricon una cadena de conexión que no sea SRV (en el formatomongodb://)la opción
--hostpara especificar el host al cual conectarse directamente
Ejecute el comando completado desde un terminal o símbolo del sistema en un host que tenga acceso a la red a su implementación de origen.
Ejemplo
El siguiente comando
mongodumpse 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) para un usuario de base de datos con el rolbackupen la base de datosadmin. El comando genera un fichero del vaciado en el archivo con el nombremongodump.archiveen el directorio de trabajo actual.mongodump --uri "mongodb+srv://mySourceUsername:mySourcePassword@cluster0.example.mongodb.net" \ --archive="mongodump.archive"
Ejecuta mongorestore.
Ensamble el comando
mongorestore.La plantilla de comandos
mongorestoresiguiente se conecta a su clúster Atlas Infinite de destino mediante su cadena de conexión y realiza la restauración del fichero creado pormongodump. Utiliza--nsExcludepara excluir las bases de datosadminyconfigque Atlas gestiona.Copia la plantilla en tu editor de texto preferido y reemplaza los siguientes marcadores de posición con los valores adecuados:
<connectionString>: sustituya esto por la cadena de conexión SRV para su clúster Atlas Infinite de destino. Para recuperar o construir 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 adminen la cadena de conexión.<filePath>: reemplaza esto con la ruta al fichero archivo creado pormongodump.
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.*"Ejecute el comando completado desde un terminal o una línea de comandos en un host que tenga acceso al fichero archivo creado por
mongodump.Ejemplo
El siguiente comando
mongorestorese conecta a un clúster Atlas Infinite mediante una cadena de conexión SRV, que contiene el nombre de usuario (myDestinationUsername) y la contraseña (myDestinationPassword) para un usuario de base de datos con el rolAtlas admin. El comando realiza la restauración del fichero enmongodump.archivecreado pormongodump, excluyendo las bases de datosadminyconfig.mongorestore --uri "mongodb+srv://myDestinationUsername:myDestinationPassword@cluster0.example.mongodb.net" \ --archive="mongodump.archive" \ --nsExclude "admin.*" \ --nsExclude "config.*"
Se deben actualizar las aplicaciones para que apunten al clúster Atlas Infinite.
Después de verificar la migración, actualice sus aplicaciones para conectarse al clúster Atlas Infinite en lugar de la implementación de origen. Asegúrese de utilizar la cadena de conexión correcta y las credenciales para el clúster Atlas Infinite.
Importar datos desde un archivo JSON o CSV
mongoimport lee un archivo JSON o CSV e inserta cada registro en una colección en un clúster de Atlas Infinite. El archivo puede provenir de una herramienta de exportación de terceros. Para la restauración de datos de una implementación de MongoDB en un clúster Atlas Infinite, consulte Restauración de datos de una implementación de MongoDB.
Considerations
Antes de ejecutar este procedimiento, tenga en cuenta los siguientes comportamientos:
JSON extendido:
mongoimportutiliza representación de modo estricto para determinados BSON types.Solo documentos: A diferencia de
mongorestore,mongoimportcarga solo documentos, no opciones de colección ni definiciones de índice. Cree índices en el clúster de destino Atlas Infinite después de que finalice la importación.Recursos del host:
mongoimportse ejecuta en el host que contiene su archivo y utiliza la CPU y la memoria en ese host.Otras interfaces: Para cargar un archivo sin la línea de comandos, utilice MongoDB Compass, que importa archivos
JSONyCSV, o la Interfaz de Usuario de Atlas, que inserta documentosJSONque pegue o escriba.
Pasos
En Atlas, ve a la página Database & Network Access de tu proyecto.
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.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Database & Network Access en la sección Security.
La página Acceso a la base de datos y a la red se muestra después de completar los pasos anteriores.
Configure un usuario de base de datos en el clúster de Atlas de destino.
Para ejecutar mongoimport para guardar en un clúster de Atlas, debe especificar un usuario de base de datos que tenga privilegios de readWrite en la base de datos en la que importar datos. Por ejemplo, un usuario con el rol de Atlas admin proporciona estos privilegios.
Si no existe tal usuario, cree uno:
Si aún no se muestra, haz clic en la pestaña Database Users.
Haga clic en Add New Database User.
Agrega un usuario Atlas admin.
En Atlas, ve a la página Clusters de tu proyecto.
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.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
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
mongoimportse ejecutará, oSi 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.
Se debe copiar el URI del clúster de destino/la 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:
Haga clic en Drivers.
Copie la cadena de conexión encontrada en el paso 1.
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@ssworddebería serp%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:27017guardar datos que genera
Las operaciones de guardar masivas envían muchos guardados a un clúster Atlas Infinite en una sola solicitud, lo que reduce los viajes de ida y vuelta de la red y aumenta el rendimiento de guardar. Elija este método para guardar documentos que genere en un clúster Atlas Infinite, en lugar de copiar datos de una implementación o archivo existente.
Considerations
Antes de ejecutar este procedimiento, tenga en cuenta los siguientes comportamientos:
Comportamiento de escritura masiva: Las operaciones de escritura y las opciones que especifique en una solicitud de escritura masiva determinan cómo MongoDB ordena las operaciones de escritura, gestiona los errores y notifica los resultados para una solicitud. Para aprender cómo estas opciones afectan al comportamiento de la escritura masiva, consulte la página de referencia
bulkWrite().Otras interfaces: Para guardar un pequeño número de documentos sin lógica de agrupación, utilice
insertMany()oinsertOne()demongosho un driver de MongoDB, o la Interfaz de Usuario de Atlas, que insertaJSONdocumentos que pegue o escriba.
Pasos
Conéctese a su clúster Atlas Infinite.
Para ejecutar las operaciones de guardado masiva en este procedimiento, conéctese a su clúster con mongosh. Para aprender cómo, consulta 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 driver de MongoDB, desde la interfaz de usuario de Atlas o desde cualquier otra interfaz que se conecte a su clúster. Para aprender sobre las operaciones equivalentes en cada interfaz, consulte Operaciones de guardar masiva.
Ejecutar la operación de guardado masivo.
Para guardar en una sola colección, ejecute bulkWrite(). Para aprender más sobre los tipos de operaciones de guardar y las opciones de guardar masivas, 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 guardar en varias colecciones o bases de datos en una solicitud, ejecute bulkWrite() y especifique el namespace para cada operación. Por ejemplo, el siguiente comando inserta un documento en la colección sales.inventory y un documento 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 } }] )Por defecto, las operaciones de guardar masivas se ejecutan en orden y se detienen en el primer error. Para aprender a configurar el orden de ejecución, consulte Ejecución de operaciones.
Verifique los resultados.
Revise los recuentos que devuelve la operación y confirme el recuento de documentos en cada colección de destino. Para aprender más, consulta Salida.
Para aprender a gestionar errores para operaciones de guardar masiva, consulte Gestión de errores.
Limitaciones
Atlas Infinite tiene una lista completa de limitaciones de la vista previa pública en Disponibilidad de la vista previa pública. Se aplican las siguientes limitaciones al cargar datos en un clúster Atlas Infinite:
Sin reproducción de oplog: Atlas Infinite no admite la reproducción de oplog. No utilice la
mongodump --oplogopción o lamongorestore --oplogReplayopción con clústeres Atlas Infinite.Queryable Encryption y cifrado a nivel de campo del lado del cliente: No puede utilizar
mongodumpomongorestorecon una colección que utiliza Queryable Encryption o cifrado a nivel de campo del lado del cliente.Migración y restauración en vivo entre ediciones: Atlas Infinite no admite la migración en vivo ni la copia de seguridad y restauración entre clústeres de Atlas Core y Atlas Infinite. Las diferencias arquitectónicas entre las dos opciones de implementación hacen que los snapshot y las Migraciones en vivo sean incompatibles.