Migrate data from a MongoDB Atlas database to Alibaba Cloud - Data Transmission Service

Puede usar Data Transmission Service (DTS) para migrar datos de una base de datos MongoDB Atlas a ApsaraDB for MongoDB. Si selecciona la migración de datos completa e incremental, completará la migración sin tiempo de inactividad.

Requisitos previos

La instancia de ApsaraDB for MongoDB debe tener como mínimo un 10 % más de espacio de almacenamiento que la base de datos MongoDB Atlas.

Notas

Durante la migración completa de datos, DTS consume recursos tanto en la base de datos de origen como en la de destino. Esto aumenta la carga del servidor. Si su base de datos tiene una carga de trabajo alta o especificaciones de servidor limitadas, el rendimiento puede degradarse o producirse interrupciones del servicio. Se recomienda ejecutar la migración de datos en horarios de baja demanda.
DTS no admite la migración de las bases de datos admin y local.
La base de datos config es una base de datos interna del sistema. No la migre a menos que tenga requisitos específicos.
Para obtener información sobre las versiones y los motores de almacenamiento compatibles con ApsaraDB for MongoDB, consulte MongoDB versions and storage engines. Si migra datos entre distintas versiones o motores de almacenamiento, compruebe la compatibilidad antes de empezar.
DTS escribe datos de forma concurrente, por lo que la base de datos de destino requiere entre un 5 % y un 10 % más de espacio de almacenamiento que la base de datos de origen.
Para evitar la pérdida de datos, asegúrese de que ningún documento de la base de datos de destino tenga claves primarias que entren en conflicto con las de la base de datos de origen. La clave primaria predeterminada es _id. Elimine de la base de datos de destino cualquier documento con claves primarias en conflicto antes de iniciar la migración. Asegúrese de que esta eliminación no afecte sus servicios.

Facturación

Tipo de migración	Cargo por configuración de la instancia	Cargo por tráfico de Internet
Migración completa de datos	Gratuita.	Se aplican cargos al migrar datos desde Alibaba Cloud a través de Internet. Para obtener más información, consulte billing overview.
Migración incremental de datos	De pago. Para obtener más información, consulte billing overview.

Tipos de migración

Tipo de migración	Descripción
Migración completa de datos	DTS migra todos los datos históricos de los objetos requeridos desde la base de datos MongoDB de origen hacia la base de datos MongoDB de destino. Nota A continuación se muestran los tipos de objetos compatibles: base de datos, colección e índice.
Migración incremental de datos	Una vez finalizada la migración completa de datos, DTS sincroniza los datos incrementales desde la base de datos MongoDB de origen hacia la base de datos MongoDB de destino. Nota Se pueden sincronizar las operaciones de creación y eliminación ejecutadas en bases de datos, colecciones e índices. Se pueden sincronizar las operaciones de creación, eliminación y actualización ejecutadas en documentos.

Permisos obligatorios para las cuentas de base de datos

Base de datos	Migración completa de datos	Migración incremental de datos
Base de datos MongoDB Atlas	El permiso `read` sobre la base de datos de origen y el permiso `listDatabases`.	El permiso `read` sobre la base de datos de origen, la base de datos `admin` y la base de datos `local`. El permiso `listDatabases`.
Instancia de ApsaraDB for MongoDB	El permiso `readWrite` sobre la base de datos de destino.	El permiso `readWrite` sobre la base de datos de destino.

Para obtener información sobre cómo crear una cuenta de base de datos y otorgar permisos, consulte los siguientes temas:

Base de datos MongoDB Atlas: Instrucciones para crear usuarios en MongoDB.
Instancia de ApsaraDB for MongoDB: Use DMS to manage database accounts.

Antes de empezar

Inicie sesión en la consola de MongoDB Atlas.
En el panel de navegación izquierdo, haga clic en Network Access.
En la pestaña IP access list, haga clic en Add IP Address.
Agregue a la lista de permitidos de IP las direcciones IP del servicio DTS correspondientes a su región. Para obtener más información, consulte Add IP access list entries y Add DTS server IP addresses to an allowlist.

Nota
Este paso otorga a DTS acceso a su base de datos MongoDB Atlas. Elimine la regla cuando finalice la migración.

Procedimiento (nueva consola)

Vaya a la página de la lista de tareas de migración de la región de destino con uno de los métodos a continuación.
Desde la consola de DTS
1. Inicie sesión en la consola de Data Transmission Service (DTS).
2. En el panel de navegación izquierdo, haga clic en Data Migration.
3. En la esquina superior izquierda de la página, seleccione la región donde se encuentra la instancia de migración.
Desde la consola de DMS

Nota
Las operaciones reales pueden variar según el modo y el diseño de la consola de DMS. Para obtener más información, consulte Simple mode console y Customize the layout and style of the DMS console.
1. Inicie sesión en la consola de Data Management (DMS).
2. En la barra de menús superior, elija Data + AI > Data Transmission (DTS) > Data Migration.
3. A la derecha de Data Migration Tasks, seleccione la región donde se encuentra la instancia de migración.
Haga clic en Create Task para ir a la página de configuración de la tarea.

Configure las bases de datos de origen y de destino.

Aviso

Después de seleccionar las instancias de origen y de destino, le recomendamos leer detenidamente los límites que se muestran en la parte superior de la página. De lo contrario, la tarea podría fallar o producirse inconsistencias en los datos.

Categoría	Parámetro	Descripción
N/A	Task Name	DTS genera automáticamente un nombre de tarea. Le recomendamos especificar un nombre descriptivo para identificarla fácilmente. No es obligatorio que el nombre sea único.
Source Database	Select a DMS database instance.	Puede elegir si desea usar una instancia existente, según sus necesidades. Si usa una instancia existente, la información de la base de datos que aparece a continuación se completa automáticamente. No necesita introducirla de nuevo. Si no usa una instancia existente, debe configurar la información de la base de datos que aparece a continuación. Nota En la consola de DMS, puede hacer clic en Add DMS Database Instance para registrar una base de datos en DMS. Para obtener más información, consulte ApsaraDB Data Ingestion y Register a database hosted on a third-party cloud service or a self-managed database. En la consola de DTS, puede registrar una base de datos en DTS desde la página Database Connections o desde la nueva página de configuración. Para obtener más información, consulte Manage database connections.
	Database Type	Seleccione MongoDB.
	Access Method	Seleccione Public IP Address.
	Instance Region	Seleccione la región de la base de datos de MongoDB Atlas. Nota Si la región de la base de datos no aparece en la lista, seleccione la región geográficamente más cercana.
	Architecture	Seleccione Replica Set.
	Domain Name or IP	Introduzca el endpoint del nodo PRIMARY en la base de datos de MongoDB Atlas. Nota Puede obtener el endpoint en la consola de MongoDB Atlas.
	Port	Introduzca el puerto de servicio de la base de datos de MongoDB Atlas. El valor predeterminado es 27017.
	Authentication Database	Introduzca el nombre de la base de datos de autenticación donde se creó la cuenta de la base de datos.
	Database Account	Introduzca la cuenta de la base de datos de MongoDB Atlas. Para obtener más información sobre los permisos obligatorios, consulte Permissions required for database accounts.
	Database Password	Introduzca la contraseña de la cuenta de la base de datos.
	Connection Method	Seleccione Mongo Atlas SSL.
Destination Database	Select a DMS database instance.	Puede elegir si desea usar una instancia existente, según sus necesidades. Si usa una instancia existente, la información de la base de datos que aparece a continuación se completa automáticamente. No necesita introducirla de nuevo. Si no usa una instancia existente, debe configurar la información de la base de datos que aparece a continuación. Nota En la consola de DMS, puede hacer clic en Add DMS Database Instance para registrar una base de datos en DMS. Para obtener más información, consulte ApsaraDB Data Ingestion y Register a database hosted on a third-party cloud service or a self-managed database. En la consola de DTS, puede registrar una base de datos en DTS desde la página Database Connections o desde la nueva página de configuración. Para obtener más información, consulte Manage database connections.
	Database Type	Seleccione MongoDB.
	Access Method	Seleccione Cloud instance.
	Instance Region	Seleccione la región de la instancia de ApsaraDB for MongoDB de destino.
	Architecture	Seleccione un tipo de arquitectura según sus requisitos empresariales. Valores válidos: Replica Set: las instancias de conjunto de réplicas usan varios tipos de nodos para implementar alta disponibilidad y división de lectura y escritura. Para obtener más información, consulte Replica set instances. Sharded Cluster: una instancia de clúster fragmentado consta de tres tipos de componentes: nodos mongos, shard y Configserver. Puede personalizar la configuración y la cantidad de nodos mongos y shard. Para obtener más información, consulte Sharded cluster instances.
	Instance ID	Seleccione el ID de la instancia de ApsaraDB for MongoDB de destino.
	Authentication Database	Introduzca el nombre de la base de datos de autenticación donde se creó la cuenta de la base de datos. Nota Si usa la cuenta root, el nombre de la base de datos correspondiente es admin.
	Database Account	Introduzca la cuenta de la instancia de MongoDB de Alibaba Cloud de destino. Para obtener más información sobre los permisos obligatorios, consulte Permissions required for database accounts.
	Database Password	Introduzca la contraseña de la cuenta de la base de datos.

Una vez completada la configuración, haga clic en Test Connectivity and Proceed en la parte inferior de la página. En el cuadro de diálogo CIDR Blocks of DTS Servers que aparece, haga clic en Test Connectivity.

Nota
Asegúrese de que los segmentos de dirección IP del servicio DTS se agreguen automática o manualmente a la configuración de seguridad de las bases de datos de origen y de destino para permitir el acceso desde los servidores de DTS. Para obtener más información, consulte Add DTS server IP addresses to a whitelist.

Configure los objetos de la tarea.

En la página Configure Objects, configure los objetos que desea migrar.

Parámetro	Descripción
Migration Types	Si solo necesita ejecutar una migración completa, seleccione Schema Migration y Full Data Migration. Para ejecutar una migración sin tiempo de inactividad, seleccione Schema Migration, Full Data Migration y Incremental Data Migration. Nota Si no selecciona Schema Migration, asegúrese de que exista una base de datos y tablas para recibir los datos en la base de datos de destino. También puede usar la función de asignación de nombres de objetos en el cuadro Selected Objects según sus necesidades. Si no selecciona Incremental Data Migration, no escriba datos nuevos en la instancia de origen durante la migración de datos para garantizar la coherencia de los datos.
Processing Mode of Conflicting Tables	Precheck and Report Errors: comprueba si la base de datos de destino contiene colecciones con los mismos nombres que las colecciones de la base de datos de origen. Si las bases de datos de origen y de destino no contienen colecciones con nombres idénticos, la comprobación previa se supera. De lo contrario, se devuelve un error durante la comprobación previa y no se puede iniciar la tarea de sincronización de datos. Nota Puede usar la función de asignación de nombres de objetos para cambiar el nombre de las colecciones que se sincronizan con la base de datos de destino. Utilice esta función si las bases de datos de origen y de destino contienen nombres de colección idénticos y las colecciones de la base de datos de destino no se pueden eliminar ni renombrar. Para obtener más información, consulte Rename synchronized objects in the destination instance. Ignore Errors and Proceed: omite la comprobación previa de nombres de colección idénticos en las bases de datos de origen y de destino. Aviso Si selecciona Ignore Errors and Proceed, podrían producirse inconsistencias en los datos y su negocio quedaría expuesto a riesgos potenciales. DTS no sincroniza registros de datos que tengan los mismos valores de clave principal que los registros de la base de datos de destino. Los datos podrían no inicializarse, solo se sincronizarían algunas columnas o la tarea de sincronización de datos fallaría.
Capitalization of Object Names in Destination Instance	Puede configurar la directiva de distinción entre mayúsculas y minúsculas para los nombres en inglés de los objetos de base de datos y colección que se sincronizan con la instancia de destino. Puede seleccionar la DTS default policy, que es la opción predeterminada, o usar las directivas predeterminadas de la base de datos de origen o de destino. Para obtener más información, consulte Case sensitivity policy for destination object names.
Source Objects	Seleccione uno o más objetos en la sección Source Objects. Haga clic en el icono y agregue los objetos a la sección Selected Objects. Nota Puede seleccionar objetos con granularidad de bases de datos o de colecciones.
Selected Objects	Para cambiar el nombre de un solo objeto de migración en la instancia de destino, haga clic con el botón secundario en el objeto dentro del cuadro Selected Objects. Para obtener más información, consulte Map individual schema, table, and column names. Para cambiar los nombres de varios objetos de migración en la instancia de destino, haga clic en Selected Objects en la esquina superior derecha del cuadro Batch Edit. Para obtener más información, consulte Map multiple schema, table, and column names. Nota Si usa la función de asignación de nombres de objetos para cambiar el nombre de un objeto, otros objetos que dependan de él podrían no migrarse correctamente. Para especificar condiciones WHERE que filtren datos, haga clic con el botón secundario en un objeto dentro del cuadro Selected Objects. En el cuadro de diálogo que aparece, especifique las condiciones. Para obtener más información, consulte Set filter conditions.

Haga clic en Next: Advanced Settings para configurar los parámetros avanzados.

Parámetro	Descripción
Retry Time for Failed Connections	Después de que se inicia la tarea de migración, si falla la conexión con la base de datos de origen o de destino, DTS reporta un error y comienza inmediatamente a reintentar la conexión. La duración predeterminada de reintento es de 720 minutos. Puede personalizar el tiempo de reintento con un valor de 10 a 1440 minutos. Se recomienda establecer una duración superior a 30 minutos. Si DTS se vuelve a conectar a las bases de datos de origen y de destino dentro de la duración especificada, la tarea de migración se reanuda automáticamente. De lo contrario, la tarea falla. Nota Para varias instancias de DTS que comparten el mismo origen o destino, el tiempo de reintento de red lo determina la configuración de la última tarea creada. Dado que se le cobra por la tarea durante el periodo de reintento de conexión, le recomendamos personalizar el tiempo de reintento según sus necesidades empresariales o liberar la instancia de DTS lo antes posible después de liberar las instancias de las bases de datos de origen y de destino.
Retry Time for Other Issues	Después de que se inicia la tarea de migración, si ocurre un problema distinto al de conectividad en la base de datos de origen o de destino, como una excepción en la ejecución de DDL o DML, DTS reporta un error y comienza inmediatamente a reintentar la operación. La duración predeterminada de reintento es de 10 minutos. Puede personalizar el tiempo de reintento con un valor de 1 a 1440 minutos. Se recomienda establecer una duración superior a 10 minutos. Si las operaciones relacionadas se ejecutan correctamente dentro de la duración de reintento especificada, la tarea de migración se reanuda automáticamente. De lo contrario, la tarea falla. Importante El valor de Retry Time for Other Issues debe ser menor que el valor de Retry Time for Failed Connections.
Enable Throttling for Full Data Migration	Durante la migración completa, DTS consume recursos de lectura y escritura en las bases de datos de origen y de destino, lo que puede aumentar la carga de la base de datos. Si es necesario, puede habilitar la limitación de velocidad para la tarea de migración completa. Puede establecer Queries per second (QPS) to the source database, RPS of Full Data Migration y Data migration speed for full migration (MB/s) para reducir la carga en la base de datos de destino. Nota Este elemento de configuración solo está disponible si selecciona Full Data Migration en Migration Types. También puede adjust the full migration speed después de que la instancia de migración esté en ejecución.
Enable Throttling for Incremental Data Migration	Si es necesario, también puede establecer límites de velocidad para la tarea de migración incremental. Configure RPS of Incremental Data Migration y Data migration speed for incremental migration (MB/s) para reducir la carga en la base de datos de destino. Nota Este elemento de configuración solo está disponible si selecciona Incremental Data Migration en Migration Types. También puede adjust the incremental migration speed después de que la instancia de migración esté en ejecución.
Environment Tag	Seleccione una etiqueta de entorno para identificar la instancia. En este ejemplo, no se requiere ninguna etiqueta.
Configure ETL	Según sus necesidades empresariales, seleccione si desea configurar ETL feature para procesar datos. Yes: configura la función ETL. También debe introducir data processing statements en el cuadro de texto. No: no configura la función ETL.
Monitoring and Alerting	Seleccione si desea configurar alertas y recibir notificaciones de alerta según sus necesidades empresariales. No: no configura ninguna alerta. Yes: configure las alertas estableciendo un alert threshold y alert notifications. Si una migración falla o la latencia supera el umbral, el sistema envía una notificación de alerta.

Haga clic en Next: Data Validation para configurar una tarea de validación de datos.

Para obtener más información sobre la función de validación de datos, consulte Configure data validation.

Guarde la tarea y ejecute una comprobación previa.
- Para consultar los parámetros de configuración de esta instancia cuando llame a la operación de API, coloque el puntero sobre el botón Next: Save Task Settings and Precheck y haga clic en Preview OpenAPI parameters en la burbuja que aparece.
- Si no necesita consultar los parámetros de API o ya terminó de revisarlos, haga clic en Next: Save Task Settings and Precheck en la parte inferior de la página.
Nota
- Antes de que comience la tarea de migración, DTS ejecuta una comprobación previa. La tarea se inicia únicamente después de superar dicha comprobación.
- Si la comprobación previa falla, haga clic en View Details junto al elemento con errores, corrija el problema siguiendo las indicaciones y vuelva a ejecutar la comprobación previa.
- Si se reporta una advertencia durante la comprobación previa:
  
  Para los elementos de comprobación que no se pueden ignorar, haga clic en View Details junto al elemento con errores, corrija el problema siguiendo las indicaciones y vuelva a ejecutar la comprobación previa.
  
  Para los elementos de comprobación que se pueden ignorar, haga clic en Confirm Alert Details, Ignore, OK y Precheck Again para omitir el elemento de advertencia y volver a ejecutar la comprobación previa. Si decide ignorar una advertencia, podrían surgir problemas como inconsistencias en los datos y generar riesgos para su negocio.

Adquiera la instancia.

Cuando Success Rate sea del 100 %, haga clic en Next: Purchase Instance.

En la página Purchase, seleccione la especificación de enlace para la instancia de migración de datos. Para obtener más información, consulte la tabla a continuación.

Categoría	Parámetro	Descripción
New Instance Class	Resource Group Settings	Seleccione el resource group al que pertenece la instancia. El valor predeterminado es default resource group. Para obtener más información, consulte What is resource management?
New Instance Class	Instance Class	DTS ofrece especificaciones de migración con distintos niveles de rendimiento. La especificación de enlace afecta la velocidad de migración. Puede seleccionar una especificación según su escenario empresarial. Para obtener más información, consulte Data migration link specifications.

Una vez completada la configuración, lea y seleccione Data Transmission Service (Pay-as-you-go) Service Terms.
Haga clic en Buy and Start. En el cuadro de diálogo OK que aparece, haga clic en OK.

Puede consultar el progreso de la tarea de migración en la página de lista Data Migration Tasks.
Nota
- Si la tarea de migración no incluye migración incremental, se detiene automáticamente después de completar la migración completa. Una vez detenida, su Status cambia a Completed.
- Si la tarea de migración incluye migración incremental, no se detiene automáticamente. La tarea de migración incremental continúa ejecutándose. Mientras se ejecuta, el Status de la tarea es Running.

Procedimiento (consola anterior)

Adquiera una instancia de migración de datos. Para obtener más información, consulte Purchase a DTS instance.
Inicie sesión en la consola de DTS.

Nota
Si el sistema lo redirige automáticamente a la consola de Data Management (DMS), haga clic en el icono en la esquina inferior derecha y luego haga clic en para volver a la consola clásica de DTS.
En el panel de navegación izquierdo, haga clic en Data Migration.
En la parte superior de la página Migration Tasks, seleccione la región donde se encuentra la instancia de destino de ApsaraDB for MongoDB.
Busque la instancia de migración de datos que adquirió y haga clic en Configure Data Migration Task.