ApsaraDB for OceanBase (Deprecated):Migración de datos desde una base de datos OceanBase en modo compatible con MySQL hacia una base de datos MySQL

Requisitos previos

• El servicio de transmisión de datos cuenta con los privilegios necesarios para acceder a los recursos en la nube. Para obtener más información, consulte Grant privileges to roles for data transmission.

• Ha creado usuarios de base de datos dedicados a la migración de datos tanto para la base de datos OceanBase de origen en modo compatible con MySQL como para la base de datos MySQL de destino, y les ha otorgado los privilegios requeridos. Para obtener más información, consulte Configure user privileges for a data source.

Limitaciones

• Limitaciones de la base de datos de origen

  No ejecute operaciones DDL que modifiquen los esquemas de bases de datos o tablas durante la migración de esquema o la migración completa. De lo contrario, la tarea de migración de datos podría interrumpirse.

• El servicio de transmisión de datos es compatible con MySQL 5.5, 5.6, 5.7 y 8.0.

• El servicio de transmisión de datos no admite claves primarias ni únicas que contengan datos de los tipos FLOAT y BINARY simultáneamente.

• El servicio de transmisión de datos no admite campos de índice con una longitud superior a 767 bytes (o 191 caracteres) en MySQL 5.6.

• El servicio de transmisión de datos no admite triggers en el destino cuando este es una base de datos. Si existen triggers en la base de datos de destino, la migración de datos podría fallar.

• El servicio de transmisión de datos solo admite la migración de un objeto cuando se cumplen las siguientes condiciones: el nombre de la base de datos, el nombre de la tabla y el nombre de la columna del objeto están codificados en ASCII sin caracteres especiales. Los caracteres especiales incluyen saltos de línea, espacios y los siguientes símbolos: . | " ' ` ( ) = ; / & \.

• El servicio de transmisión de datos no admite una base de datos OceanBase en espera como origen.

Consideraciones

• Si el origen utiliza el juego de caracteres UTF-8, se recomienda emplear un juego de caracteres compatible, como UTF-8 o UTF-16, en el destino para evitar caracteres ilegibles.

• Si los relojes entre nodos o entre el cliente y el servidor no están sincronizados, la latencia podría ser inexacta durante la sincronización incremental o el incremento inverso.

  Por ejemplo, si el reloj está atrasado respecto a la hora estándar, la latencia puede ser negativa. Si el reloj está adelantado, la latencia puede ser positiva.

• Si el valor de la variable explicit_defaults_for_timestamp en el origen difiere del valor en el destino, los datos de tipo TIMESTAMP podrían presentar inconsistencias durante la verificación.

• Si modifica un índice único en el destino mientras la sincronización DDL está deshabilitada, debe reiniciar la tarea de migración de datos para evitar inconsistencias en la información.

• Compruebe si la precisión de migración del servicio de transmisión de datos para columnas con tipos como DECIMAL, FLOAT y DOUBLE es la esperada. Si la precisión del tipo de campo en el destino es menor que la del origen, el valor con mayor precisión podría truncarse, lo que provocaría inconsistencias entre los campos de origen y destino.

• El rango de valores TIMESTAMP admitido para OceanBase Database en modo compatible con MySQL abarca desde 0000-00-00 00:00:00.000000 hasta 9999-12-31 23:59:59.999999, mientras que para MySQL va de 1970-01-01 00:00:01.000000 a 2038-01-19 03:14:07.999999. Cuando se escribe en el origen un valor TIMESTAMP fuera del rango admitido por el destino, el servicio de transmisión de datos inserta dicho valor en el destino, pero también lo registra en el archivo error.log o en la tabla de excepciones.

• En una tarea de migración donde el origen es una base de datos OceanBase y la sincronización DDL está habilitada, si se ejecuta una operación RENAME sobre una tabla en el origen, se recomienda reiniciar la tarea para evitar pérdida de datos durante la sincronización incremental.

• Tome en cuenta las siguientes consideraciones si desea agregar varias tablas:

  • Se recomienda configurar las asignaciones entre origen y destino mediante reglas de coincidencia.

  • Se recomienda crear manualmente los esquemas en el destino. Si crea un esquema mediante el servicio de transmisión de datos, omita los objetos con errores en el paso de migración de esquema.

• Una diferencia entre los esquemas de las tablas de origen y destino puede afectar la consistencia de los datos. A continuación se describen algunos escenarios conocidos:

  • Al crear manualmente un esquema de tabla en el destino, si el tipo de dato de alguna columna no es compatible con el servicio de transmisión de datos, podría producirse una conversión implícita de tipos en el destino, lo que generaría inconsistencias en los tipos de columna entre origen y destino.

  • Si la longitud de una columna en el destino es menor que en el origen, los datos de dicha columna podrían truncarse automáticamente, causando inconsistencia entre origen y destino.

• Si selecciona únicamente Incremental Synchronization al crear la tarea de migración de datos, el servicio de transmisión de datos requiere que los registros incrementales locales de la base de datos de origen se conserven durante al menos 48 horas.

  Si selecciona Full Migration e Incremental Synchronization al crear la tarea, el servicio exige que los registros incrementales locales de la base de datos de origen se conserven durante al menos 7 días. Si el servicio no logra obtener dichos registros, la tarea de migración podría fallar o incluso generar inconsistencias entre los datos de origen y destino tras la migración.

• Si el origen o el destino contienen objetos de tabla que difieren únicamente en mayúsculas y minúsculas, los resultados de la migración podrían no ser los esperados debido a la insensibilidad a mayúsculas/minúsculas en alguno de los extremos.

Tipos de instancias de origen y destino compatibles

En la siguiente tabla, OceanBase Database en modo compatible con MySQL se denomina OB_MySQL, el cual admite instancias de clúster OceanBase e instancias serverless.

Asignaciones de tipos de datos

Procedimiento

1. Inicie sesión en OceanBase Management Console y adquiera una tarea de migración de datos.

   Para obtener más información, consulte Purchase a data migration task.

2. En la página Data Transmission > Data Migration, haga clic en Configure correspondiente a su nueva tarea de migración de datos.

   

   Para reutilizar la configuración de una tarea existente, haga clic en Reference Configuration. Para obtener más información, consulte Reference a data migration task configuration.

3. En la página Select Source and Target, configure los parámetros.

   Parámetro	Descripción
   Migration Task Name	Se recomienda utilizar una combinación de dígitos y letras. No debe contener espacios ni exceder los 64 caracteres de longitud.
   Source	Si ya creó un origen de datos OceanBase en modo compatible con MySQL, selecciónelo de la lista desplegable. De lo contrario, haga clic en New Data Source dentro de la lista y créelo en el cuadro de diálogo que aparece a la derecha. Para más detalles sobre los parámetros, consulte Create an OceanBase data source.
   Target	Si ya creó un origen de datos MySQL, selecciónelo de la lista desplegable. En caso contrario, haga clic en New Data Source dentro de la lista y créelo en el cuadro de diálogo que aparece a la derecha. Para más detalles sobre los parámetros, consulte Create a MySQL data source.
   Tag (Optional)	Seleccione una etiqueta de destino en la lista desplegable. También puede hacer clic en Manage Tags para crear, modificar o eliminar etiquetas. Para obtener más información, consulte Use tags to manage data migration tasks.

4. Haga clic en Next. En la página Select Migration Type, establezca Synchronization Topology como One-way Synchronization.

   Data Transmission Service admite One-way Synchronization y Two-way Synchronization. Este tema describe las operaciones para una tarea de sincronización unidireccional. Para más información sobre la sincronización bidireccional, consulte Configure a two-way synchronization task.

5. Seleccione un tipo para la tarea de migración de datos actual.

   Si selecciona One-way Synchronization para Synchronous Topology, los tipos de migración admitidos son: migración de esquema, migración completa, sincronización incremental, verificación completa e incremento inverso.

   

   Tipo de migración	Descripción
   Migración de esquema	Una vez iniciada la tarea de migración de esquema, el servicio de transmisión de datos migra las definiciones de los objetos de base de datos (como tablas, índices, restricciones, comentarios y vistas) desde la base de datos de origen hacia la de destino, y filtra automáticamente las tablas temporales.
   Migración completa	Al iniciar una tarea de migración completa, el servicio transfiere los datos existentes de las tablas en la base de datos de origen hacia las tablas correspondientes en el destino. Si seleccionó Full Migration, se recomienda recopilar las estadísticas de la base de datos OceanBase en modo compatible con MySQL antes de comenzar la migración.
   Sincronización incremental	Tras iniciar la sincronización incremental, el servicio replica los cambios (datos agregados, modificados o eliminados) desde la base de datos de origen hacia las tablas correspondientes en el destino. Las opciones disponibles para Incremental Synchronization son DML synchronization y DDL synchronization. Puede seleccionarlas según sus necesidades. Para más información, consulte Configure DDL/DML synchronization. Incremental Synchronization presenta las siguientes limitaciones: Si selecciona DDL synchronization y ejecuta en el origen una operación DDL no admitida por el servicio, la migración podría interrumpirse. Si la operación DDL es ADD COLUMN, se recomienda definir la columna como NULL. De lo contrario, la migración podría interrumpirse.
   Verificación completa	Una vez finalizadas la migración completa y la sincronización incremental, el servicio inicia automáticamente una tarea de verificación completa para validar las tablas en las bases de datos de origen y destino. Si seleccionó Full Verification, se recomienda recopilar estadísticas de la base de datos OceanBase en modo compatible con MySQL y usar la sentencia ANALYZE para obtener estadísticas de la base de datos MySQL antes de la verificación completa. Si seleccionó Incremental Synchronization pero no incluyó todas las operaciones DML en la sección DML synchronization, el servicio no admitirá la verificación completa.
   Incremento inverso	Los cambios realizados en la base de datos de destino después del cambio de base de datos empresarial se sincronizan en tiempo real hacia la base de datos de origen mediante incremento inverso. Generalmente, la configuración de sincronización incremental se reutiliza para el incremento inverso. No obstante, también puede personalizarla según sea necesario.

6. Haga clic en Next. En la página Select Migration Objects, seleccione los objetos para la tarea de migración de datos.

   Puede seleccionar los objetos de migración mediante dos métodos: Specify Objects y Matching Rules. Este tema explica cómo hacerlo usando el método Specify Objects. Para más información sobre la configuración de reglas de coincidencia, consulte Configure and modify matching rules.

   Importante

   • Los nombres de las tablas a migrar y de sus columnas no pueden contener caracteres chinos.

   • Si el nombre de una base de datos o tabla contiene los caracteres "$$", la creación de la tarea de migración podría fallar.

   • Si selecciona DDL Synchronization en el paso Select Migration Type, se recomienda usar reglas de coincidencia para seleccionar los objetos de migración. Esto garantiza que todos los nuevos objetos que cumplan las reglas se sincronicen. Si selecciona los objetos individualmente, los objetos nuevos o renombrados no se sincronizarán.

   

   1. En la sección Select Migration Objects, seleccione Specify Objects.

   2. In the Select Migration Scope area, in the Source Objects list, select the objects to migrate. You can select tables and views from one or more databases to migrate.

   3. Click > to add them to the Destination Objects list.

   Data Transmission Service permite importar objetos desde archivos de texto. También permite renombrar objetos de destino, establecer filtros de fila, consultar información de columnas y eliminar objetos individuales o todos a la vez.

   Nota

   Cuando selecciona objetos de migración mediante el método Matching Rules, la sintaxis de las reglas anula la capacidad de renombrar, y la sección de acciones se limita a configurar condiciones de filtro. Para más información, consulte Configure and modify matching rules.

   Operación	Descripción
   Importar objeto	En la lista situada a la derecha del área de selección, haga clic en Import Object en la esquina superior derecha. En el cuadro de diálogo que aparece, haga clic en OK. Importante La importación sobrescribe las selecciones anteriores. Proceda con precaución. En el cuadro de diálogo Import Migration Objects, importe los objetos a migrar. Puede importar un archivo CSV para renombrar tablas de base de datos, establecer condiciones de filtrado de filas y realizar otras operaciones. Para más información, consulte Download and import migration object configurations. Haga clic en Check Validity. Después de importar los objetos de migración, compruebe primero su validez. Actualmente no se admite la asignación de campos de columna. Una vez superada la comprobación, haga clic en OK.
   Renombrar	Data Transmission Service permite renombrar los objetos de migración. Para más información, consulte Rename database and table objects.
   Configuración	Data Transmission Service admite el filtrado de filas mediante condiciones WHERE. Para más información, consulte Filter data with SQL conditions. También puede consultar la información de columnas de los objetos de migración en el área View Columns.
   Eliminar/Eliminar todo	Data Transmission Service permite quitar uno o varios objetos seleccionados temporalmente para el destino durante la asignación de datos. Eliminar un solo objeto de migración En la lista a la derecha del área de selección, pase el cursor sobre el objeto objetivo y haga clic en el botón Remove que se muestra para eliminarlo. Eliminar todos los objetos de migración En la lista a la derecha del área de selección, haga clic en Remove All en la esquina superior derecha. En el cuadro de diálogo que aparece, haga clic en OK para eliminar todos los objetos.

7. Haga clic en Next. En la página Migration Options, configure los parámetros.

   • Migración completa

     La siguiente tabla describe los parámetros de migración completa, los cuales solo se muestran si seleccionó secuencialmente One-way Synchronization y Full Migration en la página Select Migration Type.

     

     Parámetro	Descripción
     Read Concurrency	Define la concurrencia para leer datos del origen durante la migración completa. El valor máximo es 512. Una concurrencia de lectura elevada puede generar una carga excesiva en el origen y afectar al negocio.
     Write Concurrency	Define la concurrencia para escribir datos en el destino durante la migración completa. El valor máximo es 512. Una concurrencia de escritura elevada puede sobrecargar el destino y afectar al negocio.
     Full Migration Rate Limit	Permite limitar la tasa de migración completa según sea necesario. Si activa esta opción, debe especificar los registros por segundo (RPS) y los bytes por segundo (BPS). El RPS indica el número máximo de filas migradas al destino por segundo, mientras que el BPS define el volumen máximo de datos en bytes transferidos por segundo durante la migración completa. Nota Los valores de RPS y BPS especificados aquí sirven únicamente para limitar la tasa. El rendimiento real de la migración completa depende de factores como la configuración del origen y destino, así como de las especificaciones de la instancia.
     Handle Non-empty Tables in Target Database	Los valores válidos son Ignore y Stop Migration. Si selecciona Ignore y los datos a insertar entran en conflicto con datos existentes en una tabla de destino, el servicio registrará el conflicto pero conservará los datos originales. Importante Al elegir Ignore, los datos se extraen en modo IN durante la verificación completa. En este caso, la verificación no aplica si el destino contiene datos inexistentes en el origen, y el rendimiento de la verificación disminuye. Si selecciona Stop Migration y una tabla de destino contiene registros, se reportará un error indicando que la migración no es compatible durante la migración completa. En tal caso, deberá procesar los datos en la tabla de destino antes de continuar. Importante Si hace clic en Restore en el cuadro de diálogo de error, el servicio ignorará dicho error y continuará la migración. Proceda con precaución.
     Post-Indexing	Indica si se deben crear índices tras finalizar la migración completa. La indexación posterior puede reducir el tiempo total de migración. Para conocer las consideraciones sobre esta opción, consulte la descripción a continuación. Importante Este parámetro solo se muestra si seleccionó tanto Schema Migration como Full Migration en la página Select Migration Type. Solo pueden crearse índices de clave no única después de completar la migración.

     Si permite la creación diferida de índices, se recomienda ajustar los siguientes parámetros del tenant empresarial mediante una herramienta de línea de comandos, considerando el hardware de la base de datos OceanBase y el tráfico actual del servicio.

     // File memory buffer limit
     alter system set _temporary_file_io_area_size = '10' tenant = 'xxx'; 
     // V4.x Disable throttling
     alter system set sys_bkgd_net_percentage = 100;  

   • Sincronización incremental

     Los siguientes parámetros solo aparecen cuando selecciona One-way Synchronization > Incremental Synchronization en la página Select Migration Type.

     

     Parámetro	Descripción
     Write Concurrency	Especifica el número de hilos concurrentes para escribir datos en el destino durante la sincronización incremental. El valor máximo es 512. Un alto grado de concurrencia puede ejercer presión excesiva sobre el destino y afectar sus servicios.
     Incremental Synchronization Rate Limit	Permite decidir si se activa el límite de tasa de sincronización incremental. Si lo habilita, configure RPS (número máximo de filas sincronizadas al destino por segundo) y BPS (volumen máximo de datos sincronizados al destino por segundo). Nota Las configuraciones de RPS y BPS funcionan únicamente como mecanismo de limitación. El rendimiento real depende de factores como el origen, el destino y las especificaciones de la instancia.
     Incremental Synchronization Start Offset	Si selecciona Full Migration, este parámetro no se muestra. Si selecciona Incremental Synchronization pero no Full Migration, especifique un punto en el tiempo desde el cual comenzar la migración. El valor predeterminado es la hora actual del sistema. Para más información, consulte Configure an incremental synchronization offset.

   • Incremento inverso

     En la página Select Migration Type, los parámetros de esta sección solo se muestran si selecciona One-way Synchronization > Reverse Incremental. La configuración predeterminada para Reverse Incremental es Reuse Incremental Synchronization Configuration.

     

     También puede optar por no reutilizar la configuración de sincronización incremental y configurarla manualmente.

     Parámetro	Descripción
     Write Concurrency	Especifica el número de hilos concurrentes para escribir datos en el origen durante la sincronización de incremento inverso. El valor máximo es 512. Un alto grado de concurrencia puede ejercer presión excesiva sobre el origen y afectar sus servicios.
     Reverse Incremental Rate Limit	Permite decidir si se activa el límite de tasa de incremento inverso. Si lo habilita, configure RPS (número máximo de filas sincronizadas al origen por segundo) y BPS (volumen máximo de datos sincronizados al origen por segundo). Nota Las configuraciones de RPS y BPS funcionan únicamente como mecanismo de limitación. El rendimiento real depende de factores como el origen, el destino y las especificaciones de la instancia.
     Incremental Synchronization Start Offset	Si selecciona Full Migration, este parámetro no se muestra. Si no selecciona Full Migration pero sí Incremental Synchronization, el valor predeterminado corresponde al cambio directo (si existe) y no puede modificarse.

   • Parámetros avanzados

     Esta sección solo se muestra si el origen es OceanBase Database V4.3.0 o posterior y ha seleccionado DDL synchronization para Reverse Increment en la página Select Migration Type.

     

     Este parámetro especifica el tipo de almacenamiento para los objetos de tabla de origen durante el incremento inverso. Los tipos de almacenamiento admitidos son Default, Row storage, Column storage y Hybrid columnar storage. Para obtener más información, consulte default_table_store_format.

     Nota

     El valor Default indica que otros parámetros se configuran automáticamente según la configuración del destino. Los nuevos objetos de tabla creados durante la sincronización DDL de incremento inverso se escriben en los esquemas correspondientes basándose en el tipo de almacenamiento especificado.

8. Haga clic en Precheck para realizar la comprobación previa de la tarea de migración de datos.

   En el paso Precheck, Data Transmission Service verifica si se cumplen diversos requisitos, como los permisos de lectura y escritura del usuario de base de datos y la conectividad de red. Solo podrá iniciar la tarea una vez aprobadas todas las comprobaciones. Si la comprobación previa falla:

   • Identifique y resuelva el problema, luego vuelva a ejecutar la comprobación previa hasta que sea exitosa.

   • También puede hacer clic en Skip en la columna Actions para un elemento fallido. Aparecerá un cuadro de diálogo describiendo el impacto de omitir dicha operación. Para continuar, haga clic en OK.

9. Una vez aprobada la comprobación previa, haga clic en Start Task.

   Si no desea iniciar la tarea inmediatamente, haga clic en Save. Posteriormente podrá iniciarla manualmente desde la página Data Migration Task List o mediante operaciones por lotes. Para más información sobre operaciones por lotes, consulte Batch Operations on Data Migration Tasks.

   Data Transmission Service permite modificar los objetos de migración y sus condiciones de filtrado de filas mientras la tarea está en ejecución. Para más información, consulte View and modify migration objects and their filter conditions. Una vez iniciada, la tarea ejecuta los pasos de migración secuencialmente según los tipos seleccionados. Para más detalles, consulte View migration details.