Migrate data from PolarDB-X 1.0 to DataHub using DTS - Data Transmission Service

Utilice Data Transmission Service (DTS) para migrar datos de una instancia de PolarDB-X 1.0 a un proyecto de DataHub.

Requisitos previos

Cree una instancia de origen de PolarDB-X 1.0. Para obtener más información, consulte Create a PolarDB-X 1.0 instance.

Nota
La instancia de PolarDB-X 1.0 debe usar ApsaraDB RDS for MySQL como tipo de almacenamiento. Esto incluye tanto las instancias de RDS personalizadas de forma privada como las adquiridas por separado. PolarDB for MySQL no es compatible.
Active DataHub y cree un proyecto para recibir los datos migrados. Para obtener más información, consulte Quick start (synchronization example) y Manage projects.

Limitaciones

Tipo	Descripción
Limitaciones de la base de datos de origen	Si migra objetos a nivel de tabla y necesita editarlos, por ejemplo, al asignar nombres de columnas, una sola tarea de migración de datos admite un máximo de 1,000 tablas. Si supera este límite, el envío de la tarea fallará. En ese caso, divida las tablas en varias tareas de migración de datos o configure una tarea para migrar toda la base de datos. Para la migración incremental, se aplican los siguientes requisitos de registro binario: El registro binario debe estar habilitado y el parámetro `binlog_row_image` debe establecerse en `full`. De lo contrario, la comprobación previa falla y la tarea de migración de datos no puede iniciarse. Si su tarea incluye migración incremental, DTS requiere que la base de datos de origen conserve su registro binario local durante como mínimo 24 horas. Se recomienda un periodo de retención de 7 días. Si el periodo de retención es insuficiente, DTS podría no obtener el registro binario. Esto puede provocar que la tarea falle y, en casos extremos, generar inconsistencia o pérdida de datos. El SLA no cubre los problemas causados por un periodo de retención del registro binario inferior al requerido. DTS no admite la migración de datos desde instancias de solo lectura de PolarDB-X 1.0. Restricciones operativas en la base de datos de origen: Durante la migración de datos, no ejecute operaciones como escalar verticalmente, migrar tablas de acceso frecuente, cambiar claves de fragmentación ni ejecutar modificaciones DDL; de hacerlo, la migración de datos fallará. Nota Durante la fase de migración completa de datos, DTS consulta la base de datos de origen. Esto genera bloqueos de metadatos que pueden dificultar la ejecución de operaciones DDL en dicha base de datos. Durante la migración completa e incremental, DTS deshabilita temporalmente las comprobaciones de restricciones y las operaciones en cascada de claves foráneas a nivel de sesión. Si ocurren actualizaciones o eliminaciones en cascada en la base de datos de origen mientras la tarea se ejecuta, podría producirse inconsistencia de datos. Si solo ejecuta una migración completa de datos, no escriba datos nuevos en la base de datos de origen. De lo contrario, se producirá inconsistencia de datos entre las bases de datos de origen y de destino. Para mantener la consistencia de datos en tiempo real, seleccione la migración de esquema, la migración completa de datos y la migración incremental de datos. La instancia de origen de PolarDB-X 1.0 debe ser de la versión 5.2 o posterior. Mientras se ejecuta una tarea de migración de DTS, las tablas de difusión en la instancia de origen de PolarDB-X 1.0 no admiten cambios de tipo de tabla durante el proceso (por ejemplo, convertir una tabla de difusión en una tabla única o fragmentada). Si necesita cambiar el tipo de tabla, detenga primero la tarea de migración y vuelva a configurarla cuando finalice el cambio.
Otras limitaciones	Se admiten la migración de esquema, la migración completa y la migración incremental. La longitud máxima de un campo String individual en el DataHub de destino es de 2 MB. DTS depende de la continuidad de las transacciones XA dentro de la instancia de origen de PolarDB-X 1.0 para garantizar la consistencia de datos en las tareas de migración incremental. Si esta continuidad se interrumpe, por ejemplo, durante una conmutación por error del módulo de captura de datos incrementales, las transacciones XA no confirmadas podrían perderse. Antes de migrar los datos, evalúe el rendimiento de las bases de datos de origen y de destino. También se recomienda ejecutar la migración de datos fuera del horario de mayor actividad. De lo contrario, la carga de la base de datos podría aumentar. DTS intenta reanudar una tarea con errores en un plazo de siete días. Por lo tanto, antes de realizar el corte a la instancia de destino, debe finalizar o liberar la tarea. Como alternativa, revoque los permisos de escritura de la cuenta que DTS utiliza para acceder a la instancia de destino mediante el comando `revoke`. Esto evita que los datos de origen sobrescriban los datos de la instancia de destino si la tarea se reanuda automáticamente. Si una tarea presenta errores, el equipo de soporte de DTS intentará restaurarla en un plazo de ocho horas. Durante la restauración, es posible que reinicien la tarea o ajusten sus parámetros. Nota Solo se modifican los parámetros de la tarea de DTS, no los de la base de datos. Los parámetros que podrían ajustarse incluyen los que se enumeran en Modify instance parameters.
Consideraciones adicionales	DTS actualiza periódicamente la tabla `dts_health_check`.`ha_health_check` en la base de datos de origen para avanzar la posición del registro binario.

Facturación

Tipo de migración	Cargo por configuración de la instancia	Cargo por tráfico de Internet
Migración de esquema	Sin cargo.	Sin cargo.
Migración incremental	Aplican cargos. Para obtener más información, consulte Billing overview.	Sin cargo.

Tipos de migración

Migración de esquema

DTS migra las definiciones de esquema de los objetos desde la base de datos de origen hacia la base de datos de destino.
Migración incremental

DTS migra los cambios incrementales de datos desde la base de datos de origen hacia la de destino, lo que permite una migración fluida sin tiempo de inactividad.

Operaciones SQL compatibles

Tipo de operación	Instrucciones SQL
DML	INSERT, UPDATE, DELETE

Permisos de cuenta

Base de datos	Migración de esquema	Migración incremental
Instancia de PolarDB-X 1.0	Permiso SELECT	Permisos de lectura y escritura para los objetos de migración. Nota Para obtener información sobre cómo otorgar permisos, consulte Manage accounts.

Asignaciones de tipos de datos

Para obtener más información, consulte Data type mappings for schema migration.

Procedimiento

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ú 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, lea los Limits en la parte superior de la página para asegurarse de que la tarea de migración se ejecute correctamente.

Categoría	Configuración	Descripción
Configuración básica	Task Name	DTS genera automáticamente un nombre de tarea. Se recomienda especificar un nombre descriptivo para identificarla fácilmente. El nombre no necesita ser único.
Source Database	Select Existing Connection	Para usar una instancia de base de datos que ya se haya added to the system (creado o guardado), seleccione la instancia deseada en la lista desplegable. La información de la base de datos que aparece abajo se configura automáticamente. Nota En la consola de DMS, este parámetro se llama Select a DMS database instance.. Si no registró la instancia de base de datos en el sistema o no necesita usar una instancia registrada, configure manualmente la información de la base de datos que aparece abajo.
	Database Type	Seleccione PolarDB-X 1.0.
	Access Method	Seleccione Alibaba Cloud Instance.
	Instance Region	Seleccione la región donde se encuentra la instancia de PolarDB-X 1.0 de origen.
	Replicate Data Across Alibaba Cloud Accounts	Este ejemplo usa una migración dentro de la misma cuenta. Seleccione No.
	Instance ID	Seleccione el ID de la instancia de PolarDB-X 1.0 de origen.
	Database Account	Introduzca la cuenta de la base de datos para la instancia de PolarDB-X 1.0 de origen. Para conocer los requisitos de permisos, consulte Account permissions.
	Database Password	Introduzca la contraseña de la cuenta de la base de datos.
Destination Database	Select Existing Connection	Para usar una instancia de base de datos que ya se haya added to the system (creado o guardado), seleccione la instancia deseada en la lista desplegable. La información de la base de datos que aparece abajo se configura automáticamente. Nota En la consola de DMS, este parámetro se llama Select a DMS database instance.. Si no registró la instancia de base de datos en el sistema o no necesita usar una instancia registrada, configure manualmente la información de la base de datos que aparece abajo.
	Database Type	Seleccione DataHub.
	Access Method	Seleccione Alibaba Cloud Instance.
	Instance Region	Seleccione la región donde se encuentra el proyecto de DataHub de destino.
	Project	Seleccione el ID del proyecto de DataHub de destino.

Una vez completada la configuración, haga clic en Test Connectivity and Proceed en la parte inferior de la página.

Nota
Asegúrese de que los segmentos de direcciones IP del servicio DTS se agreguen de forma automática o manual a la configuración de seguridad de las bases de datos de origen y de destino. Esto permite 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.

Configuración	Descripción
Migration Types	Cuando migra datos de PolarDB-X 1.0 a DataHub, solo son compatibles Schema Migration y Incremental Data Migration. Seleccione los tipos de migración según sus necesidades. Nota Si selecciona Schema Migration, también se migran las claves externas de la base de datos de origen. Para garantizar la consistencia de los datos, no escriba datos nuevos en la instancia de origen durante la migración si no selecciona Incremental Data Migration.
Processing Mode for Existing Destination Tables	Precheck and Report Errors: comprueba si existe una tabla con el mismo nombre en la base de datos de destino. Si no existe dicha tabla, la comprobación previa se supera. Si existe una tabla con el mismo nombre, la comprobación previa reporta un error y la tarea de migración no inicia. Nota Si no puede eliminar ni renombrar fácilmente la tabla en la base de datos de destino, cambie su nombre en la base de datos de destino. Para obtener más información, consulte Schema, table, and column name mapping. Ignore Errors and Proceed: omite la comprobación de tablas con el mismo nombre en la base de datos de destino. Aviso Seleccionar Ignore Errors and Proceed puede provocar inconsistencias en los datos y representar riesgos para su negocio, como: Si las estructuras de las tablas son idénticas y los registros comparten una clave principal: Durante la migración incremental, Data Transmission Service (DTS) sobrescribe el registro en la base de datos de destino con el registro de la base de datos de origen. Si las estructuras de las tablas son diferentes, es posible que solo se migren algunas columnas de datos o que la migración falle con errores. Proceda con precaución.
Naming Rules of Additional Columns	DTS agrega columnas adicionales a las tablas de destino cuando migra a DataHub. Si estos nombres de columna entran en conflicto con columnas existentes, la migración falla con errores. Seleccione New Rule o Previous Rule según sus necesidades. Aviso Antes de seleccionar una regla, evalúe si pueden ocurrir conflictos de nombres entre las columnas adicionales y sus columnas existentes. Para obtener más información sobre las reglas y definiciones, consulte Additional column names and definitions.
Capitalization of Object Names in Destination Instance	Configure la política de uso de mayúsculas y minúsculas para los nombres de bases de datos, tablas y columnas en la instancia de destino. De forma predeterminada, se usa la política de DTS. También puede hacer coincidir la política predeterminada de la base de datos de origen o de destino. Para obtener más información, consulte Capitalization of object names in the destination instance.
Source Objects	En el cuadro Source Objects, haga clic en los objetos que desea migrar y luego haga clic en para moverlos al cuadro Selected Objects. Nota Seleccione los objetos que desea migrar a nivel de tabla. Si selecciona una base de datos completa, cualquier cambio para agregar o eliminar tablas en esa base de datos no se migrará al destino.
Selected Objects	Para cambiar el nombre de un solo objeto de migración en la instancia de destino, haga clic con el botón derecho 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 Usar la función de asignación de nombres de objetos puede provocar que la migración de objetos dependientes falle con errores. Para filtrar datos mediante una cláusula WHERE, haga clic con el botón derecho en una tabla dentro del cuadro Selected Objects y especifique la condición de filtro en el cuadro de diálogo que aparece. Para obtener más información, consulte Set filter conditions. Para seleccionar las operaciones SQL que desea migrar a nivel de base de datos o de tabla, haga clic con el botón derecho en un objeto dentro del cuadro Selected Objects y elija las operaciones deseadas.

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

Configuración	Descripción
Dedicated Cluster for Task Scheduling	De forma predeterminada, DTS programa las tareas en un clúster compartido. No necesita seleccionar uno. Si desea tareas más estables, adquiera un dedicated cluster para ejecutar las tareas de migración de DTS.
Retry Time for Failed Connections	Después de que inicia la tarea de migración, si la conexión con la base de datos de origen o de destino falla con errores, DTS reporta un error e intenta restablecer la conexión de inmediato. La duración predeterminada de reintentos es de 720 minutos. Puede personalizar el tiempo de reintento con un valor de 10 a 1440 minutos. Se recomienda establecer una duración mayor a 30 minutos. Si DTS se reconecta 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 con errores. Nota Para varias instancias de DTS que comparten el mismo origen o destino, el tiempo de reintento de red se determina según la configuración de la última tarea creada. Dado que se le cobra por la tarea durante el periodo de reintento de conexión, se recomienda personalizar el tiempo de reintento según sus necesidades de negocio. También puede 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 inicia la tarea de migración, si ocurre un problema distinto a la conectividad en la base de datos de origen o de destino (como una excepción al ejecutar DDL o DML), DTS reporta un error e intenta repetir la operación de inmediato. La duración predeterminada de reintentos es de 10 minutos. Puede personalizar el tiempo de reintento con un valor de 1 a 1440 minutos. Se recomienda establecer una duración mayor a 10 minutos. Si las operaciones correspondientes 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 con errores. Importante El valor de Retry Time for Other Issues debe ser menor que el valor de Retry Time for Failed Connections.
Enable Throttling for Incremental Data Migration	Si lo requiere, 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. No es obligatorio para este tutorial.
Configure ETL	Elija si desea habilitar la función de extracción, transformación y carga (ETL). Para obtener más información, consulte What is ETL? Valores válidos: Yes: habilita la función ETL. Introduzca las instrucciones de procesamiento de datos en el editor de código. Para obtener más información, consulte Configure ETL in a data migration or data synchronization task. No: deshabilita la función ETL.
Monitoring and Alerting	Seleccione si desea configurar alertas y recibir notificaciones de alerta según sus necesidades de negocio. No: no configura ninguna alerta. Yes: configura alertas al establecer un alert threshold y un alert notifications. Si una migración falla con errores o la latencia supera el umbral, el sistema envía una notificación de alerta.

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 inicie la tarea de migración, DTS ejecuta una comprobación previa. La tarea inicia solo después de superar esta comprobación.
- Si la comprobación previa falla con errores, haga clic en View Details junto al elemento que falló, corrija el problema según 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 que falló, corrija el problema según 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 representar riesgos para su negocio.

Adquiera la instancia de migración.

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. Seleccione una especificación según su escenario de negocio. 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.

Consulte 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 total. 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 la tarea de migración incremental se ejecuta, el Status de la tarea es Running.