Limitaciones conocidas

Antes de elegir migrar tus bases de datos a AlloyDB para PostgreSQL, considera las limitaciones conocidas para esta situación de migración.

Entre las limitaciones conocidas para usar una base de datos de PostgreSQL como fuente, se incluyen las siguientes:

  • La extensión pglogical no admite la replicación de columnas generadas para PostgreSQL 12 y versiones posteriores.

  • Los cambios en las estructuras de las tablas (DDL) no se replican a través de comandos de DDL estándar, sino solo con comandos ejecutados con la extensión pglogical que se usa para la replicación. Esto incluye cambios en los tipos de enum.

    • Por ejemplo, pglogical proporciona la función pglogical.replicate_ddl_command que permite que el DDL se ejecute tanto en la base de datos de origen como en la réplica en un punto coherente. El usuario que ejecuta este comando en la fuente ya debe existir en la réplica.
    • Para replicar datos de tablas recién creadas, debes usar el comando pglogical.replication_set_add_table para agregar tablas nuevas a los conjuntos de replicación existentes.
    • Para obtener más información sobre la replicación de DDL mientras la migración está en curso, consulta Fidelidad de la migración.
  • Limitaciones de los objetos:

    • La replicación lógica no replica las tablas externas.
    • Las tablas UNLOGGED y TEMPORARY no se replican ni se pueden replicar.
    • La decodificación lógica de PostgreSQL no admite el tipo de datos de objeto grande (oid que hace referencia a pg_largeobject).
    • Database Migration Service no migra datos de vistas materializadas, solo el esquema de la vista. Para propagar las vistas en la base de datos de destino, ejecuta lo siguiente: REFRESH MATERIALIZED VIEW view_name;.
    • Los estados SEQUENCE (por ejemplo, last_value) en el destino pueden variar con respecto al origen durante la CDC en curso. Los valores de secuencia se sincronizan durante el paso final de la promoción.
  • Para las tablas que no tienen claves primarias, Database Migration Service admite la migración de la instantánea inicial y las sentencias INSERT durante la fase de captura de datos modificados (CDC). La migración de las declaraciones UPDATE y DELETE es diferente para lo siguiente:

    • Migraciones estándar: Las declaraciones UPDATE y DELETE no se migran para las tablas sin claves primarias. Debes agregar claves primarias para tus columnas antes de migrar o migrar las declaraciones UPDATE y DELETE de forma manual.
    • Migraciones de inicio rápido: Con las migraciones de inicio rápido, no se requieren claves primarias para replicar las operaciones UPDATE y DELETE si configuras la identidad de la réplica como INDEX o FULL. La configuración de REPLICA IDENTITY FULL aumenta el volumen del registro de escritura anticipada (WAL) y la sobrecarga de recursos. Se recomienda agregar una clave primaria cuando sea posible. Para obtener más información, consulta la documentación de Replica Identity de PostgreSQL y la guía de migración de inicio rápido.
  • Solo se pueden migrar las extensiones y las versiones de extensiones que AlloyDB para PostgreSQL admite para PostgreSQL. Database Migration Service no migra las extensiones que no son compatibles con AlloyDB para PostgreSQL y, si existen extensiones en la base de datos de origen cuyas versiones no son compatibles con AlloyDB para PostgreSQL, es posible que falle la prueba o el inicio del trabajo de migración. Para garantizar una migración sin problemas, verifica que las extensiones de origen sean compatibles y que tus aplicaciones no hagan referencia a extensiones no compatibles. Para obtener la lista de extensiones compatibles, consulta Extensiones compatibles en la documentación de AlloyDB para PostgreSQL.

  • Database Migration Service no migra la extensión pg_cron (ni ningún trabajo cron configurado dentro de la extensión), pero es compatible con los destinos de AlloyDB para PostgreSQL. Si usas pg_cron en tus bases de datos de origen, reinstala la extensión y configura tus trabajos cron en el clúster de destino después de que se complete la migración.

  • Database Migration Service no admite la migración desde réplicas de lectura que están en modo de recuperación.

  • Database Migration Service no admite fuentes de Amazon RDS en las que se aplica el paquete de extensión de AWS SCT.

  • Las funciones definidas por el usuario escritas en C no se pueden migrar, excepto las que se instalan cuando se crean extensiones compatibles con AlloyDB para PostgreSQL.

  • Las bases de datos que se agregan a la instancia de origen después de que se inicia el trabajo de migración no se migran.

  • Puedes seleccionar bases de datos específicas cuando migras con Database Migration Service. Se migran todas las tablas y los esquemas de las bases de datos seleccionadas, excepto los siguientes:

    • El esquema de información (information_schema).
    • Cualquier esquema que comience con pg_ (por ejemplo, pg_catalog, pg_toast, pgtemp*). Para obtener la lista completa de catálogos de PostgreSQL que comienzan con pg_, consulta Catálogos del sistema de PostgreSQL en la documentación de PostgreSQL.
    • Credenciales de acceso y roles de los usuarios
  • Si las bases de datos encriptadas requieren claves de encriptación administradas por el cliente (CMEK) para desencriptar los datos y Database Migration Service no tiene acceso a las claves, las bases de datos no se pueden migrar. Sin embargo, los datos encriptados con la extensión pgcrypto se pueden migrar porque AlloyDB para PostgreSQL admite pgcrypto. Database Migration Service también admite la migración desde bases de datos encriptadas de Amazon Aurora o Amazon RDS, ya que AWS controla la desencriptación de forma transparente. Para obtener más información, consulta Encripta recursos de Amazon Aurora y Encripta recursos de Amazon RDS.

  • Las bases de datos que se migran no están protegidas contra escritura durante la migración: AlloyDB para PostgreSQL no ejecuta la instancia de destino en modo de solo lectura durante la migración. Aunque puedes conectarte al clúster de destino para crear y administrar usuarios de la base de datos o aplicar los cambios de esquema necesarios (DDL), no realices operaciones de escritura (como INSERT, UPDATE o DELETE) en las bases de datos o tablas que se están migrando. Escribir en datos que se están migrando puede causar conflictos de replicación o fallas en la migración.

  • El comportamiento del activador depende de su configuración. De forma predeterminada, los activadores no se activan en la réplica durante la replicación, a menos que se configuren con ALTER EVENT TRIGGER o ALTER TABLE ... ENABLE ALWAYS TRIGGER.

  • Los espacios de tablas personalizados se asignan al espacio de tablas pg_default predeterminado en AlloyDB para PostgreSQL.

  • El método de conectividad de interfaces de Private Service Connect solo se admite para migrar a clústeres de destino existentes. Si quieres usar la conectividad de IP privada y migrar a un clúster de destino nuevo en una migración estándar, usa el intercambio de tráfico entre VPC.

  • No se admite la autenticación de la base de datos de Identity and Access Management para los clústeres de destino. Database Migration Service se conecta a la base de datos de destino con la autenticación de usuario de la base de datos. Para obtener más información sobre IAM, consulta Administra la autenticación de IAM en la documentación de AlloyDB para PostgreSQL.

Funciones de definidor de seguridad

Las funciones definidas con SECURITY DEFINER se ejecutan con los privilegios del usuario que posee la función, en lugar del usuario que la ejecuta.

Durante la migración continua a AlloyDB para PostgreSQL, las rutinas definidas con SECURITY DEFINER pasan a ser propiedad del usuario del servicio de migración interno alloydbexternalsync en la instancia principal de destino. Debido a que alloydbexternalsync posee privilegios de administrador elevados, incluidos los roles alloydbsuperuser y alloydbreplica, cualquier usuario autorizado para ejecutar estas funciones las ejecuta con derechos completos de alloydbsuperuser. Esto genera un riesgo de elevación de privilegios no deseado.

Para solucionar este riesgo, audita todas las funciones de SECURITY DEFINER en tu clúster de destino y revoca los privilegios de ejecución pública inmediatamente después de la migración:

REVOKE EXECUTE ON FUNCTION SCHEMA_NAME.FUNCTION_NAME(ARGUMENT_TYPES) FROM PUBLIC;
GRANT EXECUTE ON FUNCTION SCHEMA_NAME.FUNCTION_NAME(ARGUMENT_TYPES) TO "AUTHORIZED_USER";

Alineación de intercalación y configuración regional

AlloyDB para PostgreSQL usa de forma predeterminada las configuraciones regionales C.UTF-8 y en_US.utf8 proporcionadas por libc. Todas las demás configuraciones regionales en AlloyDB para PostgreSQL usan intercalaciones de componentes internacionales para Unicode (ICU).

Si tu base de datos de origen usa una intercalación predeterminada basada en otra configuración regional de libc, ese valor predeterminado no se transfiere automáticamente. Para garantizar una clasificación coherente en las consultas que usan ORDER BY, es posible que debas actualizar tus tablas con intercalaciones de ICU explícitas después de la migración. Para obtener más información, consulta Configuraciones regionales admitidas para los datos importados en la documentación de AlloyDB para PostgreSQL.

Limitaciones para las migraciones a clústeres de destino existentes

  • Solo puedes configurar un trabajo de migración activo por clúster de destino.
  • Descenso de nivel del clúster de destino para migraciones estándar: En el caso de las migraciones estándar a clústeres de AlloyDB para PostgreSQL existentes, Database Migration Service desciende de nivel el clúster independiente para configurarlo como una réplica externa de la base de datos de origen.
    • Debes confirmar el descenso de nivel cuando crees el trabajo de migración en la consola de Google Cloud ingresando el ID del clúster de destino (o ejecutando gcloud database-migration migration-jobs demote-destination).
    • Las migraciones de inicio rápido usan la replicación lógica de PostgreSQL pgnative y no requieren ni realizan la degradación del clúster de destino.
  • En el caso de las migraciones estándar, el clúster de destino existente debe estar vacío o contener solo datos de configuración predeterminados del sistema. La migración a un clúster de destino existente que contiene datos del usuario (como tablas) no es compatible con las migraciones estándar.

    Si tienes problemas debido a datos adicionales en tu clúster de destino existente, borra las bases de datos en tu clúster de destino y vuelve a intentar el trabajo de migración. Consulta Borra los datos adicionales de tu clúster de destino existente.

  • Se admite la migración a clústeres con instancias de grupos de lectura. Para obtener más información sobre los clústeres y las instancias de AlloyDB para PostgreSQL, consulta Descripción general de AlloyDB para PostgreSQL.

Consideraciones sobre el paralelismo de volcado de datos

Cuando creas un trabajo de migración, puedes aumentar la cantidad de suscripciones paralelas para acelerar el volcado de datos inicial y la replicación de la captura de datos modificados (CDC) en curso. El uso de una configuración de paralelismo de volcado de datos más alta también aumenta el uso de conexiones y recursos en la base de datos de origen y en el clúster de AlloyDB para PostgreSQL de destino.

  • Asegúrate de que tu base de datos de origen tenga suficiente margen de CPU, memoria y E/S antes de usar el paralelismo Máximo.
  • Cuando uses el paralelismo de volcado de datos ajustado, debes configurar valores más altos para max_replication_slots, max_wal_senders y max_worker_processes en tu base de datos de origen. Para obtener cálculos detallados de los parámetros, consulta Configura tu base de datos de origen.
  • La extensión pglogical replica los datos a nivel de la tabla durante el volcado completo inicial. Se asigna una sola tabla no particionada a una suscripción y no se divide entre varias suscripciones paralelas o subprocesos de trabajador.
  • La extensión pglogical replica las particiones de hoja individuales como tablas separadas y puede distribuir varias particiones de hoja en suscripciones paralelas durante el volcado completo inicial. Una sola partición de hoja grande no se puede dividir en varias suscripciones y se copia con un solo subproceso.
  • Database Migration Service ordena las tablas por tamaño y las distribuye entre suscripciones paralelas. Database Migration Service crea hasta 2 suscripciones por base de datos (y hasta 2 en total en todas las bases de datos) para el paralelismo Óptimo y hasta 4 suscripciones por base de datos (y hasta 4 en total en todas las bases de datos) para el paralelismo Máximo, con al menos 1 suscripción por base de datos migrada. Por ejemplo, si una base de datos tiene una tabla de 1 TB y varias tablas pequeñas, Database Migration Service aísla la tabla de 1 TB en una suscripción y distribuye las tablas más pequeñas en las suscripciones restantes. Incluso con varias suscripciones activas, la velocidad general de volcado inicial sigue estando limitada por el tiempo necesario para copiar la tabla única de 1 TB.
  • Database Migration Service asigna tablas sin claves primarias a conjuntos de replicación dedicados de solo inserción (uno por suscripción paralela). Se pueden distribuir varias tablas sin claves primarias en suscripciones paralelas, pero durante el volcado completo inicial, cada tabla individual se copia como un flujo de tabla único dentro de una suscripción y no se divide en varios subprocesos paralelos.

Cuotas

  • Pueden existir hasta 2,000 perfiles de conexión y 1,000 trabajos de migración en un momento determinado. Para crear espacio para más, borra los trabajos de migración y los perfiles de conexión que no se usen. Para obtener más detalles, consulta Cuotas y límites.

Compatibilidad de versiones de extensiones de PostgreSQL durante las actualizaciones de versiones principales

Cuando migras a una versión principal de PostgreSQL posterior, Database Migration Service usa la utilidad pg_restore, que instala la versión de extensión predeterminada de la versión principal de PostgreSQL de destino. No puedes especificar una versión de extensión exacta para la utilidad pg_restore.

Si tu base de datos de origen usa una versión de extensión que no es compatible con el esquema de la versión predeterminada instalada en la versión principal de PostgreSQL de destino, la migración podría fallar debido a una discrepancia de esquema o a errores internos.

Para evitar fallas en la migración, verifica la compatibilidad del esquema. Antes de migrar, actualiza las extensiones de tu base de datos de origen a una versión compatible con la versión principal de PostgreSQL de destino.

¿Qué sigue?