Mise à niveau du moteur de base de données PostgreSQL pour Amazon RDS - Amazon Relational Database Service

Mise à niveau du moteur de base de données PostgreSQL pour Amazon RDS

Vous pouvez gérer deux types de mises à niveau pour votre instance de base de données PostgreSQL:

  • Mises à jour du SE – Il peut arriver que Amazon RDS doive mettre à jour le système d'exploitation sous-jacent de votre instance de base de données afin d'appliquer des correctifs de sécurité ou des modifications du SE. Vous pouvez décider quand Amazon RDS doit appliquer les mises à jour du système d'exploitation à l'aide de la console RDS, de l'AWS Command Line Interface (AWS CLI) ou de l'API RDS. Pour plus d'informations sur les mises à jour de SE, consultez Application des mises à jour pour une instance de base de données.

  • Mises à niveau de moteur de base de données – Lorsque Amazon RDS prend en charge une nouvelle version d'un moteur de base de données, vous pouvez mettre à niveau vos instances de base de données vers cette nouvelle version.

Lorsque Amazon RDS prend en charge une nouvelle version d'un moteur de base de données, vous pouvez mettre à niveau vos instances de base de données vers cette nouvelle version. Il existe deux types de mises à niveau pour les instances de base de données PostgreSQL : les mises à niveau de version majeure et les mises à niveau de version mineure.

Mises à niveau de version majeure.

Les mises à niveau de version majeure peuvent contenir des modifications de base de données qui ne sont pas rétrocompatibles avec les applications existantes. En conséquence, vous devez effectuer manuellement les mises à niveau de version majeure de vos instances de base de données. Vous pouvez lancer une mise à niveau de version majeure en modifiant votre instance de base de données. Cependant, avant d'effectuer une mise à niveau de version majeure, nous vous recommandons de suivre les étapes décrites dans Choix d'une mise à niveau de version majeure pour PostgreSQL . Lors d'une mise à niveau de version majeure, Amazon RDS met également à niveau tous vos réplicas en lecture dans la région ainsi que l'instance de base de données principale.

Mises à niveau de version mineure.

En revanche, une mise à niveau de version mineure contient uniquement des modifications rétrocompatibles avec les applications existantes. Vous pouvez lancer manuellement une mise à niveau de version mineure en modifiant votre instance de base de données. Vous pouvez également activer l'option Mise à niveau automatique des versions mineures lorsque vous créez ou modifiez une instance de base de données. Dans ce cas, votre instance de base de données est automatiquement mise à niveau une fois que Amazon RDS a testé et approuvé la nouvelle version. Si votre instance de base de données PostgreSQL utilise des réplicas en lecture, vous devez d'abord mettre à niveau tous les réplicas en lecture avant de mettre à niveau l'instance principale. Si votre instance de base de données se trouve dans un déploiement multi-AZ, les réplicas d'écriture et de secours doivent tous deux être mis à niveau simultanément. Par conséquent, votre instance de base de données peut ne pas être disponible tant que la mise à niveau n'est pas terminée. Pour en savoir plus, consultez Mises à niveau automatiques des versions mineures pour PostgreSQL. Pour de plus amples informations sur l'exécution manuelle d'une mise à niveau de version mineure, veuillez consulter Mise à niveau manuelle de la version du moteur.

Pour plus d'informations sur les versions de moteur de base de données et sur la politique en matière d'obsolescence des versions de moteur de base de données, consultez la section Versions du moteur de base de données dans les questions fréquentes (FAQ) sur Amazon RDS.

Présentation de la mise à niveau de PostgreSQL

Pour mettre à niveau vos instances de base de données en toute sécurité, Amazon RDS utilise l'utilitaire pg_upgrade décrit dans la documentation PostgreSQL.

Lorsque vous utilisez AWS Management Console pour mettre à niveau une instance de base de données, les cibles de mise à niveau valides pour l'instance de base de données sont affichées. Vous pouvez également utiliser la commande AWS CLI suivante pour identifier les cibles de mise à niveau valides pour une instance de base de données :

Pour Linux, macOS ou Unix :

aws rds describe-db-engine-versions \ --engine postgres \ --engine-version version-number \ --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text

Pour Windows :

aws rds describe-db-engine-versions ^ --engine postgres ^ --engine-version version-number ^ --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text

Par exemple, pour identifier les cibles de mise à niveau valides pour une instance de base de données PostgreSQL version 10.11, exécutez la commande AWS CLI suivante :

Pour Linux, macOS ou Unix :

aws rds describe-db-engine-versions \ --engine postgres \ --engine-version 10.11 \ --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text

Pour Windows :

aws rds describe-db-engine-versions ^ --engine postgres ^ --engine-version 10.11 ^ --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text

Si votre période de rétention des sauvegardes est supérieure à 0, Amazon RDS crée deux instantanés de base de données pendant la mise à niveau. Le premier instantané de base de données porte sur l'instance de base de données avant que toute modification de mise à niveau soit apportée. Si la mise à niveau ne fonctionne pas pour vos bases de données, vous pouvez restaurer cet instantané pour créer une instance de base de données exécutant l'ancienne version. Le second instantané de base de données est pris à la fin de la mise à niveau.

Note

Amazon RDS ne prend des instantanés de base de données pendant le processus de mise à niveau que si vous avez défini la période de rétention des sauvegardes de votre instance de base de données sur un nombre supérieur à 0. Pour modifier la période de rétention des sauvegardes, consultez Modification d'une instance de base de données Amazon RDS.

Lorsque vous mettez à niveau vers une version majeure de l'instance de base de donnée principale, tous les réplicas en lecture dans la région sont également automatiquement mis à niveau. Une fois que le flux de mise à niveau a démarré, les réplicas en lecture attendent que pg_upgrade se termine correctement sur l'instance de base de données principale. Ensuite, la mise à niveau de l'instance de base de données principale attend que les mises à niveau du réplica en lecture se terminent. Vous faites face à une panne tant que la mise à niveau n'est pas terminée.

Si votre instance de base de données se trouve dans un déploiement multi-AZ, l'instance de base de données enregistreur principale et l'instance de secours sont toutes deux mises à niveau. Les instances de base de données enregistreur et de secours sont mises à niveau en même temps.

Une fois une mise à niveau terminée, vous ne pouvez pas rétablir la version précédente du moteur de base de données. Si vous souhaitez revenir à la version précédente, restaurez l'instantané de base de données pris avant la mise à niveau pour créer une nouvelle instance de base de données.

Numéros de version PostgreSQL

La séquence de numérotation des versions du moteur de base de données PostgreSQL est la suivante :

  • Pour les versions 10 et ultérieures de PostgreSQL, le format du numéro de version du moteur est majeure.mineure. Le numéro de version majeure est la partie entière du numéro de version. Le numéro de version mineure est la partie fractionnaire du numéro de version.

    Une mise à niveau de version majeure augmente la partie entière du numéro de version, par exemple la mise à niveau de 10.mineure à 11.mineure.

  • Pour les versions de PostgreSQL antérieures à 10, le format du numéro de version du moteur est majeure.majeure.mineure. Le numéro de version majeure du moteur est à la fois l'entier et la première partie fractionnaire du numéro de version. Par exemple, 9.6 est une version majeure. Le numéro de version mineure est la troisième partie du numéro de version. Par exemple, pour la version 9.6.12, le numéro 12 est le numéro de version mineure.

    Une mise à niveau majeure augmente la partie majeure du numéro de version. Par exemple, une mise à niveau de la version 9.6.12 vers la version 10.11 est une mise à niveau de version majeure, 9.6 et 10 étant les numéros de version majeure.

Choix d'une mise à niveau de version majeure pour PostgreSQL

Les mises à niveau de versions majeures peuvent contenir des modifications qui ne sont pas rétrocompatibles avec les versions précédentes de la base de données. Les nouvelles fonctionnalités peuvent empêcher vos applications existantes de fonctionner correctement. Pour cette raison, Amazon RDS n'applique pas automatiquement les mises à niveau des versions majeures. Pour effectuer une mise à niveau de version majeure, modifiez votre instance de base de données manuellement. Veillez à tester soigneusement toute mise à niveau pour vérifier que vos applications fonctionnent correctement avant d'appliquer la mise à niveau à vos instances de base de données de production. Lorsque vous effectuez une mise à niveau de version majeure de PostgreSQL, nous vous recommandons de suivre les étapes décrites dans Comment effectuer une mise à niveau de version majeure.

Lorsque vous mettez à niveau une instance de base de données PostgreSQL vers sa prochaine version majeure, tous les réplicas en lecture associés à l'instance de base de données sont également mis à niveau vers cette prochaine version majeure. Dans certains cas, vous pouvez passer à une version majeure ultérieure lors de la mise à niveau. Si votre mise à niveau ignore une version majeure, les réplicas en lecture sont également mis à niveau vers cette version majeure cible. Les mises à niveau vers la version 11 qui sautent d'autres versions majeures présentent certaines limitations. Vous trouverez les détails dans les étapes décrites dans la section Comment effectuer une mise à niveau de version majeure.

La plupart des extensions PostgreSQL ne sont pas mises à jour lors d'une mise à niveau du moteur PostgreSQL. Elles doivent être mises à niveau séparément. Pour plus d'informations, consultez Mise à niveau des extensions PostgreSQL.

Vous pouvez découvrir quelles versions majeures sont disponibles pour votre instance de base de données RDS for PostgreSQL en exécutant la requête AWS CLI suivante :

aws rds describe-db-engine-versions --engine postgres --engine-version your-version --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text

Le tableau suivant récapitule les résultats de cette requête pour toutes les versions disponibles. Un astérisque (*) sur le numéro de version signifie que la version est obsolète. Si votre version actuelle est obsolète, nous vous recommandons d'effectuer une mise à niveau vers la cible de mise à niveau de la version mineure la plus récente ou vers l'une des autres cibles de mise à niveau disponibles pour cette version. Pour plus d'informations sur la dépréciation de RDS pour PostgreSQL 9.6, veuillez consulter Obsolescence de PostgreSQL version 9.6.

Version actuelle de la source (*obsolète) Cible de mise à niveau de la version mineure la plus récente Cible de mise à niveau de la version majeure la plus récente Autres objectifs de mise à niveau disponibles
14.1 14.2
13.6 14.2
13,5 14.2 14.1 13.6
13.4 14.2 14.1 13.6 13,5
13.3 14.2 14.1 13.6 13,5 13.4
13.2*, 13.1* 13.6 14.2 14.1 13,5 13.4 13.3
12.10 14.2 13.6
12.9 14.1 13.6 13,5 12.10
12.8 13.6 13,5 13.4 12.10 12.9
12.7 13.6 13,5 13.4 13.3 12.10 12.9 12.8
12.6*, 12.5*, 12.4*, 12.3*, 12.2*, 12.1* 12.10 14.2 13.6 12.9 12.8 12.7
11.15 14.2 13.6 12.10
11.14 14.1 13,5 12.10 12.9 11.15
11.13 13.4 12.10 12.9 12.8 11.15 11.14
11.12 13.3 12.10 12.9 12.8 12.7 11.15 11.14 11.13
11.11*,11.11*, 11.10*, 11.9*, 11.8*, 11.7*, 11.6*, 11.5*, 11.4*, 11.2, 11.1* 11.15 14.2 13.6 12.10 11.14 11.13 11.12
10.20 14.2 13.6 12.10 11.15
10.19 14.1 13,5 12.9 11.15 11.14 10.20
10.18 13.4 12.8 11.15 11.14 11.13 10.20 10.19
10.17 13.3 12.7 11.15 11.14 11.13 11.12 10.20 10.19 10.18
10.16*, 10.15*, 10.14*, 10.13*, 10.12*, 10.11*, 10.10*, 10.9*, 10.7*, 10.6*, 10.5*, 10.4*, 10.3*, 10.1* 10.20 14.2 13.6 12.10 11.15 10.19 10.18 10.17
9.6.24 14.1 13,5 12.9 11.14 10.20 10.19
9.6.23 13.4 12.8 11.13 10.20 10.19 10.18 9.6.24
9.6.22 13.3 12.7 11.12 10.20 10.19 10.18 10.17 9.6.24 9.6.23
9.6.19*, 9.6.18*, 9.6.17*, 9.6.16*, 9.6.15*, 9.6.14*, 9.6.12*, 9.6.11*9.6.10*, 9.6.9*, 9.6.8*, 9.6.6*, 9.6.5*, 9.6.3*, 9.6.2*, 9.6.1* 9.6.24 14.1 13,5 12.9 11.14 10.20 10.19 9.6.23 9.6.22

Comment effectuer une mise à niveau de version majeure

Nous vous recommandons de suivre le processus ci-dessous lors de la mise à niveau d'une instance de base de données PostgreSQL Amazon RDS :

  1. 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 Utilisation des groupes de paramètres

  2. Vérifiez les classes d'instance 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 version PostgreSQL vers laquelle vous effectuez la mise à niveau. Pour plus d'informations, consultez Moteurs de base de données pris en charge pour les classes d'instance de base de données.

  3. 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 instance.

      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'utilitaire pg_upgrade 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');

  4. Gestion des emplacements de réplication logique : une mise à niveau ne peut pas se produire si l'instance possède des emplacements de réplication logiques. 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 logique ne sont pas nécessaires, vous pouvez les supprimer à l'aide du code SQL suivant :

    SELECT * FROM pg_replication_slots; SELECT pg_drop_replication_slot(slot_name);
  5. Gérer les réplicas en lecture – Une mise à niveau met également à niveau les réplicas en lecture dans la région ainsi que l'instance de base de données principale.

    Vous ne pouvez pas mettre à niveau les réplicas en lecture séparément. Si vous le pouviez, cela pourrait générer des situations où les instances de base de données principales et les réplicas auraient des versions majeures différentes de PostgreSQL. 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.

    Les réplicas en lecture sur la plateforme de cloud privé virtuel (VPC) sont mis à niveau, mais les réplicas sur la plateforme EC2-Classic ne sont pas mis à niveau. Tous les réplicas EC2-Classic gardent l'état de réplication résiliée une fois le processus de mise à niveau terminé. Pour déplacer une instance de base de données de la plateforme EC2-Classic vers un VPC, veuillez consulter Déplacement vers un VPC d'une instance de base de données n'appartenant pas à un VPC. Pour plus d'informations sur les réplicas en lecture, consultez Utilisation de réplicas en lecture pour Amazon RDS for PostgreSQL.

  6. 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 rétention des sauvegardes est supérieure à 0, le processus de mise à niveau crée des instantanés de base de données de votre instance de 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 instance de base de données Amazon RDS. Pour effectuer une sauvegarde manuellement, consultez Création d'un instantané de base de données.

  7. 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. 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 :

    • address_standardizer

    • address_standardizer_data_us

    • postGIS

    • 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 plus d'informations, consultez Mise à niveau des extensions PostgreSQL.

  8. 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 une omission de la 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 de l'extension PostgreSQL prises en charge.

    Les extensions tsearch2 et chkpass ne sont plus prises en charge pour PostgreSQL versions 11 ou ultérieures. Si vous effectuez une mise à niveau vers la version 11.x, supprimez les extensions tsearch2 et chkpass avant la mise à niveau.

  9. Supprimer les types de données inconnus – Supprimez les types de données unknown en fonction de la version cible.

    PostgreSQL version 10 a cessé de prendre en charge le type de données unknown. 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 rechercher le type de données unknown dans votre base de données afin de pouvoir supprimer la colonne incriminée ou la remplacer par un type de données pris en charge, utilisez le code SQL suivant :

    SELECT DISTINCT data_type FROM information_schema.columns WHERE data_type ILIKE 'unknown';
  10. 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. Pour créer un doublon d'instance de test, vous pouvez restaurer votre base de données à partir d'un instantané récent ou réaliser une restauration de votre base de données à sa date de restauration possible la plus récente. Pour de plus amples informations, veuillez consulter Restaurer à partir d'un instantané ou Restauration d'une instance de base de données à une date spécifiée. 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 instance de base de données version 9.6 vers la version 10, sachez que PostgreSQL 10 active les requêtes parallèles par défaut. Vous pouvez tester l'impact du parallélisme avant la mise à niveau en passant le paramètre max_parallel_workers_per_gather sur votre instance de base de données de test à 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 de plus amples informations, veuillez consulter Parallel Query dans la documentation PostgreSQL. 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 de l'instance, 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

    Au cours du processus de mise à niveau de version majeure, vous ne pouvez pas effectuer de restauration à un moment donné de votre instance. Après avoir effectué la mise à niveau, Amazon RDS réalise une sauvegarde automatique de l'instance. Vous pouvez effectuer une restauration à un moment donné pour revenir à un moment antérieur au début de la mise à niveau et postérieur à la sauvegarde automatique de votre instance.

  11. Résolvez les problèmes si une mise à niveau échoue avec des erreurs de procédure de pré-vérification – Au cours du processus de mise à niveau de version majeure, Amazon RDS for PostgreSQL exécute d'abord une procédure de pré-vérification pour identifier les éventuels problèmes pouvant provoquer un é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 instance de 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 Amazon RDS.

    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.
  12. 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 en échec est placé à l'état incompatible-restore et la réplication est arrêtée sur l'instance de 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.

    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.

  13. Mettez à niveau votre instance de production – Si 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 plus d'informations, consultez Mise à niveau manuelle de la version du moteur.

  14. 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 instances de base de données PostgreSQL. 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 en savoir plus, veuillez consulter ANALYZE dans la documentation PostgreSQL.

    Note

    Exécutez 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 mise à niveau de PostgreSQL ne met à niveau aucune extension PostgreSQL. Pour mettre à niveau les extensions, veuillez consulter Mise à niveau des extensions PostgreSQL.

  • Vous pouvez utiliser Amazon RDS pour afficher deux journaux produits par l'utilitaire pg_upgrade. 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 plus d'informations, consultez Surveillance des fichiers journaux Amazon RDS.

    Vous pouvez également charger les journaux de mise à niveau dans Amazon CloudWatch Logs. Pour plus d'informations, consultez Publication des journaux PostgreSQL dans 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.

Mises à niveau automatiques des versions mineures pour PostgreSQL

Si vous activez l'option Mise à niveau automatique des versions mineures au moment de créer ou modifier une instance de base de données, votre instance de base de données peut être mise à niveau automatiquement.

Pour chaque version majeure de RDS for PostgreSQL, une seule version mineure est désignée par RDS comme étant la version de mise à niveau automatique. Une fois qu'une version mineure a été testée et approuvée par Amazon RDS, la mise à niveau de la version mineure se produit automatiquement pendant votre fenêtre de maintenance. RDS ne définit pas automatiquement les dernières versions mineures publiées comme version de mise à niveau automatique. Avant de désigner une publication de version récente comme version de mise à niveau automatique, RDS prend en compte plusieurs critères, à savoir :

  • Problèmes de sécurité connus

  • Bogues dans la version de la communauté PostgreSQL

  • Stabilité globale du parc depuis la publication de la version mineure

Vous pouvez utiliser la commande AWS CLI suivante pour déterminer la version cible de mise à niveau mineure automatique actuelle pour une version mineure de PostgreSQL spécifiée dans une région AWS déterminée.

Pour Linux, macOS ou Unix :

aws rds describe-db-engine-versions \ --engine postgres \ --engine-version minor-version \ --region region \ --query "DBEngineVersions[*].ValidUpgradeTarget[*].{AutoUpgrade:AutoUpgrade,EngineVersion:EngineVersion}" \ --output text

Pour Windows :

aws rds describe-db-engine-versions ^ --engine postgres ^ --engine-version minor-version ^ --region region ^ --query "DBEngineVersions[*].ValidUpgradeTarget[*].{AutoUpgrade:AutoUpgrade,EngineVersion:EngineVersion}" ^ --output text

Par exemple, la commande AWS CLI suivante détermine la cible de mise à niveau mineure automatique pour la version mineure 10.11 de PostgreSQL dans la région AWS USA Est (Ohio) (us-east-2).

Pour Linux, macOS ou Unix :

aws rds describe-db-engine-versions \ --engine postgres \ --engine-version 10.11 \ --region us-east-2 \ --query "DBEngineVersions[*].ValidUpgradeTarget[*].{AutoUpgrade:AutoUpgrade,EngineVersion:EngineVersion}" \ --output table

Pour Windows :

aws rds describe-db-engine-versions ^ --engine postgres ^ --engine-version 10.11 ^ --region us-east-2 ^ --query "DBEngineVersions[*].ValidUpgradeTarget[*].{AutoUpgrade:AutoUpgrade,EngineVersion:EngineVersion}" ^ --output table

Votre sortie est similaire à ce qui suit.

---------------------------------- | DescribeDBEngineVersions | +--------------+-----------------+ | AutoUpgrade | EngineVersion | +--------------+-----------------+ | False | 10.12 | | False | 10.13 | | False | 10.14 | | False | 10.15 | | False | 10.16 | | True | 10.17 | | False | 10.18 | | False | 11.6 | | False | 11.7 | | False | 11.8 | | False | 11.9 | | False | 11.10 | | False | 11.11 | | False | 11.12 | | False | 11.13 | +--------------+-----------------+

Dans cet exemple, la valeur de AutoUpgrade est True pour PostgreSQL version 10.17. Ainsi, la cible de mise à niveau mineure automatique est la version 10.17 de PostgreSQL, comme indiqué dans la sortie.

Une instance de base de données PostgreSQL est automatiquement mise à niveau pendant votre fenêtre de maintenance si les critères suivants sont réunis :

  • L'option Mise à niveau automatique des versions mineures est activée pour l'instance de base de données.

  • L'instance de base de données exécute une version mineure du moteur de base de données qui est inférieure à la version mineure de la mise à niveau automatique actuelle.

Pour plus d'informations, consultez Mise à niveau automatique de la version mineure du moteur.

Note

Une mise à niveau de PostgreSQL ne met pas à niveau les extensions PostgreSQL. Pour mettre à niveau les extensions, veuillez consulter Mise à niveau des extensions PostgreSQL.

Mise à niveau des extensions PostgreSQL

Une mise à niveau du moteur PostgreSQL ne met pas à niveau la plupart des extensions PostgreSQL. Pour mettre à jour une extension après une mise à niveau de version, utilisez la commande ALTER EXTENSION UPDATE.

Note

Pour l'extension PostGIS, veillez à suivre les instructions de mise à niveau PostGIS de la documentation PostGIS avant de mettre à jour l'extension. Pour l'extension pg_repack, supprimez l'extension, puis créez la nouvelle version dans l'instance de base de données mise à niveau. Pour plus d'informations, veuillez consulter pg_repack installation dans la documentation pg_repack.

Pour mettre à niveau une extension, utilisez la commande suivante.

ALTER EXTENSION extension_name UPDATE TO 'new_version'

Pour voir la liste des versions prises en charge des extensions PostgreSQL, consultez Versions de l'extension PostgreSQL prises en charge.

Pour afficher une liste des extensions actuellement installées, utilisez le catalogue pg_extension PostgreSQL dans la commande suivante.

SELECT * FROM pg_extension;

Pour afficher une liste des versions d'extensions spécifiques disponibles pour votre installation, utilisez la vue pg_available_extension_versions PostgreSQL dans la commande suivante.

SELECT * FROM pg_available_extension_versions;