ApsaraDB RDS:Introduction to the check report of a major engine version upgrade for an ApsaraDB RDS for PostgreSQL instance

Advertencia de disco

Formato de la advertencia: Total disk space: {*} GB; Used disk: {*} GB; Used inodes: {*}; bytes-per-nodes: {*}; Minimum disk space required for upgrade: {*} GB

Causa: la instancia tiene demasiados objetos y el almacenamiento actual es insuficiente para la actualización.

Solución:

• Modo de despliegue azul-verde: establezca la capacidad de almacenamiento de la nueva instancia en un valor mayor o igual al espacio mínimo de disco requerido para la actualización.

• Modo de actualización local: amplíe la capacidad de almacenamiento de la instancia a un valor mayor o igual al espacio mínimo de disco requerido antes de iniciar la actualización. Para obtener más información, consulte Change the configuration.

Advertencia de memoria

Formato de la advertencia: Current memory: {*} GB; Recommended memory: {*} GB; Minimum memory: {*} GB

Causa: la instancia tiene demasiados objetos y la memoria actual es insuficiente para minimizar el tiempo en modo de solo lectura durante la actualización.

Solución:

• Modo de despliegue azul-verde: configure la especificación de la nueva instancia para que su memoria cumpla o supere el requisito mínimo.

• Modo de actualización local: actualice la especificación de la instancia si la memoria actual es menor que la capacidad recomendada. Para obtener más información, consulte Change the configuration.

Advertencia de suscripción

Formato de la advertencia: The instance has replication slot subscribers. To prevent subscription data inconsistency, see the Alibaba Cloud documentation

Causa: la instancia tiene suscriptores de ranuras de replicación. Ejecute la siguiente consulta para comprobarlo:

SELECT * FROM pg_subscription;

Solución: siga los pasos del tema Upgrade the database major version para gestionar los suscriptores de ranuras de replicación.

Advertencia de secuencias (solo en el modo sin tiempo de inactividad)

Formato de la advertencia: Total Sequence tables: {0}. Too many Sequence tables will extend the switchover time for logical replication major version upgrade.

Causa: la instancia contiene secuencias. Ejecute la siguiente consulta para enumerarlas:

SELECT * FROM pg_sequences;

Solución: si la instancia tiene muchas secuencias, clone la instancia y ejecute una actualización de prueba para medir el tiempo real del cambio de rol antes de actualizar el entorno de producción.

Error de cuenta

Formato del error: Invalid superuser account: {*}; Invalid account: {*}; Please see the Alibaba Cloud documentation

Causa: la instancia tiene cuentas de superusuario redundantes o cuentas estándar con configuraciones de cifrado no válidas.

Solución:

• Cuentas de superusuario redundantes: envíe un ticket para solicitar su eliminación.

• Cuentas estándar no válidas: restablezca las contraseñas de las cuentas afectadas.

Error de comprobación previa

Formato del error: pg_upgrade pre-check task failed, need to check [pg_upgrade error log] and [pg_upgrade-related files and errors]

Causa: la comprobación previa de pg_upgrade terminó con errores.

Solución: revise la sección del registro de errores de pg_upgrade en el informe de comprobación para identificar y resolver el problema específico.

Error de la extensión pgcrypto

Formato del error: The pg_crypto extension is installed in schema: pg_catalog in database: {*}, please see the Alibaba Cloud documentation

Causa: la extensión pgcrypto crea funciones en pg_catalog que solo existen en versiones posteriores de PostgreSQL. Esto provoca que la actualización de la versión principal del motor termine con errores.

Solución: en cada base de datos afectada, elimine la extensión pgcrypto y vuelva a crearla en un esquema distinto de pg_catalog.

Error de versión secundaria (solo en el modo sin tiempo de inactividad)

Formato del error: Zero-downtime major version upgrade requires minimum minor version 20250228

Causa: la versión secundaria del motor de la instancia es anterior a 20250228.

Solución: Upgrade the minor engine version a la versión 20250228 o posterior.

loadable_libraries.txt: extensiones incompatibles

El archivo loadable_libraries.txt enumera los archivos de biblioteca que la versión de PostgreSQL de destino no puede cargar. Cada biblioteca suele corresponder a una extensión.

Causa: una o más extensiones instaladas son incompatibles con la versión principal del motor de destino.

Solución: revise las extensiones listadas en loadable_libraries.txt. Compruebe si su aplicación depende de cada una y decida si debe eliminarla antes de la actualización. Para consultar la lista de extensiones compatibles con cada versión, consulte Supported extensions.

En las siguientes secciones se describen las extensiones incompatibles más comunes.

tables_with_oids.txt: tablas con OID

El archivo tables_with_oids.txt enumera las tablas creadas con la declaración WITH OIDS. PostgreSQL 12 y versiones posteriores no admiten WITH OIDS.

Causa: una o más tablas usan la declaración WITH OIDS, la cual no es compatible con la versión de destino.

Solución:

• Opción 1 (recomendada): actualice a PostgreSQL 11, que todavía admite WITH OIDS.

• Opción 2: revise las tablas listadas en tables_with_oids.txt y confirme que su aplicación no depende de los valores OID. Luego, ejecute la siguiente instrucción para cada tabla afectada:

  ALTER TABLE {table_name} SET WITHOUT OIDS;

Tablas externas

Formato del error: Foreign tables in database: {0}. Total databases: {1}

Causa: la instancia contiene tablas externas, las cuales no se pueden replicar mediante replicación lógica.

Solución: elimine todas las tablas externas.

1. En cada base de datos, identifique las tablas externas:

   SELECT COUNT(*) AS count, relkind
   FROM pg_class
   WHERE relkind IN ('f')
   GROUP BY relkind;

2. Elimine las tablas externas:

   DROP FOREIGN TABLE [ IF EXISTS ] name [ CASCADE | RESTRICT ];

Para obtener más información, consulte la documentación de PostgreSQL sobre DROP FOREIGN TABLE.

Tablas sin clave primaria ni clave única

Formato del error: Tables without primary key or unique key in database: {0}. Total databases: {1}

Causa: la replicación lógica requiere que cada tabla tenga una clave primaria, una clave única o REPLICA IDENTITY FULL para identificar las filas durante la replicación.

Solución: agregue una clave primaria o única a cada tabla afectada, o bien configure REPLICA IDENTITY FULL.

1. En cada base de datos, identifique las tablas sin clave primaria ni clave única:

   SELECT COUNT(*) AS count
   FROM information_schema.tables t
   LEFT JOIN information_schema.table_constraints tc
       ON t.table_name = tc.table_name
       AND t.table_schema = tc.table_schema
       AND (tc.constraint_type = 'PRIMARY KEY' OR tc.constraint_type = 'UNIQUE')
   JOIN pg_class c
       ON t.table_name = c.relname
   JOIN pg_namespace ns
       ON c.relnamespace = ns.oid
       AND ns.nspname = t.table_schema
   WHERE t.table_type = 'BASE TABLE'
       AND tc.constraint_type IS NULL
       AND t.table_schema NOT IN ('pg_catalog', 'information_schema')
       AND c.relreplident != 'f';

2. Configure REPLICA IDENTITY FULL en la tabla (si agregar una clave no es viable):

   ALTER TABLE name REPLICA IDENTITY FULL;

3. O bien, agregue una clave primaria o única:

   -- Primary key
   ALTER TABLE name
       ADD CONSTRAINT constraint_name PRIMARY KEY (column_name);
   
   -- Unique key
   ALTER TABLE name
       ADD CONSTRAINT constraint_name UNIQUE (column_name);

Para obtener más información, consulte la documentación de PostgreSQL sobre restricciones únicas.

Vistas materializadas

Formato del error: Materialized views in database: {0}. Total databases: {1}

Causa: la replicación lógica no puede replicar vistas materializadas.

Solución: elimine todas las vistas materializadas.

1. En cada base de datos, identifique las vistas materializadas:

   SELECT COUNT(*) AS count, relkind
   FROM pg_class
   WHERE relkind IN ('m')
   GROUP BY relkind;

2. Elimine las vistas materializadas:

   DROP MATERIALIZED VIEW IF EXISTS name;

Objetos grandes

Formato del error: Large objects in database: {0}. Total databases: {1}

Causa: la replicación lógica no puede replicar los objetos grandes almacenados en pg_largeobject.

Solución: elimine los objetos grandes.

1. En cada base de datos, cuente los objetos grandes:

   SELECT COUNT(*) AS count
   FROM pg_largeobject_metadata;

2. Elimine cada objeto grande:

   SELECT lo_unlink(largeobject_oid);

Extensiones prohibidas

Formato del error: Logical replication prohibited extensions in database: {0}. Total databases: {1}

Causa: las siguientes extensiones son incompatibles con la replicación lógica y no pueden estar presentes durante una actualización sin tiempo de inactividad: pg_partman, pg_cron, pg_active y pglogical.

Solución: elimine temporalmente las extensiones incompatibles.

1. En cada base de datos, compruebe si hay extensiones prohibidas instaladas:

   SELECT COUNT(*) AS count
   FROM pg_extension
   WHERE extname IN ('pg_partman', 'pg_cron', 'pg_active', 'pglogical');

2. Elimine cada extensión prohibida:

   DROP EXTENSION extension_name;

Requisitos de parámetros no cumplidos

Formato del error: Logical replication requires wal_level to be logical, max_wal_sender and max_replication_slots to be at least {0}, instance wal_level is: {1}, max_wal_sender is: {2}, max_replication_slots is: {3}

Causa: uno o más de los siguientes parámetros no cumplen los requisitos de la replicación lógica: wal_level, max_wal_sender o max_replication_slots.

Solución: actualice los valores de los parámetros. Algunos cambios requieren reiniciar la instancia para surtir efecto. Para obtener más información, consulte Set the parameters of an instance.