Migrate PolarDB-X 2.0 to AnalyticDB for PostgreSQL - Data Transmission Service

Puede utilizar DTS para migrar datos desde una instancia de PolarDB-X 2.0 hacia una instancia de AnalyticDB for PostgreSQL.

Requisitos previos

Debe contar con una instancia de origen de PolarDB-X 2.0. Para obtener más información, consulte Create an instance.
Debe contar con una instancia de destino de AnalyticDB for PostgreSQL. Para obtener más información, consulte Create an instance.
El espacio de almacenamiento de la instancia de destino de AnalyticDB for PostgreSQL debe ser mayor que el almacenamiento utilizado por la instancia de origen de PolarDB-X 2.0.

Precauciones

Tipo	Descripción
Limitaciones de la base de datos de origen	Las tablas que se van a migrar deben tener una restricción PRIMARY KEY o UNIQUE, y los campos de la clave o restricción deben ser únicos. De lo contrario, podrían generarse datos duplicados en la base de datos de destino. No se admiten instancias de solo lectura de PolarDB-X 2.0 Enterprise Edition como base de datos de origen. Si migra objetos a nivel de tabla y necesita editarlos (por ejemplo, mediante la asignación de nombres de columnas), una sola tarea de migración de datos admite un máximo de 1,000 tablas. Si supera este límite, se producirá un error al enviar la tarea. En este 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 de datos, la base de datos de origen debe cumplir con los siguientes requisitos de registro binario: Habilite la función de registro binario y establezca el parámetro `binlog_row_image` en `full`. De lo contrario, la verificación previa fallará y la tarea de migración de datos no podrá iniciarse. Para tareas de migración incremental de datos, DTS requiere que los registros binarios de la base de datos de origen se conserven durante al menos 24 horas. Para tareas que incluyen tanto migración completa como incremental de datos, los registros binarios deben conservarse durante al menos 7 días. Puede cambiar el periodo de retención a 24 horas una vez completada la migración completa de datos. Si los registros binarios no se conservan durante el periodo requerido, DTS podría no obtenerlos, lo que puede provocar fallos en la tarea e incluso inconsistencia o pérdida de datos. El SLA de DTS no cubre problemas causados por un periodo de retención de registros binarios insuficiente. Limitaciones operativas en la base de datos de origen: Durante la migración del esquema y la migración completa de datos, no realice 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. Esta acción coloca un bloqueo de metadatos que podría impedir operaciones DDL en la base de datos de origen. Durante la migración completa e incremental, DTS deshabilita temporalmente las comprobaciones de restricciones y las operaciones en cascada de claves externas a nivel de sesión. Si ocurren operaciones de actualización o eliminación en cascada en la base de datos de origen mientras se ejecuta la tarea, podrían presentarse inconsistencias en los datos. Si necesita cambiar el tipo de red de la instancia de PolarDB-X 2.0 durante la migración, deberá actualizar la información de conexión de red de la tarea de migración una vez completado el cambio. Si realiza únicamente una migración completa de datos, no escriba nuevos datos en la base de datos de origen durante la migración. De lo contrario, los datos serán inconsistentes entre las bases de datos de origen y destino. Para mantener la consistencia de los datos en tiempo real, seleccione migración de esquema, migración completa de datos y migración incremental de datos. No se admite la migración de grupos de tablas (TABLEGROUP) ni de bases de datos o tablas con el atributo Locality. No se admite la migración de tablas cuyos nombres sean palabras reservadas, como `select`. En una instancia de PolarDB-X 2.0, no se admite la sincronización de particiones de base de datos en modo DRDS. Durante la ejecución de una tarea de migración de DTS, no se admite cambiar el tipo de una tabla de difusión en la instancia de origen de PolarDB-X 2.0 (por ejemplo, cambiar una tabla de difusión a una tabla normal o a una tabla fragmentada). Para cambiar el tipo de tabla, detenga primero la tarea de migración y vuelva a configurarla una vez completado el cambio.
Otras limitaciones	Solo se admite la migración a nivel de tabla. No se admiten tablas AO como tablas de destino. Se pierden datos de las columnas de origen que no existen en la tabla de destino. Esto ocurre si utiliza asignación de columnas o si los esquemas de las tablas no coinciden. Si una tabla a migrar tiene una clave principal, la columna de clave principal en la tabla de destino debe ser idéntica a la de la tabla de origen. Si una tabla a migrar no tiene clave principal, la columna de clave principal en la tabla de destino debe coincidir con la clave de distribución. La clave única de la tabla de destino, incluida la columna de clave principal, debe contener todas las columnas de la clave de distribución. Antes de iniciar la migración de datos, evalúe el rendimiento de sus bases de datos de origen y destino. Se recomienda migrar los datos fuera de las horas pico. Una migración completa de datos consume recursos de lectura y escritura en ambas bases de datos, lo que incrementa su carga. DTS intenta restaurar las tareas de migración con errores dentro de un plazo de siete días. Por lo tanto, antes de transferir su negocio a la instancia de destino, debe finalizar o liberar la tarea, o bien utilizar el comando `revoke` para revocar los permisos de escritura de la cuenta que DTS utiliza para acceder a la instancia de destino. Esto evita que los datos de origen sobrescriban los datos de la instancia de destino después de que la tarea se restaure automáticamente. Si una tarea falla, el personal de soporte de DTS intentará restaurarla dentro de un plazo de ocho horas. Durante la restauración, podrían reiniciar la tarea o ajustar sus parámetros. Nota Solo se modifican los parámetros de la tarea de DTS, no los parámetros de la base de datos. Los parámetros que podrían ajustarse incluyen los listados en Modify instance parameters.
Otras precauciones	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	Tarifas de configuración de enlace	Tarifas de transferencia de datos
Migración de esquema + migración completa de datos	Gratuita	Gratuita (a menos que el método de acceso de destino sea Public IP Address; consulte Billing overview)
Migración incremental de datos	Con cargo; consulte Billing overview	—

Tipos de migración

Migración de esquema

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.
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 completada 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 datos sin problemas y sin interrumpir sus aplicaciones autogestionadas.

Operaciones SQL compatibles para la migración incremental

Tipo de operación	Sentencia SQL
DML	INSERT, UPDATE y DELETE Nota Cuando se escriben datos en una instancia de destino de AnalyticDB for PostgreSQL, el sistema convierte automáticamente las sentencias UPDATE en sentencias REPLACE INTO. Si una sentencia UPDATE modifica una clave principal, el sistema la convierte en una sentencia DELETE seguida de una sentencia INSERT.
DDL	ADD COLUMN

Requisitos de permisos para cuentas de base de datos

Base de datos	Migración de esquema	Migración completa	Migración incremental
Instancia de PolarDB-X 2.0	Permiso SELECT	Permiso SELECT	Permisos REPLICATION SLAVE, REPLICATION CLIENT y SELECT sobre los objetos a migrar. Nota Para saber cómo otorgar permisos a una cuenta de base de datos, consulte Data synchronization tools for PolarDB-X.
AnalyticDB for PostgreSQL	Permisos de lectura y escritura

Asignaciones de tipos de datos

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

Procedimiento

Vaya a la página de 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, revise los Limits que se muestran en la parte superior de la página para asegurarse de que la tarea de migración se pueda crear y ejecutar correctamente.

Sección	Parámetro	Descripción
N/A	Task Name	DTS genera automáticamente un nombre de tarea. Especifique un nombre descriptivo para facilitar su identificación. El nombre no necesita ser único.
Source Database	Select Existing Connection	Para usar una instancia de base de datos que ya ha sido added to the system (creada o guardada), seleccione la instancia deseada en la lista desplegable. La información de la base de datos siguiente se configurará automáticamente. Nota En la consola de DMS, este parámetro se denomina Select a DMS database instance.. Si no ha registrado la instancia de base de datos en el sistema, o si no necesita usar una instancia registrada, configure manualmente la información de la base de datos a continuación.
	Database Type	Seleccione PolarDB-X 2.0.
	Access Method	Seleccione Alibaba Cloud Instance.
	Instance Region	Seleccione la región donde reside la instancia de origen de PolarDB-X 2.0.
	Replicate Data Across Alibaba Cloud Accounts	Este ejemplo migra datos dentro de la misma cuenta de Alibaba Cloud. Seleccione No.
	Instance ID	Seleccione el ID de la instancia de origen de PolarDB-X 2.0.
	Database Account	Introduzca la cuenta de la base de datos de la instancia de origen de PolarDB-X 2.0. 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.
Destination Database	Select Existing Connection	Para usar una instancia de base de datos que ya ha sido added to the system (creada o guardada), seleccione la instancia deseada en la lista desplegable. La información de la base de datos siguiente se configurará automáticamente. Nota En la consola de DMS, este parámetro se denomina Select a DMS database instance.. Si no ha registrado la instancia de base de datos en el sistema, o si no necesita usar una instancia registrada, configure manualmente la información de la base de datos a continuación.
	Database Type	Seleccione AnalyticDB for PostgreSQL.
	Access Method	Seleccione Alibaba Cloud Instance.
	Instance Region	Seleccione la región donde reside la instancia de destino de AnalyticDB for PostgreSQL.
	Instance ID	Seleccione el ID de la instancia de destino de AnalyticDB for PostgreSQL.
	Database Name	Introduzca el nombre de la base de datos de destino en la instancia de AnalyticDB for PostgreSQL.
	Database Account	Introduzca la cuenta de la base de datos de la instancia de destino de AnalyticDB for PostgreSQL.
	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.

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 desea realizar una migración completa de datos, seleccione tanto Schema Migration como Full Data Migration. Para realizar una migración en línea sin tiempo de inactividad, seleccione Schema Migration, Full Data Migration y Incremental Data Migration. Nota Si selecciona Schema Migration, las claves externas de la base de datos de origen también se migran a la base de datos de destino. Si selecciona Full Data Migration, los esquemas y los datos de las tablas creadas mediante la sentencia CREATE TABLE se pueden migrar a la base de datos de destino. Si no selecciona Incremental Data Migration, no escriba nuevos datos en la instancia de origen durante la migración de datos para garantizar la coherencia de los datos.
Schema Migration	Full Data Migration: 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 correctamente. Si existen tablas con los mismos nombres, se notifica 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 o 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. Schema Migration: Omite la comprobación de tablas con los mismos nombres. Aviso Seleccionar Full Data Migration puede causar inconsistencia 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 principal 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 son inconsistentes, es posible que solo se migren algunas columnas de datos o que la migración falle. Proceda con precaución.
Incremental Data Migration	Seleccione un motor de almacenamiento para las tablas de destino según sus requisitos empresariales. El valor predeterminado es Beam. Nota Este parámetro solo está disponible si la instancia de destino de AnalyticDB for PostgreSQL tiene una versión de kernel v7.0.6.6 o posterior y usted seleccionó Schema Migration para el parámetro Full Data Migration.
Incremental Data Migration	Configure la directiva de uso de mayúsculas para los nombres de bases de datos, tablas y columnas migrados en la instancia de destino. La directiva predeterminada de DTS está seleccionada por defecto. También puede mantener la coherencia con la directiva 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.
Processing Mode for Existing Destination Tables	Seleccione uno o varios objetos en la sección Precheck and Report Errors. Haga clic en el icono y agregue los objetos a la sección Ignore Errors and Proceed. Nota Solo puede seleccionar tablas como objetos de migración. Otros objetos, como vistas, desencadenadores y procedimientos almacenados, no se migran a la base de datos de destino.
Ignore Errors and Proceed	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 Storage Engine Type. 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 Migration Types en la esquina superior derecha del cuadro Schema Migration. 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 fallar. Para especificar una cláusula WHERE que filtre datos, haga clic con el botón derecho en una tabla dentro del cuadro Capitalization of Object Names in Destination Instance y especifique la condición de filtro en el cuadro de diálogo que aparece. Para obtener más información, consulte Filter task data by using SQL statements. Para seleccionar las operaciones SQL que se migrarán a nivel de tabla, haga clic con el botón derecho en una tabla dentro del cuadro Source Objects y seleccione las operaciones SQL deseadas en el cuadro de diálogo que aparece.

Haga clic en Source Objects para configurar los parámetros avanzados.

Parámetro	Descripción
Selected Objects	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 tareas de migración de DTS.
Selected Objects	Después de que se inicia la tarea de migración, si falla la conexión a la base de datos de origen o de destino, DTS notifica un error e intenta reconectar inmediatamente. La duración predeterminada de reintentos es de 720 minutos. Puede personalizar el tiempo de reintento a un valor entre 10 y 1440 minutos. Se recomienda establecer la duración en más de 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. 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 período de reintento de conexión, se recomienda personalizar el tiempo de reintento según sus necesidades empresariales, o liberar la instancia de DTS lo antes posible después de que se liberen las instancias de base de datos de origen y de destino.
Selected Objects	Después de que se inicia la tarea de migración, si ocurre un problema que no es de conectividad, como una excepción en la ejecución de DDL o DML, en la base de datos de origen o de destino, DTS notifica un error e intenta reintentar la operación inmediatamente. La duración predeterminada de reintentos es de 10 minutos. Puede personalizar el tiempo de reintento a un valor entre 1 y 1440 minutos. Se recomienda establecer la duración en más de 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 Selected Objects debe ser menor que el valor de Batch Edit.
Selected Objects	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 Selected Objects, Next: Advanced Settings y Dedicated Cluster for Task Scheduling para reducir la carga en la base de datos de destino. Nota Este elemento de configuración solo está disponible si selecciona Retry Time for Failed Connections para Retry Time for Other Issues. También puede adjust the full migration speed después de que la instancia de migración esté en ejecución.
Retry Time for Other Issues	Si es necesario, también puede optar por establecer límites de velocidad para la tarea de migración incremental. Puede establecer Retry Time for Failed Connections y Enable Throttling for Full Data Migration para reducir la carga en la base de datos de destino. Nota Este elemento de configuración solo está disponible si selecciona Queries per second (QPS) to the source database para RPS of Full Data Migration. También puede adjust the incremental migration speed después de que la instancia de migración esté en ejecución.
Data migration speed for full migration (MB/s)	Elija si desea escribir información SQL de latido en la base de datos de origen mientras la instancia de DTS está en ejecución. Full Data Migration: No se escribe información SQL de latido en la base de datos de origen. Esto puede provocar que la instancia de DTS notifique un retraso. Migration Types: Escribe 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.
Enable Throttling for Incremental Data Migration	Seleccione una etiqueta de entorno para identificar la instancia. No es obligatorio para este ejemplo.
RPS of Incremental Data Migration	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: Data migration speed for incremental migration (MB/s): Habilita la función ETL. Introduzca sentencias 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. Incremental Data Migration: Deshabilita la función ETL.
Migration Types	Seleccione si desea configurar alertas y recibir notificaciones de alerta según sus necesidades empresariales. Whether to delete SQL operations on heartbeat tables of forward and reverse tasks: No configura ninguna alerta. Yes: Configure 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.

Opcional: Después de completar las configuraciones anteriores, haga clic en No para configurar la columna de clave principal y la clave de distribución para las tablas que se migrarán a la instancia de destino de AnalyticDB for PostgreSQL.
Nota
- Si selecciona Environment Tag bajo Configure ETL, debe configurar parámetros como Yes, No y Monitoring and Alerting para las tablas que se migrarán a la instancia de AnalyticDB for PostgreSQL. Para obtener más información, consulte CREATE TABLE.
- La No puede ser una clave principal compuesta por varias columnas, y debe seleccionar una o más columnas de la Yes para que sirvan como Next: Configure Database and Table Fields.

Guarde la tarea y ejecute una comprobación previa.
- Para ver los parámetros de configuración de esta instancia al llamar a la operación de API, pase el puntero sobre el botón Migration Types y haga clic en Schema Migration en la burbuja que aparece.
- Si no necesita ver los parámetros de API o ya terminó de verlos, haga clic en Type en la parte inferior de la página.
Nota
- Antes de que comience la tarea de migración, DTS realiza una comprobación previa. La tarea solo se inicia después de superar dicha comprobación.
- Si la comprobación previa falla, haga clic en Primary Key Column junto al elemento fallido, solucione el problema según las indicaciones y vuelva a ejecutar la comprobación previa.
- Si se notifica una advertencia durante la comprobación previa:
  
  Para los elementos de comprobación que no se pueden ignorar, haga clic en Distribution Key junto al elemento fallido, solucione 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 Primary Key Column, Primary Key Column, Distribution Key y Next: Save Task Settings and Precheck para omitir el elemento de advertencia y volver a ejecutar la comprobación previa. Si decide ignorar una advertencia, esto podría causar problemas como inconsistencia de datos y representar riesgos para su negocio.

Adquiera la instancia.

Cuando la Preview OpenAPI parameters sea del 100 %, haga clic en Next: Save Task Settings and Precheck.

En la página View Details, 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
View Details	Confirm Alert Details	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?
View Details	Ignore	DTS proporciona especificaciones de migración con diferentes 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 OK.
Haga clic en Precheck Again. En el cuadro de diálogo Success Rate que aparece, haga clic en Next: Purchase Instance.

Puede consultar el progreso de la tarea de migración en la página de lista de Purchase.
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 la tarea, su New Instance Class cambia a Resource Group Settings.
- 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 está en ejecución, el Instance Class de la tarea es Data Transmission Service (Pay-as-you-go) Service Terms.