Comment effectuer une mise à niveau de version majeure RDS pour Postgre SQL

Nous recommandons le processus suivant lorsque vous effectuez une mise à niveau de version majeure sur une SQL base de données Amazon RDS pour Postgre :

Préparez un groupe de paramètres compatible avec la version – Si vous utilisez un groupe de paramètres personnalisé, vous avez deux options. Vous pouvez spécifier un groupe de paramètres par défaut pour la nouvelle version du moteur de base de données. Ou vous pouvez créer votre propre groupe de paramètres personnalisé pour la nouvelle version du moteur de base de données Pour plus d’informations, consultez Groupes de paramètres pour Amazon RDS et Utilisation des groupes de paramètres de clusters de base de données pour les clusters de base de données Multi-AZ.
Vérifiez les classes de base de données non prises en charge : vérifiez que la classe d'instance de votre base de données est compatible avec la SQL version de Postgre vers laquelle vous effectuez la mise à niveau. Pour de plus amples informations, veuillez consulter Moteurs de base de données pris en charge pour les classes d'instance de base de données.
Recherchez une utilisation non prise en charge :
- Transactions préparées – Validez ou restaurez toutes les transactions préparées ouvertes avant d'essayer d'effectuer une mise à niveau.
  
  Vous pouvez utiliser la requête suivante pour vérifier qu'aucune transaction préparée ouverte ne figure sur votre base de données.
```
SELECT count(*) FROM pg_catalog.pg_prepared_xacts;
```
- Types de données Reg* – Supprimez toutes les utilisations des types de données reg* avant d'essayer d'effectuer une mise à niveau. À l'exception de regtype et regclass, vous ne pouvez pas mettre à niveau les types de données reg*. L'pg_upgradeutilitaire ne peut pas conserver ce type de données, qui est utilisé par Amazon RDS pour effectuer la mise à niveau.
  
  Pour vérifier l'absence de toute utilisation des types de données reg* non pris en charge, utilisez la requête suivante pour chaque base de données.
```
SELECT count(*) FROM pg_catalog.pg_class c, pg_catalog.pg_namespace n, pg_catalog.pg_attribute a
  WHERE c.oid = a.attrelid
      AND NOT a.attisdropped
      AND a.atttypid IN ('pg_catalog.regproc'::pg_catalog.regtype,
                         'pg_catalog.regprocedure'::pg_catalog.regtype,
                         'pg_catalog.regoper'::pg_catalog.regtype,
                         'pg_catalog.regoperator'::pg_catalog.regtype,
                         'pg_catalog.regconfig'::pg_catalog.regtype,
                         'pg_catalog.regdictionary'::pg_catalog.regtype)
      AND c.relnamespace = n.oid
      AND n.nspname NOT IN ('pg_catalog', 'information_schema');
                                    
```
Vérifiez la présence de bases de données non valides :
- Assurez-vous qu'aucune base de données n'est invalide. La datconnlimit colonne du pg_database catalogue inclut une valeur de -2 pour marquer comme non valides les bases de données qui ont été interrompues au cours d'une DROP DATABASE opération.
  
  Utilisez la requête suivante pour vérifier la présence de bases de données non valides :
```
SELECT datname FROM pg_database WHERE datconnlimit = - 2;
```
- La requête précédente renvoie des noms de base de données non valides. Vous pouvez l'utiliser DROP DATABASE invalid_db_name; pour supprimer les bases de données non valides. Vous pouvez également utiliser la commande suivante pour supprimer les bases de données non valides :
```
SELECT 'DROP DATABASE ' || quote_ident(datname) || ';' FROM pg_database WHERE datconnlimit = -2 \gexec
```
Pour plus d'informations sur les bases de données non valides, voir Comprendre le comportement d'Autovacuum avec des bases de données non valides.
Traitez les emplacements de réplication logique : une mise à niveau ne peut pas se produire si la base de données possède des emplacements de réplication logique. Les emplacements de réplication logique sont généralement utilisés pour la migration AWS DMS et la réplication de tables de la base de données vers des lacs de données, des outils BI et d'autres cibles. Avant de procéder à la mise à niveau, assurez-vous de connaître l'objectif des emplacements de réplication logique utilisés et confirmez qu'il est possible de les supprimer. Si les emplacements de réplication logique sont toujours utilisés, vous ne devez pas les supprimer et vous ne pouvez pas procéder à la mise à niveau.

Si les emplacements de réplication logiques ne sont pas nécessaires, vous pouvez les supprimer en procédant comme suit SQL :
```
SELECT * FROM pg_replication_slots;
SELECT pg_drop_replication_slot(slot_name);
```
Les installations de réplication logique qui utilisent l'extension pglogical doivent également avoir des emplacements supprimés pour une mise à niveau de version majeure réussie. Pour obtenir des informations sur la façon d'identifier et de supprimer les emplacements créés à l'aide de l'extension pglogical, consultez Gestion des emplacements de réplication logiques pour SQL.
Traitez les réplicas en lecture : une mise à niveau d'une instance de base de données mono-AZ ou d'un déploiement d'instance de base de données multi-AZ met également à niveau les réplicas en lecture dans la région ainsi que l'instance de base de données principale. Amazon RDS ne met pas à niveau les répliques de lecture des clusters de bases de données multi-AZ.

Vous ne pouvez pas mettre à niveau les réplicas en lecture séparément. Si vous le pouviez, cela pourrait entraîner des situations dans lesquelles les bases de données principale et répliquée ont des versions SQL majeures de Postgre différentes. Toutefois, les mises à niveau de réplica en lecture peuvent augmenter les temps d'arrêt sur l'instance de base de données principale. Pour éviter la mise à niveau d'un réplica en lecture, promouvez le réplica en instance autonome ou supprimez-le avant de démarrer le processus de mise à niveau.

Le processus de mise à niveau recrée le groupe de paramètres du réplica en lecture en fonction du groupe de paramètres actuel du réplica en lecture. Vous pouvez appliquer un groupe de paramètres personnalisé à un réplica en lecture uniquement une fois la mise à niveau terminée en modifiant le réplica en lecture. Pour plus d'informations sur les réplicas en lecture, consultez Utilisation de répliques de lecture pour Amazon RDS pour Postgre SQL.
Effectuez une sauvegarde – Nous vous recommandons d'effectuer une sauvegarde avant d'effectuer la mise à niveau de version majeure, afin de disposer d'un point de restauration connu pour votre base de données. Si la période de conservation des sauvegardes est supérieure à 0, le processus de mise à niveau crée des instantanés de base de données de votre base de données avant et après la mise à niveau. Pour modifier la période de rétention des sauvegardes, consultez Modification d'une RDS instance de base de données Amazon et Modification d'un cluster de base de données multi-AZ pour Amazon RDS.

Pour effectuer une sauvegarde manuellement, consultez Création d'un instantané de base de données pour une instance de base de données mono-AZ pour Amazon RDS et Création d'un instantané de cluster de base de données multi-AZ pour Amazon RDS.
Mise à niveau de certaines extensions avant une mise à niveau de version majeure – Si vous envisagez d'omettre une version majeure avec la mise à niveau, vous devez mettre à jour certaines extensions avant d'effectuer la mise à niveau de version majeure. Par exemple, la mise à niveau des versions 9.5.x ou 9.6.x vers une version 11.x entraîne une omission de la version majeure. Les extensions à mettre à jour incluent Post GIS et les extensions associées pour le traitement des données spatiales.
- address_standardizer
- address_standardizer_data_us
- postgis_raster
- postgis_tiger_geocoder
- postgis_topology
Exécutez la commande suivante pour chaque extension que vous utilisez :
```
ALTER EXTENSION PostgreSQL-extension UPDATE TO 'new-version';
```
Pour de plus amples informations, veuillez consulter Mise à niveau des SQL extensions Postgre RDS pour les bases de données SQL Postgre. Pour en savoir plus sur la mise à niveau de PostGIS, consultezÉtape 6 : mise à niveau de l'GISextension Post.
Supprimez certaines extensions avant une mise à niveau de version majeure – Une mise à niveau qui omet une version majeure pour passer directement à la version 11.x ne prend pas en charge la mise à jour de l'extension pgRouting. La mise à niveau des versions 9.4.x, 9.5.x ou 9.6.x vers les versions 11.x entraîne l'omission d'une version majeure. Il est plus sûr de supprimer l'extension pgRouting puis de la réinstaller sur une version compatible une fois la mise à niveau effectuée. Pour connaître les versions d'extension vers lesquelles vous pouvez effectuer une mise à jour, veuillez consulter Versions d'SQLextension Postgre prises en charge.

Les chkpass extensions tsearch2 et ne sont plus prises en charge pour les SQL versions 11 ou ultérieures de Postgre. Si vous effectuez une mise à niveau vers la version 11.x, supprimez les extensions tsearch2 et chkpass avant la mise à niveau.
Supprimer les types de données inconnus – Supprimez les types de données unknown en fonction de la version cible.

La SQL version 10 de Postgre a cessé de prendre en charge le type unknown de données. Si une base de données version 9.6 utilise le type de données unknown, une mise à niveau vers une version 10 affiche un message d'erreur tel que :
```
Database instance is in a state that cannot be upgraded: PreUpgrade checks failed:
The instance could not be upgraded because the 'unknown' data type is used in user tables.
Please remove all usages of the 'unknown' data type and try again."
```
Pour trouver le type de unknown données dans votre base de données afin de supprimer la colonne incriminée ou de la remplacer par un type de données compatible, utilisez ce qui suit : SQL
```
SELECT DISTINCT data_type FROM information_schema.columns WHERE data_type ILIKE 'unknown';
```
Réalisez un essai de mise à niveau – Nous vous recommandons fortement de tester la mise à niveau de version majeure sur un doublon de votre base de données de production avant d'essayer d'effectuer la mise à niveau sur votre base de données de production. Vous pouvez surveiller les plans d'exécution sur la base de données de test dupliquée pour détecter d'éventuelles régressions du plan d'exécution et évaluer ses performances. Pour créer une instance de test dupliquée, vous pouvez soit restaurer votre base de données à partir d'un instantané récent, soit point-in-time restaurer votre base de données à sa date de restauration la plus récente.

Pour plus d’informations, consultez Restaurer à partir d'un instantané ou Restauration d'une instance de base de données à une heure spécifiée pour Amazon RDS. Pour les clusters de bases de données multi-AZ, consultez Restauration d'un instantané dans un cluster de base de données multi-AZ ou Restauration d'un cluster de base de données multi-AZ à une date définie.

Pour en savoir plus sur la procédure de mise à niveau, consultez Mise à niveau manuelle de la version du moteur.

Lors de la mise à niveau d'une base de données de la version 9.6 vers la version 10, sachez que Postgre SQL 10 active les requêtes parallèles par défaut. Vous pouvez tester l'impact du parallélisme avant la mise à niveau en modifiant le paramètre max_parallel_workers_per_gather sur votre base de données de test et en spécifiant 2.

Note
La valeur par défaut du paramètre max_parallel_workers_per_gather dans le groupe de paramètres de base de données default.postgresql10 est 2.

Pour plus d'informations, consultez Parallel Query dans la SQL documentation Postgre. Pour désactiver le parallélisme sur la version 10, définissez le paramètre max_parallel_workers_per_gather sur 0.

Durant la mise à niveau de version majeure, les bases de données public et template1, ainsi que le schéma public figurant dans chaque base de données, sont renommés temporairement. Ces objets apparaissent dans les journaux avec leur nom d'origine et une chaîne aléatoire ajoutée. Cette chaîne est ajoutée afin que les paramètres personnalisés tels que locale et owner soient conservés au cours de la mise à niveau de version majeure. À la fin de la mise à niveau, les objets reprennent leurs noms d'origine.

Note
Pendant le processus de mise à niveau de la version majeure, vous ne pouvez pas point-in-time restaurer votre instance de base de données ou votre cluster de base de données multi-AZ. Une fois qu'Amazon a effectué la mise à niveau, il RDS effectue une sauvegarde automatique de la base de données. Vous pouvez effectuer une point-in-time restauration avant le début de la mise à niveau et une fois la sauvegarde automatique de votre base de données terminée.
Si une mise à niveau échoue en raison d'erreurs liées à la procédure de prévérification, résolvez les problèmes. Au cours du processus de mise à niveau de la version majeure, Amazon RDS pour Postgre exécute d'SQLabord une procédure de prévérification afin d'identifier les problèmes susceptibles d'entraîner l'échec de la mise à niveau. Le procédure de pré-vérification recherche les éventuelles conditions d'incompatibilité entre toutes les bases de données de l'instance.

Si la pré-vérification détecte un problème, elle crée un événement de journal indiquant l'échec de la pré-vérification de mise à niveau. Les détails de la procédure de pré-vérification se trouvent dans un journal de mise à niveau nommé pg_upgrade_precheck.log pour toutes les bases de données d'une base de données. Amazon RDS ajoute un horodatage au nom du fichier. Pour de plus amples informations sur l'affichage des journaux, veuillez consulter Surveillance des fichiers journaux RDSAmazon.

Si la mise à niveau d'un réplica en lecture échoue au stade de la vérification préalable, la réplication sur le réplica en lecture défaillant est interrompue et le réplica en lecture est mis à l'état résilié. Supprimez le réplica en lecture et recréez un nouveau réplica en lecture basé sur l'instance de base de données principale mise à niveau.

Résolvez tous les problèmes identifiés dans le journal de pré-vérification puis relancez la mise à niveau de version majeure. Voici un exemple de journal de pré-vérification.
```
------------------------------------------------------------------------
Upgrade could not be run on Wed Apr 4 18:30:52 2018
-------------------------------------------------------------------------
The instance could not be upgraded from 9.6.11 to 10.6 for the following reasons.
Please take appropriate action on databases that have usage incompatible with the requested major engine version upgrade and try the upgrade again.

* There are uncommitted prepared transactions. Please commit or rollback all prepared transactions.* One or more role names start with 'pg_'. Rename all role names that start with 'pg_'.

* The following issues in the database 'my"million$"db' need to be corrected before upgrading:** The ["line","reg*"] data types are used in user tables. Remove all usage of these data types.
** The database name contains characters that are not supported by RDS for PostgreSQL. Rename the database.
** The database has extensions installed that are not supported on the target database version. Drop the following extensions from your database: ["tsearch2"].

* The following issues in the database 'mydb' need to be corrected before upgrading:** The database has views or materialized views that depend on 'pg_stat_activity'. Drop the views.
```
Si une mise à niveau de réplica en lecture échoue lors de la mise à niveau de la base de données, résolvez le problème : un réplica en lecture ayant échoué obtient le statut incompatible-restore et la réplication est arrêtée sur la base de données. Supprimez le réplica en lecture et recréez un nouveau réplica en lecture basé sur l'instance de base de données principale mise à niveau.

Note
Amazon RDS ne met pas à niveau les répliques de lecture pour les clusters de bases de données multi-AZ. Si vous effectuez une mise à niveau de version majeure sur un cluster de base de données multi-AZ, l'état de réplication de ses répliques de lecture devient terminé.

Une mise à niveau de réplica en lecture peut échouer pour les raisons suivantes :
- Elle n'a pas pu s'aligner sur l'instance de base de données principale même après un temps d'attente.
- Elle était dans un état de mise hors service ou de cycle de vie incompatible, tel que storage-full, incompatible-restore, etc.
- Lorsque la mise à niveau de l'instance de base de données principale a démarré, une mise à niveau de version mineure distincte était en cours d'exécution sur le réplica en lecture.
- Le réplica en lecture utilisait des paramètres incompatibles.
- Le réplica en lecture n'a pas pu communiquer avec l'instance de base de données principale pour synchroniser le dossier de données.
Mettez à niveau votre base de données de production : quand l'essai de mise à niveau de version majeure est un succès, vous devez être en mesure de mettre à niveau en toute confiance votre base de données de production. Pour de plus amples informations, veuillez consulter Mise à niveau manuelle de la version du moteur.
Exécutez l'opération ANALYZE pour actualiser la table pg_statistic. Vous devez le faire pour chaque base de données de toutes vos SQL bases de données Postgre. Les statistiques de l'optimiseur ne sont pas transférées lors d'une mise à niveau majeure de la version. Vous devez donc régénérer toutes les statistiques pour éviter les problèmes de performances. Exécutez la commande sans paramètres pour générer des statistiques pour toutes les tables normales de la base de données actuelle, comme suit :
```
ANALYZE VERBOSE;
```
L'indicateur VERBOSE est facultatif, mais son utilisation vous montre la progression. Pour plus d'informations, consultez ANALYZEla SQL documentation Postgre.

Note
Exécutez-le ANALYZE sur votre système après la mise à niveau pour éviter les problèmes de performances.

Une fois la mise à niveau de version majeure effectuée, nous vous recommandons d'effectuer les tâches suivantes :

Une SQL mise à niveau de Postgre ne met à jour aucune extension PostgreSQL. Pour mettre à niveau les extensions, veuillez consulter Mise à niveau des SQL extensions Postgre RDS pour les bases de données SQL Postgre.
Vous pouvez éventuellement utiliser Amazon RDS pour afficher deux journaux produits par l'pg_upgradeutilitaire. Il s'agit des journaux pg_upgrade_internal.log et pg_upgrade_server.log. Amazon RDS ajoute un horodatage au nom de fichier de ces journaux. Vous pouvez consultez ces journaux comme tout autre journal. Pour de plus amples informations, veuillez consulter Surveillance des fichiers journaux RDSAmazon.

Vous pouvez également télécharger les journaux de mise à niveau sur Amazon CloudWatch Logs. Pour de plus amples informations, veuillez consulter Publier des SQL logs Postgre sur Amazon CloudWatch Logs.
Pour vérifier si tout fonctionne comme prévu, testez votre application sur la base de données mise à niveau avec une charge de travail similaire. Une fois la mise à niveau vérifiée, vous pouvez supprimer l'instance de test.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Choix d'une mise à niveau de version majeure

Mises à niveau automatiques des versions mineures

Comment effectuer une mise à niveau de version majeure RDS pour Postgre SQL

Note

Note

Note

Note