Migrate data from PolarDB for MySQL to PolarDB-X 2.0 - Data Transmission Service

Data Transmission Service (DTS) admite la migración de datos desde un clúster de PolarDB for MySQL hacia una instancia de PolarDB-X 2.0.

Requisitos previos

Se creó una instancia de PolarDB-X 2.0.
La instancia de PolarDB-X 2.0 debe tener más espacio de almacenamiento disponible que el espacio ocupado por el clúster de PolarDB for MySQL.

Notas de uso

Nota

DTS migra las claves externas durante la migración del esquema.
Durante la migración completa e incremental de datos, DTS deshabilita temporalmente las comprobaciones de restricciones y las cascadas de claves externas a nivel de sesión. Las actualizaciones o eliminaciones en cascada sobre la base de datos de origen mientras se ejecuta la tarea pueden provocar inconsistencias en los datos.

Tipo	Descripción
Límites de la base de datos de origen	El servidor que aloja la base de datos de origen debe contar con suficiente ancho de banda de salida. De lo contrario, se verá afectada la velocidad de migración de datos. Las tablas que se van a migrar deben tener una clave primaria o una restricción UNIQUE, y los campos de dicha clave o restricción deben ser únicos. En caso contrario, podrían aparecer datos duplicados en la base de datos de destino. Si migra datos a nivel de tabla y necesita editar las tablas, por ejemplo, para asignar nombres de columnas, una sola tarea de migración de datos puede migrar un máximo de 1000 tablas. Si supera este límite, se reportará un error después de enviar la tarea. En ese caso, divida las tablas en varias tareas de migración o configure una tarea para migrar toda la base de datos. Si ejecuta una migración incremental: Debe habilitar el registro binario y establecer el parámetro loose_polar_log_bin en on. De lo contrario, la comprobación previa reportará un error y la tarea de migración de datos no podrá iniciarse. Para obtener más información sobre cómo habilitar el registro binario y modificar parámetros, consulte Enable binary logging y Modify parameters. Nota Habilitar el registro binario para un clúster de PolarDB for MySQL consume espacio de almacenamiento y genera cargos por dicho concepto. Los registros binarios del clúster de PolarDB for MySQL deben conservarse como mínimo 3 días. Se recomienda un periodo de retención de 7 días. De lo contrario, DTS podría no obtener los registros binarios, lo cual provocaría que la tarea fallara. En casos extremos, esto puede generar inconsistencia o pérdida de datos. Los problemas derivados de un periodo de retención de registros binarios inferior al requerido por DTS no están cubiertos por el acuerdo de nivel de servicio (SLA) de DTS. Nota Para obtener más información sobre cómo establecer el periodo de retención de los registros binarios de un clúster de PolarDB for MySQL, consulte Modify the retention period. Límites operativos de la base de datos de origen: Durante la migración completa de datos, no ejecute operaciones DDL que modifiquen el esquema de la base de datos o de las tablas. De lo contrario, la tarea de migración de datos fallará. Nota Durante la migración completa de datos, DTS consulta la base de datos de origen. Esto genera un bloqueo de metadatos que podría impedir las operaciones DDL en dicha base de datos. Si solo ejecuta la migración completa de datos, no escriba datos nuevos en la instancia de origen. De lo contrario, se producirá una inconsistencia de datos entre el origen y el destino. Para mantener la consistencia de los datos en tiempo real, seleccione tanto la migración completa como la incremental. No se admite la migración incremental de operaciones DDL. Si necesita ejecutar una operación DDL, hágalo primero en la base de datos de destino y luego en la de origen.
Notas	Si la base de datos de origen utiliza operaciones DDL en línea con modo de tabla temporal —incluidos escenarios de fusión de varias tablas— o agrega índices basados en funciones a columnas de clave única, podría producirse pérdida de datos o un fallo de la tarea en la base de datos de destino. Si ocurre un conflicto de clave primaria o clave única durante la migración: Si los esquemas de las tablas son consistentes y un registro de la base de datos de destino tiene el mismo valor de clave primaria que un registro de la base de datos de origen: Durante la migración completa, DTS conserva el registro en la base de datos de destino. El registro de la base de datos de origen no se migra. Durante la migración incremental, DTS no conserva el registro en la base de datos de destino. El registro de la base de datos de origen sobrescribe el registro de la base de datos de destino. Si los esquemas de las tablas son inconsistentes, es posible que solo se migren algunas columnas de datos o que la migración falle. Proceda con precaución. DTS no admite la migración de nodos de solo lectura de la instancia de origen de PolarDB for MySQL. DTS no admite la migración de tablas externas de OSS desde la instancia de origen de PolarDB for MySQL. No se admite la migración de datos de tipo VECTOR. DTS no admite escenarios de conmutación entre principal y en espera para la instancia de base de datos durante la migración completa de datos. Si se presenta esta situación, vuelva a configurar la tarea de migración de inmediato. Antes de migrar los datos, evalúe el rendimiento de las bases de datos de origen y de destino. Se recomienda ejecutar la migración de datos en horarios de menor actividad. Durante la migración completa, DTS consume recursos de lectura y escritura tanto en la base de datos de origen como en la de destino, lo cual puede aumentar la carga de ambas. La migración completa de datos implica operaciones INSERT simultáneas, lo que provoca fragmentación de tablas en la base de datos de destino. Como resultado, el espacio de almacenamiento de las tablas en la base de datos de destino será mayor que el de la instancia de origen una vez finalizada la migración completa. Compruebe que la precisión de migración de las columnas con tipo de datos FLOAT o DOUBLE cumpla con los requisitos de su negocio. DTS lee los valores de estas columnas mediante `ROUND(COLUMN,PRECISION)`. Si la precisión no está definida explícitamente, DTS utiliza una precisión predeterminada de 38 para FLOAT y de 308 para DOUBLE. DTS intenta recuperar las tareas con errores durante siete días. Antes de cambiar sus cargas de trabajo a la instancia de destino, debe finalizar o liberar la tarea. Como alternativa, revoque los permisos de escritura de la cuenta de base de datos 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 recupera automáticamente. DTS ejecuta periódicamente el comando CREATE DATABASE IF NOT EXISTS `test` en la base de datos de origen para avanzar el desplazamiento del registro binario. Si una tarea falla, el personal 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 parámetros de la base de datos. Entre los parámetros que podrían ajustarse se incluyen los que aparecen en Modify instance parameters.

Facturación

Tipo de migración	Cargo por configuración de la instancia	Cargo por tráfico de Internet
Migración de esquema y migración completa de datos	Sin cargo.	Cuando el parámetro Access Method de la base de datos de destino se establece en Public IP Address, se le cobrará por el tráfico de Internet. Para obtener más información, consulte Billing overview.
Migración incremental de datos	Con cargo. Para obtener más información, consulte Billing overview.

Tipos de migración

Migración de esquema

Data Transmission Service (DTS) migra las definiciones de esquema de los objetos de migración desde la base de datos de origen hacia la base de datos de destino.
- DTS admite la migración de esquemas para tablas, vistas, desencadenadores, procedimientos almacenados y funciones.
  
  Nota
  No se modifica el routine_body de los procedimientos almacenados, el routine_body de las funciones ni el select_statement de las vistas.
- Durante la migración del esquema, DTS cambia el DEFINER a INVOKER en las vistas, los procedimientos almacenados y las funciones que se van a migrar. Esta acción cambia el valor de SQL SECURITY a INVOKER. Además, DTS establece el DEFINER con la cuenta de la base de datos de destino que se utiliza para la tarea de migración.
  
  Nota
  No se modifican el método de autenticación de seguridad ni el definidor de la base de datos de origen.
- DTS no migra la información de cuentas y permisos (información USER) de la base de datos de origen. También cambia a INVOKER el método de autenticación de seguridad de las vistas, los procedimientos almacenados y las funciones que se van a migrar. Por lo tanto, cuando llame a estos objetos en la base de datos de destino, el invocador debe tener permisos de lectura y escritura sobre dicha base de datos. De lo contrario, la llamada fallará por falta de permisos. Si la cuenta del invocador ya cuenta con permisos de lectura y escritura en la base de datos de destino, la llamada a estos objetos no se verá afectada. Si desea que el DEFINER de un objeto en la base de datos de destino sea idéntico al de la base de datos de origen, elimine el objeto cuya llamada falló en la base de datos de destino y vuelva a crearlo. Al volver a crear el objeto, especifique el DEFINER original en la instrucción de creación y compruebe que la cuenta definidora exista en la base de datos de destino.
Migración completa

DTS migra todos los datos históricos de los objetos de migración especificados desde la base de datos de origen hacia la base de datos de destino.
Migración incremental

Una vez finalizada la migración completa, DTS migra las actualizaciones incrementales de datos desde la base de datos de origen hacia la base de datos de destino. La migración incremental permite migrar los datos sin problemas y sin interrumpir sus aplicaciones autogestionadas.

Operaciones SQL para la migración incremental

Tipo	Instrucción SQL
DML	INSERT, UPDATE y DELETE
DDL	ALTER TABLE y ALTER VIEW CREATE FUNCTION, CREATE INDEX, CREATE PROCEDURE, CREATE TABLE y CREATE VIEW DROP INDEX y DROP TABLE RENAME TABLE Importante Una operación RENAME TABLE puede causar inconsistencia en los datos. Por ejemplo, si selecciona solo una tabla como objeto de migración y le cambia el nombre en la instancia de origen durante la migración, los datos de esa tabla no se migrarán a la base de datos de destino. Para evitar este problema, seleccione toda la base de datos a la que pertenece la tabla como objeto de migración cuando configure la tarea de migración de datos. Compruebe que las bases de datos a las que pertenece la tabla antes y después de la operación RENAME TABLE estén incluidas en los objetos de migración. TRUNCATE TABLE

Permisos de base de datos obligatorios

Base de datos	Permisos obligatorios
Clúster de PolarDB for MySQL	Permisos de lectura sobre los objetos que se van a migrar
Instancia de PolarDB-X 2.0	Permisos de lectura y escritura sobre los objetos de migración

Para crear una cuenta de base de datos y otorgar permisos:

Clúster de PolarDB for MySQL: consulte Create and manage database accounts.
Instancia de PolarDB-X 2.0: consulte Manage database accounts.

Procedimiento

Vaya a la página de la lista de tareas de migración de la región de destino mediante uno de los siguientes métodos.
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, le recomendamos leer con atención los límites que se muestran en la parte superior de la página. De lo contrario, la tarea podría terminar con errores o presentarse 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. 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 a continuación se configurará automáticamente. Nota En la consola de DMS, este parámetro se llama Select a DMS database instance.. Si no ha registrado 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 a continuación.
	Database Type	Seleccione PolarDB for MySQL.
	Access Method	Seleccione Alibaba Cloud Instance.
	Instance Region	Seleccione la región del clúster PolarDB for MySQL de origen.
	PolarDB Cluster ID	Introduzca el ID del clúster PolarDB for MySQL de origen.
	Database Account	Introduzca la cuenta de base de datos del clúster PolarDB for MySQL de origen. Para conocer los permisos obligatorios, consulte Permissions required for database accounts.
	Database Password	Introduzca la contraseña de la cuenta de base de datos.
	Encryption	Seleccione un tipo de conexión según sus necesidades. Para obtener más información sobre la función de cifrado SSL, consulte Enable SSL encryption.
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 a continuación se configurará automáticamente. Nota En la consola de DMS, este parámetro se llama Select a DMS database instance.. Si no ha registrado 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 a continuación.
	Database Type	Seleccione PolarDB-X 2.0.
	Access Method	Seleccione Alibaba Cloud Instance.
	Instance Region	Seleccione la región de la instancia PolarDB-X 2.0 de destino.
	Instance ID	Seleccione el ID de la instancia PolarDB-X 2.0 de destino.
	Database Account	Introduzca la cuenta de base de datos de la instancia PolarDB-X 2.0 de destino. Para conocer los permisos obligatorios, consulte Permissions required for database accounts.
	Database Password	Introduzca la contraseña de la cuenta de base de datos.

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 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. 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.

Parámetro	Descripción
Migration Types	Si solo necesita ejecutar una migración completa, seleccione tanto Schema Migration como 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, debe asegurarse 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 sea necesario. Si no selecciona Incremental Data Migration, no escriba datos nuevos en la instancia de origen durante la migración para garantizar la consistencia de los datos.
Processing Mode for Existing Destination Tables	Precheck and Report Errors: comprueba si existen tablas con los mismos nombres en la base de datos de destino. Si no existen tablas con los mismos nombres, la comprobación previa se supera. Si existen tablas con los mismos nombres, se reporta un error durante la comprobación previa y la tarea de migración de datos no se inicia. Nota Si una tabla en la base de datos de destino tiene el mismo nombre pero no se puede eliminar ni renombrar fácilmente, puede cambiar el nombre de la tabla en la base de datos de destino. Para obtener más información, consulte Object name mapping. Ignore Errors and Proceed: omite la comprobación de tablas con los mismos nombres. Aviso Seleccionar Ignore Errors and Proceed puede causar inconsistencias en los datos y riesgos para el negocio. Por ejemplo: Si los esquemas de las tablas son consistentes y un registro en la base de datos de destino tiene el mismo valor de clave primaria que un registro en la base de datos de origen: Durante la migración completa, DTS conserva el registro en la base de datos de destino. El registro de la base de datos de origen no se migra. Durante la migración incremental, DTS no conserva el registro en la base de datos de destino. El registro de la base de datos de origen sobrescribe el registro en la base de datos de destino. Si los esquemas de las tablas no son consistentes, es posible que solo se migren algunas columnas de datos o que la migración termine con errores. Proceda con precaución.
Source Objects	Seleccione uno o varios objetos en la sección Source Objects. Haga clic en el icono y agregue los objetos a la sección Selected Objects. Nota La granularidad para seleccionar objetos de migración es esquema, tabla y columna. Si selecciona únicamente tablas o columnas como objetos de migración, otros objetos como vistas, disparadores y procedimientos almacenados no se migrarán a la base de datos de 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 Si utiliza la función de asignación de nombres de objetos, la migración de otros objetos que dependen del objeto renombrado podría terminar con errores. Para filtrar datos mediante condiciones WHERE, haga clic con el botón derecho en una tabla que se va a migrar en el panel Selected Objects y establezca las condiciones de filtro en el cuadro de diálogo que aparece. Para obtener más detalles, consulte Set filter conditions. Para seleccionar las operaciones SQL que se van a migrar a nivel de base de datos o de tabla, haga clic con el botón derecho en un objeto de migración en el panel Selected Objects y seleccione las operaciones SQL deseadas en el cuadro de diálogo que aparece.

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

Parámetro	Descripción
Dedicated Cluster for Task Scheduling	De forma predeterminada, DTS programa las tareas en un clúster compartido. No es necesario seleccionar uno. Si desea tareas más estables, puede adquirir un dedicated cluster para ejecutar las tareas de migración de DTS.
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 e inmediatamente comienza 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 termina 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, le recomendamos personalizar el tiempo de reintento según sus necesidades comerciales. También puede liberar la instancia de DTS lo antes posible después de liberar las instancias de base 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 que no es de 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 inmediatamente comienza 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 termina 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 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 cual 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 elegir establecer límites de velocidad para la tarea de migración incremental. Puede configurar 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	Puede seleccionar una etiqueta de entorno para identificar la instancia. En este ejemplo, no es necesario seleccionar una etiqueta.
Whether to delete SQL operations on heartbeat tables of forward and reverse tasks	Elija si desea escribir la información SQL de latido en la base de datos de origen mientras la instancia de DTS se está ejecutando. Yes: la información SQL de latido no se escribe en la base de datos de origen. Esto puede provocar que la instancia de DTS reporte un retraso. No: escribe la información SQL de latido en la base de datos de origen. Esto puede interferir con funciones como la copia de seguridad física y la clonación de la base de datos de origen.
Configure ETL	Según sus necesidades comerciales, seleccione si desea configurar la función 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 comerciales. No: no configura ninguna alerta. Yes: configura las alertas estableciendo un alert threshold y un alert notifications. Si una migración termina con errores 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 al llamar 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 iniciar la tarea de migración, DTS ejecuta una comprobación previa. La tarea solo comienza después de superar dicha comprobación.
- Si la comprobación previa termina 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, puede hacer 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.

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 siguiente tabla.

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 comercial. 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 total. Una vez detenida la tarea, 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 está ejecutando, el Status de la tarea es Running.