Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

Migración

Puedes migrar datos desde tus implementaciones on-premises de MongoDB a Atlas usando uno de diversos métodos. Recomendamos usar la migración en vivo de Atlas siempre que sea posible porque automatiza muchas de las tareas con el menor tiempo de inactividad, pero puedes usar otras herramientas que se ajusten a la variedad y complejidad inherentes a la migración de bases de datos.

La Migración en vivo de Atlas automatiza el traspaso de datos desde bases de datos MongoDB on-premises a Atlas. La Migración en vivo de Atlas incluye las siguientes funcionalidades:

  • El host de migración siempre cifra el tráfico hacia el clúster de Atlas. El tráfico hacia, desde y entre nodos de Atlas siempre está cifrado y esta funcionalidad no puede desactivarse. Solo los usuarios con roles específicos de control de acceso basado en roles (RBAC) de la base de datos (como backup, readAnyDatabase o clusterMonitor), así como el propietario del proyecto Atlas, pueden iniciar una migración en vivo. Los usuarios se autentican en los clústeres mediante SCRAM-SHA-1 o SCRAM-SHA-256.

  • La migración en vivo automatiza la mayoría de las tareas. Para el método totalmente gestionado de “extracción”, la migración en vivo supervisa métricas clave, proporciona los servidores de migración y realiza la secuenciación estricta de los comandos de migración. Además, también puedes seleccionar a qué configuraciones de nivel de clúster de Atlas Destination deseas migrar.

  • Las instrucciones detalladas le ayudarán a escalar clústeres de destino para controlar los costos. Las recomendaciones incluyen el tamaño adecuado de los clústeres y el escalado temporal, seguidas del reajuste a niveles óptimos tras la migración.

  • La migración en vivo utiliza Mongosync en segundo plano, lo que facilita una transición rápida mediante la copia de datos en paralelo. Los procesos gestionan las interrupciones temporales de la red y las elecciones de clúster, utilizando una sincronización continua de datos y una fase de cambio final para lograr un tiempo de inactividad mínimo. Los mecanismos de reintento y las validaciones previas a la migración mejoran la resiliencia ante interrupciones.

  • Supervisa migraciones con actualizaciones de estado en tiempo real y notificaciones.

Puedes hacer que un servidor de migración en vivo transfiera datos a Atlas. El método de Migración en vivo "pull" admite rutas de migración entre versiones específicas de MongoDB. Consulta Caminos de migración compatibles para obtener más información. Para migrar datos desde bases de datos que utilizan versiones no admitidas de MongoDB, consulta Migrar o importar datos o Métodos de migración manual.

  • Extrae datos en Atlas. Atlas extrae datos de la implementación MongoDB de origen y requiere acceso a la implementación de origen a través del firewall de la implementación. Cuando los clústeres estén completamente sincronizados, debe seguir el proceso de cambio de detener las operaciones de escritura en la fuente, redirigir las aplicaciones al clúster de Atlas y reiniciarlas. Se aplican las siguientes consideraciones:

    • Lo mejor para implementaciones que no están supervisadas por Cloud Manager ni Ops Manager.

    • La base de datos de origen debe ser públicamente accesible para permitir el acceso entrante desde el servidor de migración en vivo.

    • No admite emparejamiento de VPC ni con nodos privados para el clúster de origen o de destino.

    • Las topologías de los clústeres de origen y destino deben coincidir. Por ejemplo, ambos deben ser sets de réplicas o clústeres shardeados con el mismo número de particiones.

    • Planifica un tiempo de inactividad mínimo durante la transición, para detener las escrituras y reiniciar las aplicaciones con una nueva cadena de conexión. El proceso de migración requiere mucho uso de la CPU en el clúster de destino y requiere un ancho de banda de red significativo.

    • Para garantizar un proceso de migración sin problemas, confirma que el tamaño del oplog del clúster de origen es adecuado para cubrir toda la duración de la migración. Para el clúster de origen, la ventana de atraso de la migración en vivo debe mantenerse dentro de los límites de la ventana de atraso de la replicación del oplog. Se puede cumplir con este requisito aumentando la ventana mínima de oplog o aumentando el tamaño fijo de oplog. Para el clúster de destino, MongoDB recomienda que elegir un nivel de clúster de destino que esté al menos dos niveles por encima del clúster de origen mientras dure la migración. Si el escalado automático del almacenamiento está deshabilitado en el clúster de destino, aumenta el tamaño del oplog en el clúster de destino a un valor fijo lo suficientemente alto. Si el escalado automático del almacenamiento está habilitado en el clúster de destino, establece una oplog window mínima suficientemente alta en el clúster de destino. Consulta Requisitos de Oplog para obtener más información.

    • Para obtener recomendaciones e instrucciones completas sobre la migración, consulta Live migrar (Pull) un clúster a Atlas.

Para revisar tanto las migraciones en curso como las pasadas, navega a la página Migration Hub en Atlas.

Puedes hacer clic en cada proceso de migración para obtener información más detallada, incluyendo la estimación inicial del tiempo de copia de datos y los informes completos de progreso. Utiliza la tarjeta de clúster para crear, llevar a cabo o cancelar una migración.

Para saber más, consulta Supervisar migraciones.

Si la migración en vivo de Atlas no puede satisfacer las restricciones de tus requisitos de migración, puedes incorporar datos de despliegues existentes de MongoDB, JSON o CSV archivos en Atlas utilizando una de las siguientes herramientas que puedes ejecutar fuera de Atlas.

Herramienta
Descripción

El binario Mongosync es el proceso principal utilizado por la migración en vivo de Atlas. Puedes usar mongosync autónomo para migrar datos de un clúster a otro en Atlas. Atlas sincroniza los datos desde el origen al clúster de destino hasta que se transfieran las aplicaciones al clúster Atlas de destino.

Migra desde un set de réplicas de MongoDB a un clúster de Atlas sin apagar tu set de réplicas o aplicaciones existentes. mongomirror no importa datos de usuario/roles ni copia la base de datos config.

Seeding un clúster de Atlas con una copia de seguridad BSON de datos vaciado de mongodump, de una implementación existente de MongoDB. mongorestore no restaura los datos de la colección system.profile.

Cargar datos desde un archivo JSON o CSV en un clúster de Atlas. mongoimport utiliza una representación en modo estricto para ciertos BSON types. Ten en cuenta que el uso de mongoimport debe limitarse a pequeños conjuntos de datos con fines de prueba y/o desarrollo.

Utilice una GUI para cargar datos de un archivo JSON o CSV en un clúster Atlas. Ten en cuenta que el uso de MongoDB Compass debe limitarse a pequeños conjuntos de datos con fines de prueba y/o desarrollo.

También puedes restaurar los datos de una copia de seguridad de clúster de Atlas a otro clúster de Atlas. Para obtener más información, consulta Restaurar tu clúster.

Si se requiere utilizar el emparejamiento de VNet de Atlas o configuraciones de Private Link, no se quiere permitir una conexión directa de un tercero al clúster de origen, o si no se tiene ni desea importar el clúster de origen a Ops Manager o Cloud Manager, entonces MongoDB recomienda el enfoque autónomo de mongosync.

Si tienes conjuntos de datos relativamente pequeños (<300 GB) para migrar y puedes permitirte el lujo de un tiempo de inactividad de la aplicación durante un período de tiempo prolongado, MongoDB recomienda el enfoque de mongodump y mongorestore.

Si tienes conjuntos de datos relativamente pequeños (<300 GB) para migrar, no tienes problemas con los índices y puedes permitirte un tiempo de inactividad de la aplicación durante un período prolongado, entonces MongoDB recomienda el enfoque mongoexport y mongoimport.

Cuando una migración alcanza el estado "Ready for Cutover", haz clic en Cutover on target cluster seguido de Prepare to Cutover en la tarjeta del clúster para iniciar el proceso de corte. Tras completar correctamente la transición, reconfigure la aplicación para que apunte al nuevo clúster de destino.

Para saber más, consulta Supervisar migraciones.

Consulta la página Orientación para organizaciones, proyectos y agrupaciones de Atlas para aprender sobre los pilares de la infraestructura Atlas, o utiliza la navegación de la izquierda para encontrar funciones y mejores prácticas de cada pilar del Marco bien arquitectado.