ApsaraDB RDS:Présentation du rapport de vérification d'une mise à niveau majeure de la version moteur pour une instance ApsaraDB RDS for PostgreSQL

Avertissement relatif au disque

Format de l'avertissement : Total disk space: {*} GB; Used disk: {*} GB; Used inodes: {*}; bytes-per-nodes: {*}; Minimum disk space required for upgrade: {*} GB

Cause : L'instance contient trop d'objets ; le stockage actuel est insuffisant pour la mise à niveau.

Solution :

• Mode de déploiement bleu-vert : Définissez la capacité de stockage de la nouvelle instance sur une valeur supérieure ou égale à l'espace disque minimal requis pour la mise à niveau.

• Mode de mise à niveau locale : Augmentez la capacité de stockage de l'instance à une valeur supérieure ou égale à l'espace disque minimal requis pour la mise à niveau avant de commencer la procédure. Pour plus d'informations, consultez la rubrique Modifier la configuration.

Avertissement relatif à la mémoire

Format de l'avertissement : Current memory: {*} GB; Recommended memory: {*} GB; Minimum memory: {*} GB

Cause : L'instance contient trop d'objets ; la mémoire actuelle est insuffisante pour minimiser la durée en lecture seule pendant la mise à niveau.

Solution :

• Mode de déploiement bleu-vert : Définissez la spécification de la nouvelle instance de sorte que sa mémoire atteigne ou dépasse l'exigence minimale de mémoire.

• Mode de mise à niveau locale : Mettez à niveau la spécification de l'instance si la mémoire actuelle est inférieure à la capacité de mémoire recommandée. Pour plus d'informations, consultez la rubrique Modifier la configuration.

Avertissement relatif à l'abonnement

Format de l'avertissement : The instance has replication slot subscribers. To prevent subscription data inconsistency, see the Alibaba Cloud documentation

Cause : L'instance possède des abonnés aux slots de réplication. Exécutez la requête suivante pour vérifier :

SELECT * FROM pg_subscription;

Solution : Suivez les étapes décrites dans la rubrique Mettre à niveau la version majeure de la base de données pour gérer les abonnés aux slots de réplication.

Avertissement relatif aux séquences (mode zéro temps d'arrêt uniquement)

Format de l'avertissement : Total Sequence tables: {0}. Too many Sequence tables will extend the switchover time for logical replication major version upgrade.

Cause : L'instance contient des séquences. Exécutez la requête suivante pour les lister :

SELECT * FROM pg_sequences;

Solution : Si l'instance contient un grand nombre de séquences, clonez l'instance et effectuez une mise à niveau test pour mesurer le temps de basculement réel avant de mettre à niveau l'environnement de production.

Erreur de compte

Format de l'erreur : Invalid superuser account: {*}; Invalid account: {*}; Please see the Alibaba Cloud documentation

Cause : L'instance possède des comptes superutilisateur redondants ou des comptes standard avec des configurations de chiffrement non valides.

Solution :

• Comptes superutilisateur redondants : Soumettez un ticket pour demander la suppression.

• Comptes standard non valides : Réinitialisez les mots de passe des comptes concernés.

Erreur de pré-vérification

Format de l'erreur : pg_upgrade pre-check task failed, need to check [pg_upgrade error log] and [pg_upgrade-related files and errors]

Cause : La tâche de pré-vérification pg_upgrade a échoué.

Solution : Consultez la section du journal des erreurs pg_upgrade dans le rapport de vérification pour identifier et résoudre le problème spécifique.

Erreur d'extension pgcrypto

Format de l'erreur : The pg_crypto extension is installed in schema: pg_catalog in database: {*}, please see the Alibaba Cloud documentation

Cause : L'extension pgcrypto crée des fonctions dans pg_catalog qui n'existent que dans les versions ultérieures de PostgreSQL. Cela entraîne l'échec de la mise à niveau majeure de la version moteur.

Solution : Dans chaque base de données concernée, supprimez l'extension pgcrypto et recréez-la dans un schéma autre que pg_catalog.

Erreur de version mineure (mode zéro temps d'arrêt uniquement)

Format de l'erreur : Zero-downtime major version upgrade requires minimum minor version 20250228

Cause : La version mineure du moteur de l'instance est antérieure à 20250228.

Solution : Mettre à niveau la version mineure du moteur vers la version 20250228 ou ultérieure.

loadable_libraries.txt : extensions incompatibles

Le fichier loadable_libraries.txt répertorie les fichiers de bibliothèque qui ne peuvent pas être chargés par la version cible de PostgreSQL. Chaque bibliothèque correspond généralement à une extension.

Cause : Une ou plusieurs extensions installées sont incompatibles avec la version majeure du moteur cible.

Solution : Vérifiez les extensions listées dans loadable_libraries.txt. Pour chaque extension, vérifiez si votre application en dépend, puis décidez s'il convient de la supprimer avant la mise à niveau. Pour la liste des extensions prises en charge dans chaque version, consultez la rubrique Extensions prises en charge.

Les sections suivantes décrivent les extensions incompatibles les plus courantes.

tables_with_oids.txt : tables avec OIDs

Le fichier tables_with_oids.txt répertorie les tables créées avec la déclaration WITH OIDS . PostgreSQL 12 et versions ultérieures ne prennent pas en charge WITH OIDS .

Cause : Une ou plusieurs tables utilisent la déclaration WITH OIDS , qui n'est pas prise en charge dans la version cible.

Solution :

• Option 1 (recommandée) : Mettez à niveau vers PostgreSQL 11, qui prend toujours en charge WITH OIDS .

• Option 2 : Examinez les tables listées dans tables_with_oids.txt et confirmez que votre application ne dépend pas des valeurs OID. Exécutez ensuite l'instruction suivante pour chaque table concernée :

  ALTER TABLE {table_name} SET WITHOUT OIDS;

Tables étrangères

Format de l'erreur : Foreign tables in database: {0}. Total databases: {1}

Cause : L'instance contient des tables étrangères, que la réplication logique ne peut pas répliquer.

Solution : Supprimez toutes les tables étrangères.

1. Dans chaque base de données, identifiez les tables étrangères :

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

2. Supprimez les tables étrangères :

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

Pour plus d'informations, consultez la documentation PostgreSQL sur DROP FOREIGN TABLE.

Tables sans clé primaire ou unique

Format de l'erreur : Tables without primary key or unique key in database: {0}. Total databases: {1}

Cause : La réplication logique nécessite que chaque table dispose d'une clé primaire, d'une clé unique ou de REPLICA IDENTITY FULL pour identifier les lignes lors de la réplication.

Solution : Ajoutez une clé primaire ou unique à chaque table concernée, ou définissez REPLICA IDENTITY FULL .

1. Dans chaque base de données, identifiez les tables sans clé primaire ou unique :

   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. Définissez REPLICA IDENTITY FULL sur la table (si l'ajout d'une clé n'est pas réalisable) :

   ALTER TABLE name REPLICA IDENTITY FULL;

3. Ou ajoutez une clé primaire ou unique :

   -- 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);

Pour plus d'informations, consultez la documentation PostgreSQL sur les contraintes uniques.

Vues matérialisées

Format de l'erreur : Materialized views in database: {0}. Total databases: {1}

Cause : La réplication logique ne peut pas répliquer les vues matérialisées.

Solution : Supprimez toutes les vues matérialisées.

1. Dans chaque base de données, identifiez les vues matérialisées :

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

2. Supprimez les vues matérialisées :

   DROP MATERIALIZED VIEW IF EXISTS name;

Grands objets

Format de l'erreur : Large objects in database: {0}. Total databases: {1}

Cause : La réplication logique ne peut pas répliquer les grands objets stockés dans pg_largeobject .

Solution : Supprimez les grands objets.

1. Dans chaque base de données, comptez les grands objets :

   SELECT COUNT(*) AS count
   FROM pg_largeobject_metadata;

2. Supprimez chaque grand objet :

   SELECT lo_unlink(largeobject_oid);

Extensions interdites

Format de l'erreur : Logical replication prohibited extensions in database: {0}. Total databases: {1}

Cause : Les extensions suivantes sont incompatibles avec la réplication logique et ne doivent pas être présentes lors d'une mise à niveau en mode zéro temps d'arrêt : pg_partman , pg_cron , pg_active et pglogical .

Solution : Supprimez temporairement les extensions incompatibles.

1. Dans chaque base de données, vérifiez si des extensions interdites sont installées :

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

2. Supprimez chaque extension interdite :

   DROP EXTENSION extension_name;

Exigences de paramètres non satisfaites

Format de l'erreur : 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}

Cause : Un ou plusieurs des paramètres suivants ne répondent pas aux exigences de la réplication logique : wal_level , max_wal_sender ou max_replication_slots .

Solution : Mettez à jour les valeurs des paramètres. Certaines modifications nécessitent un redémarrage pour prendre effet. Pour plus d'informations, consultez la rubrique Définir les paramètres d'une instance.