Mise à niveau vers une nouvelle version majeure

Choisissez une voie de mise à niveau :

Pour les deux derniers chemins, le nouveau déploiement ne reçoit pas les modifications qui parviennent à la source après la promotion ou après la sauvegarde. Testez et validez d'abord la nouvelle version. Avant la bascule définitive, interrompez les écritures sur la source. Ensuite, activez la réplique ou effectuez la sauvegarde, puis modifiez les paramètres de connexion de votre application pour qu'ils pointent vers le nouveau déploiement.

Retrouvez les versions disponibles pour les nouveaux déploiements dans le catalogue, avec ibmcloud cdb deployables-show, ou via l'API /deployables.

Dans les exemples d'API, remplacez {region} par la région du déploiement, {id} par le nom de ressource cloud (CRN) du déploiement encodé en URL, et <IAM_TOKEN> par votre jeton d'accès IAM ( Identity and Access Management ).

Conditions requises pour la mise à niveau

Compatibilité des applications

Testez le parcours de mise à niveau que vous avez choisi sur un environnement de préproduction représentatif avant le déploiement en production. Pour effectuer un test IPMVU, restaurez une sauvegarde récente vers la version source d' PostgreSQL. Un déploiement comporte deux ou trois nœuds de données : le nœud principal et un ou deux nœuds de haute disponibilité (HA). Adaptez le déploiement restauré au même nombre de nœuds que celui de l'environnement de production, car la phase de conversion prend plus de temps lorsque le nombre de nœuds HA est plus élevé. Assurez-vous que le déploiement restauré dispose d'une sauvegarde complète, puis mettez-le à niveau vers la version souhaitée. Vérifiez les requêtes des applications, les tâches en arrière-plan, les pilotes, les extensions et les pools de connexion. Enregistrez les performances, ainsi que la durée pendant laquelle vos applications rencontrent des erreurs en lecture seule et des échecs de connexion, afin de pouvoir les comparer ultérieurement.

Consultez les notes de mise à jour de chaque version majeure postérieure à votre version source, jusqu'à la version cible incluse. Vérifiez également les modifications apportées aux privilèges des rôles.

La mise à niveau ne conserve pas les horodatages des commits. Après la mise à niveau, pg_xact_commit_timestamp() renvoie NULL pour chaque transaction validée avant la mise à niveau. Si vos applications lisent les horodatages de validation, copiez les valeurs dont vous avez besoin dans une colonne du tableau avant de procéder à la mise à niveau.

Extensions et autres objets

Effectuez les préparatifs nécessaires décrits dans les sections suivantes avant de procéder à la mise à niveau. Pour un IPMVU, préparez le déploiement que vous souhaitez mettre à niveau. Pour les répliques en lecture seule et les chemins de restauration, préparez le déploiement source avant de créer la réplique ou d'effectuer la sauvegarde. Vous ne pouvez pas modifier une réplique en lecture seule, et une restauration met à jour les données au cours de la même opération. Prévoyez les éventuelles dépendances des applications vis-à-vis des objets que vous supprimez.

Extensions

pg_repack

pg_repack n'empêche pas la mise à niveau. Vous n'avez pas besoin de le supprimer ni de le recréer avant ou après la mise à niveau.

old_snapshot

Ce old_snapshot module n'est pas disponible dans PostgreSQL, version 17 et ultérieures. Lorsque vous effectuez une mise à niveau depuis PostgreSQL 16 ou une version antérieure vers PostgreSQL 17 ou une version ultérieure, IPMVU supprime old_snapshot de chaque base de données avant le passage en mode lecture seule. Si un objet dépend de old_snapshot, la mise à niveau échoue. La suppression n'est pas annulée si la mise à niveau échoue par la suite.

Si old_snapshot est installé dans une base de données, contactez le support technique pour identifier les objets dépendants avant de procéder à la mise à niveau. Pour les autres parcours de mise à niveau, contactez le support technique afin d'organiser sa suppression.

anon

Si la version anon 2 est installée, effectuez ces étapes dans chaque base de données où elle est installée. Exécutez-les en tant que propriétaire des tables masquées, telles que admin. Pour un IPMVU, la version anon 2 provoque l'échec de la mise à niveau pendant la phase de conversion, alors que la base de données est indisponible, et chaque nouvelle tentative échoue de la même manière. La anon version 3 ne nécessite pas ces étapes. La requête d'autocontrôle n° 10 indique la version installée dans extversion.

Avant de supprimer les règles de masquage, bloquez l'accès à la base de données pour les rôles masqués, qui ne doivent voir que les données masquées. Maintenez leur accès bloqué jusqu'à ce que vous ayez restauré et vérifié les règles de masquage et les étiquettes de rôle après la mise à niveau.

  1. Notez les règles de masquage et les rôles masqués afin de pouvoir les restaurer après la mise à niveau.

    SELECT objtype, objname, label
    FROM pg_catalog.pg_seclabels
    WHERE provider = 'anon';
    
  2. Supprimer toutes les règles de masquage.

    SELECT anon.remove_masks_for_all_columns();
    
  3. Supprimez l'étiquette masquée de chaque rôle répertorié à l'étape 1. À partir d' PostgreSQL 16, cette action nécessite l'option ADMIN sur le rôle. Pour plus d’informations, consultez la section Problèmes liés aux privilèges des rôles lors des mises à niveau de version.

    SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
    
  4. Abandonnez l'extension anon avec l'option cascade. L'option cascade supprime également les objets qui dépendent de anon, tels que les vues de masquage et les fonctions. Notez leurs définitions afin de pouvoir les recréer après la mise à niveau.

    DROP EXTENSION anon CASCADE;
    
  5. Après la mise à niveau, réactivez anon, réappliquez les règles de masquage et les étiquettes de rôle enregistrées, puis vérifiez le masquage avant de rétablir l'accès aux rôles masqués.

PostGIS

Si vous utilisez PostGIS, mettez-le à jour dans chaque base de données qui l'utilise avant de mettre à jour PostgreSQL:

SELECT postgis_extensions_upgrade();

Vérifiez la version de l'extension :

SELECT postgis_full_version();
earthdistance

Un IPMVU échoue pendant la phase de conversion si un index ou une colonne générée stockée utilise une fonction de la version earthdistance 1.1, telle que ll_to_earth(). Cela s'applique également lorsque l'objet l'utilise via votre propre fonction SQL. PostgreSQL 14 et 15 ne fournissent que la version 1.1. Vérifiez à l'aide de la requête d'autocontrôle n° 13 dans chaque base de données, puis traitez chaque objet répertorié :

  • Sous PostgreSQL 16 ou 17, mettez à jour l'extension avant de procéder à la mise à niveau :

    ALTER EXTENSION earthdistance UPDATE;
    
  • Sous PostgreSQL 14 ou 15, si used_function est l'une de vos propres fonctions, ajoutez-y un paramètre search_path:

    ALTER FUNCTION <used_function> SET search_path = ibm_extension, pg_catalog;
    
  • Sous PostgreSQL 14 ou 15, si used_function est une fonction earthdistance, supprimez l'index indiqué avant de procéder à la mise à niveau. Pour conserver les valeurs d'une colonne générée répertoriée, convertissez-la en colonne standard à l'aide de ALTER TABLE <table_name> ALTER COLUMN <column_name> DROP EXPRESSION;. Après la mise à niveau, exécutez ALTER EXTENSION earthdistance UPDATE;, puis recréez ce que vous avez supprimé. Si votre version cible est PostgreSQL 15, la mise à jour n'a aucun effet, et les objets que vous recréez bloquent votre prochaine mise à niveau de la même manière. Pour éviter cela, effectuez une mise à niveau vers PostgreSQL, version 16 ou ultérieure.

pgRouting

Si votre déploiement utilise PostgreSQL 16 ou 17 et que vous effectuez une mise à niveau vers PostgreSQL 18, vérifiez chaque base de données sur laquelle pgRouting est installé. Les déploiements de PostgreSQL 18 n'incluent pas la bibliothèque pgRouting 3.5. Une conversion IPMVU vers PostgreSQL 18 échoue aux contrôles de compatibilité, avant même que le mode lecture seule ne soit activé, dès lors qu’une fonction utilise cette bibliothèque. Pas de lignes :

SELECT DISTINCT p.probin
FROM pg_catalog.pg_proc AS p
WHERE p.probin = '$libdir/libpgrouting-3.5';

Si la requête renvoie une ligne, mettez à jour vers pgRouting la dernière version fournie par votre déploiement avant de procéder à la mise à niveau, puis relancez la requête :

ALTER EXTENSION pgrouting UPDATE;

pgRouting La version 4.0 supprime plusieurs fonctions, telles que pgr_createTopology, pgr_analyzeGraph, et pgr_nodeNetwork, et en modifie d'autres. Testez d'abord vos applications avec la version 4.0 sur pgRouting un environnement de préproduction. Si ces fonctions supprimées sont nécessaires, contactez le support avant de passer à la version 18 d' PostgreSQL. À partir de PostgreSQL 16, vous pouvez également effectuer une mise à niveau vers PostgreSQL 17, qui inclut la bibliothèque 3.5.

Fonctions SQL dans les index, les clés de partition et les colonnes générées

Au cours de la phase de conversion, un IPMVU recrée la définition de chaque index, clé de partition et colonne générée stockée avec un chemin de recherche vide. Cette étape échoue si l'un de ces objets utilise une fonction LANGUAGE sql dont le corps est une chaîne de caractères qui nomme un objet externe sans pg_catalog son schéma, directement ou via une contrainte de vérification de domaine. Les statistiques étendues ont le même effet sur une table comportant une clé étrangère. Dans un index, un appel qui spécifie le schéma ibm_extension dans lequel les extensions sont installées échoue également. L'échec se produit alors que la base de données est indisponible, et chaque nouvelle tentative échoue de la même manière.

Exécutez la requête d'autocontrôle n° 12 dans chaque base de données. Pour chaque fonction répertoriée, ajoutez un paramètre search_path qui nomme tous les schémas utilisés par son corps. Sinon, remplacez son corps de chaîne par un corps conforme à la norme SQL. Exécutez ces instructions en tant que propriétaire de la fonction. Exemple :

ALTER FUNCTION f_unaccent(text) SET search_path = ibm_extension, pg_catalog;
CREATE OR REPLACE FUNCTION f_unaccent(text) RETURNS text
  LANGUAGE sql IMMUTABLE PARALLEL SAFE STRICT
  RETURN ibm_extension.unaccent('ibm_extension.unaccent', $1);

Ne modifiez pas les résultats ni les autres attributs de chaque fonction, car les index et les colonnes générées stockent ces résultats, et les tables partitionnées acheminent les lignes en fonction de ceux-ci. Lorsque le paramètre search_path est activé, PostgreSQL ne développe plus la fonction dans les requêtes qui l'appellent, ce qui peut ralentir ces dernières. Un corps de norme SQL ne protège pas les fonctions de corps de chaîne qu'il appelle; il faut donc corriger ces fonctions également. Relancez la requête jusqu'à ce qu'elle ne renvoie plus aucune ligne. Si une fonctionnalité que vous ne possédez pas est mentionnée, contactez le support avant de procéder à la mise à jour.

Si vous effectuez une mise à niveau depuis PostgreSQL 16 ou une version antérieure vers PostgreSQL 17 ou une version ultérieure, exécutez également la requête d'autovérification 17. À partir de PostgreSQL, version 17, les commandes de maintenance s'exécutent avec un chemin de recherche restreint. Toute fonction, quel que soit le langage, utilisée par un index, une vue matérialisée ou des statistiques étendues doit alors disposer de son propre search_path paramètre. Sinon, après la mise à niveau, ANALYZE, REINDEX, CLUSTER, VACUUM FULL, et échouent REFRESH MATERIALIZED VIEW pour les objets concernés. Définissez le chemin de recherche de chaque fonction répertoriée qui nomme des objets sans leur schéma, comme dans l'exemple précédent. Pour plus d'informations, consultez les notes de migration vers PostgreSQL 17.

Objets utilisant des noms de système supprimés

Chaque version majeure supprime ou renomme certaines colonnes du catalogue système, certaines fonctions et certains paramètres de configuration. Par exemple, PostgreSQL 17 a supprimé les colonnes de point de contrôle de pg_stat_bgwriter, et PostgreSQL 16 a renommé le paramètre force_parallel_mode en debug_parallel_query. Les contrôles préalables ne détectent pas les objets qui utilisent ces noms :

  • Si une vue, une vue matérialisée ou un agrégat utilise un nom supprimé, l'IPMVU échoue lors de la phase de conversion. Une fonction dont le corps est conforme à la norme SQL et une fonction, un rôle ou un paramètre de base de données dont un paramètre a été supprimé ont le même effet.
  • Les autres fonctions et procédures, les tâches pg_cron ainsi que les requêtes d'application qui utilisent un nom supprimé échouent lors de leur première exécution sur la nouvelle version. Cela peut se produire avant la reprise des écritures.

Exécutez la requête d'autocontrôle n° 14 dans chaque base de données. Modifiez ou supprimez chaque élément répertorié dont la version removed_in est égale ou inférieure à votre version cible. Vérifiez les paramètres de rôle et de base de données à l'aide de la requête d'autovérification n° 7. Testez vos requêtes d'application et de surveillance sur un déploiement de préproduction de la version cible.

Emplacements de réplication logique

IPMVU échoue à ses vérifications préalables tant qu'il existe un emplacement de réplication logique, y compris les emplacements inactifs et ceux qu'il utilise wal2json. Il n'est pas possible de récupérer un emplacement supprimé, et un nouvel emplacement n'inclut pas les modifications que l'ancien emplacement conservait. Avant de procéder à la mise à niveau :

  1. Enregistrez le nom de chaque emplacement, le plug-in et la base de données à l'aide de la requête d'autovérification 2.

  2. Suspendre l'écriture dans la source jusqu'à ce que vous ayez restauré les consommateurs après la mise à niveau, ou prévoyez de resynchroniser les données en aval.

  3. Permettez aux utilisateurs de traiter les modifications en attente, puis de les annuler. Laissez-les en attente, avec la reconnexion automatique désactivée, jusqu’à ce que la tâche affiche Terminé.

  4. Supprimez chaque slot à l'aide de la commande ibmcloud cdb postgresql replication-slot-delete ou de l'API Supprimer un slot de réplication logique. L'utilisateur admin ne peut pas supprimer de slots de réplication à l'aide de SQL.

    ibmcloud cdb postgresql replication-slot-delete <NAME|CRN> <SLOT_NAME>
    
  5. Après la mise à niveau, recréez les emplacements comme décrit dans la section Configuration wal2json.

wal2json Il s'agit d'un plug-in de décodage logique, et non d'une extension que vous créez avec CREATE EXTENSION.

Abonnements logiques

Un abonnement logique reçoit les modifications provenant d'un éditeur. Son emplacement de réplication se trouve sur l'éditeur; par conséquent, la requête d'emplacement ne le répertorie pas.

Si votre déploiement utilise PostgreSQL 16 ou une version antérieure, IPMVU échoue à ses vérifications préalables tant qu'il existe un abonnement logique, y compris les abonnements désactivés. Les mises à niveau à partir de ces versions ne conservent pas l'état de synchronisation d'un abonnement. Avant de procéder à la mise à niveau, convenez avec le propriétaire de l'éditeur de la marche à suivre pour supprimer et recréer chaque abonnement, ainsi que pour resynchroniser les données. Ensuite, supprimez les abonnements à l'aide des fonctions d'abonnement. La fonction delete_subscription supprime également le slot de l'abonnement au niveau de l'éditeur, et elle échoue si l'éditeur est inaccessible ou si le slot n'existe plus. Dans ce cas, exécutez disable_subscription puis avant subscription_slot_none delete_subscription. Demandez ensuite au propriétaire de l'éditeur de supprimer le slot, car celui-ci continue de conserver les journaux de transactions sur l'éditeur.

Si votre déploiement utilise PostgreSQL 17 ou une version ultérieure, les abonnements peuvent être conservés, mais ils doivent répondre aux exigences de mise à niveau de la réplication logique de la version cible. La mise à niveau prend en charge au maximum 10 abonnements. Au-delà de cette limite, les contrôles de compatibilité échouent avant même que le mode lecture seule ne soit activé. Désactivez les abonnements à l'aide de avant disable_subscription la mise à niveau, puis réactivez-les à l'aide de une enable_subscription fois la mise à niveau terminée.

UNLOGGED tableaux et séquences

PostgreSQL n'enregistre pas les modifications apportées aux tables UNLOGGED et aux séquences dans le journal des transactions. Il ne les réplique pas vers les autres nœuds et les réinitialise après un basculement ou une restauration. Aucune des voies de mise à niveau ne conserve leur contenu :

  • Un IPMVU les réinitialise lorsqu'il redémarre PostgreSQL sur la nouvelle version, puis à nouveau lorsqu'il bascule le rôle principal lors de la phase d'achèvement. Une mise à jour qui a échoué peut également les réinitialiser.
  • Une réplique en lecture seule promue et une sauvegarde restaurée commencent avec des tables UNLOGGED vides et des séquences UNLOGGED réinitialisées.

Après la mise à niveau, les tables UNLOGGED sont vides et les séquences UNLOGGED sont réinitialisées. Tant que la tâche n'apparaît pas comme Terminée, toute modification que vous apportez à ces objets risque également d'être perdue. Avant de procéder à la mise à niveau, utilisez la requête d'autovérification n° 11 pour identifier ces objets dans chaque base de données et planifier la manière de traiter chacun d'entre eux.

  • Pour conserver le contenu d'une table, convertissez-la à l'aide de ALTER TABLE <table_name> SET LOGGED;. convertit SET LOGGED également les index de la table et les séquences qui lui sont associées. Convertissez un tableau référencé avant de convertir tout tableau qui y fait référence via des clés étrangères. Vous pouvez également exporter le contenu et le recharger une fois que la tâche apparaît comme Terminée.
  • Si une séquence génère des valeurs pour une table enregistrée, convertissez-la à l'aide de ALTER SEQUENCE <sequence_name> SET LOGGED;. Sinon, arrêtez les applications qui l'utilisent jusqu'à ce que la tâche affiche Terminé. Ensuite, définissez-la au-delà de la valeur maximale utilisée à l'aide de la fonction setval.

SET LOGGED réécrit la table et bloque les opérations de lecture et d'écriture jusqu'à ce que l'opération soit terminée. Il génère également environ autant de données de journal des transactions que l'espace occupé par la table et ses index. Convertissez les tables volumineuses bien avant de valider la mise à niveau, puis utilisez la requête d'autovérification n° 5 pour vérifier que les journaux de transactions ont bien été archivés. Après la mise à niveau, vous pouvez reconvertir une table à l'aide de ALTER TABLE <table_name> SET UNLOGGED;.

Pour un IPMVU, une table UNLOGGED, même vide, oblige également le service à reconstruire chaque membre HA, ce qui prolonge la durée pendant laquelle les écritures sont bloquées. Pour plus d'informations, consultez la section Disponibilité pendant une mise à niveau. Pour éviter cette reconstruction, convertissez toutes les tables UNLOGGED ou supprimez celles dont vous n'avez plus besoin. TRUNCATE Cela n'empêche pas la reconstruction. Les séquences UNLOGGED ne provoquent pas de reconstruction. Sous PostgreSQL 16 et 17, SET LOGGED est en soi une opération en masse qui peut tout de même entraîner une reconstruction; prévoyez-en donc une.

Mise à niveau majeure de la version sur place

Effectuez tous les préparatifs, puis utilisez l'interface utilisateur, l'API, l'interface de ligne de commande ou la procédure Terraform ci-dessous.

Dans une configuration IPMVU, le service met à niveau le serveur principal sur place et met à niveau chaque membre HA à partir de ses fichiers de données existants. Lorsque tous les membres de la haute disponibilité (HA) peuvent réutiliser leurs fichiers de données, les écritures ne sont bloquées que brièvement. La durée dépend principalement du nombre d'objets de la base de données et du niveau d'activité de celle-ci, plutôt que de la quantité de données stockées.

Dans certaines conditions, le service copie l'intégralité de la base de données vers les nœuds de haute disponibilité, ce qui bloque les écritures pendant beaucoup plus longtemps. D'autres conditions entraînent l'échec de la mise à niveau une fois que les écritures sont bloquées. Les vérifications préalables ne détectent pas ces problèmes; veillez donc à les résoudre avant de valider la mise à niveau. Pour consulter la liste, voir Conditions non détectées par les pré-vérifications.

Vous ne pouvez pas annuler une demande IPMVU une fois qu'elle a été soumise, et vous ne pouvez pas revenir à une version antérieure du déploiement en cours. Le service n'effectue pas de sauvegarde des données avant la mise à niveau; veillez donc à créer et à vérifier au préalable une sauvegarde à la demande.

Disponibilité pendant une mise à niveau

Un IPMVU s'exécute selon les phases suivantes. Les écritures sont suspendues lorsque la phase en lecture seule commence et reprennent lorsque le service quitte le mode lecture seule. Les lectures ne sont pas non plus disponibles pendant la phase de conversion.

Phases et disponibilité de l'IPMVU
Phase Que se passe-t-il? Lectures Écritures
Vérifications Le service attend que les modifications de déploiement en attente soient terminées, puis effectue les vérifications préalables. Il vérifie la compatibilité de la mise à niveau sur le nœud principal et les nœuds de haute disponibilité, puis suspend le basculement automatique. Disponible Disponible
En lecture seule Le service rend les nouvelles transactions en lecture seule dans toutes les bases de données et met fin à toutes les sessions client. Il attend ensuite que les membres de la haute disponibilité et l'archivage du journal des transactions rattrapent leur retard. Disponible Bloquée
Conversion Le service arrête PostgreSQL sur tous les nœuds et met à niveau le nœud principal. Dans la mesure du possible, il met à niveau chaque membre HA à partir des fichiers de données existants de ce membre. Non disponible Non disponible
Redémarrer Le serveur principal mis à niveau démarre en mode lecture seule, et les membres HA démarrent. Le service recrée tout élément qui ne peut pas réutiliser ses fichiers de données à partir du serveur principal mis à niveau. Disponible Bloquée
Rédaction de CV Le service désactive le mode lecture seule et met à nouveau fin à toutes les sessions client. Disponible Disponible
Completion Le service attend que tous les membres du groupe HA se soient synchronisés. Ensuite, le service redémarre les membres un par un pour achever la migration du déploiement vers la nouvelle version. Avant de redémarrer le serveur principal, le service transfère le rôle principal à un autre membre, ce qui met fin aux sessions des clients. Le service supprime ensuite les fichiers de mise à niveau, met en file d'attente la sauvegarde post-mise à niveau et marque les tâches comme Terminées. Disponibles, sauf pendant la période de transition Disponibles, sauf pendant la période de transition

Se réinitialise dès qu'au moins un membre du groupe HA a rattrapé son retard, et que tous les autres membres du groupe HA ont rattrapé leur retard ou sont en cours de reconstruction. Le service reconstruit un nœud HA qui ne peut pas réutiliser ses fichiers de données en y copiant l'intégralité de la base de données. Si tous les membres HA doivent être reconstruits, les écritures restent bloquées jusqu'à ce que la première reconstruction soit terminée. Pour une base de données volumineuse, cela peut prendre plusieurs heures. Un déploiement comportant deux nœuds de données, ce qui correspond à la configuration par défaut, ne comporte qu'un seul nœud HA. Par conséquent, toute reconstruction bloque les écritures. Les membres HA ne peuvent pas réutiliser leurs fichiers de données dans les situations suivantes :

  • Toute base de données contient une table UNLOGGED, même si celle-ci est vide. Le service reconstruit ensuite chaque membre HA. Vérifiez à l'aide de la requête d'autocontrôle n° 11, et consultez les tables UNLOGGED et les séquences.
  • Le déploiement utilise PostgreSQL 16 ou 17, et les tables ont grossi à la suite d'opérations en masse ou d'un grand nombre d'insertions ou de mises à jour simultanées. Les opérations en masse comprennent les commandes ALTER TABLE COPY, pg_restore, CREATE TABLE AS, CREATE MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW, et qui réécrivent une table, comme par exemple SET LOGGED. Comme il n'est pas possible de vérifier cela à l'avance, prévoyez une nouvelle compilation.

Le service peut également reconstruire des membres HA pour d’autres raisons que vous ne pouvez pas vérifier à l’avance. Un test effectué sur un environnement de préproduction que vous restaurez à partir d'une sauvegarde peut ne pas refléter cette reconstruction.

Un élément HA en cours de reconstruction conserve ses fichiers de données précédents jusqu'à ce que la tâche soit terminée. Par conséquent, cela nécessite un espace disque libre au moins égal à l'espace occupé par ses données. Avant de valider la mise à niveau, assurez-vous que chaque élément de données utilise nettement moins de la moitié de son espace disque disponible. Vérifiez cette valeur à l'aide de la métrique espace disque utilisé. Bien que la vérification préalable de l'espace disque autorise une utilisation du disque allant jusqu'à 90 %, la reconstruction d'un nœud HA nécessite nettement plus d'espace libre. Sinon, la reconstruction risque de manquer d'espace disque et d'échouer à plusieurs reprises. Les écritures peuvent alors rester bloquées pendant des heures avant que la tâche n'échoue. La mise à l'échelle automatique et manuelle du disque est suspendue jusqu'à la fin de la mise à niveau; veillez donc à mettre le disque à l'échelle avant de lancer la mise à niveau. Une reconstruction trop longue peut également entraîner l'échec de la tâche après la reprise des écritures. Dans les deux cas, le déploiement utilise la version cible jusqu'à ce que le service d'assistance ait terminé la mise à niveau. Prévoyez une reconstruction pendant votre fenêtre de maintenance.

Rédige un CV avant la fin de la tâche. Pour vérifier si les écritures ont repris, exécutez SHOW default_transaction_read_only; dans une nouvelle session. Il revient à la normale off une fois que les écritures reprennent. Les sessions client prennent fin lorsque le mode lecture seule commence, lorsque PostgreSQL s'arrête pour la conversion, lorsque les écritures reprennent, pendant la bascule au cours de la phase d'achèvement, et lorsque le service rétablit l'accès en écriture après une panne.

Tant que la tâche n'apparaît pas comme Terminée, évitez les écritures en masse prolongées, telles que les chargements de données volumineux ou les tâches par lots. La phase de finalisation attend que chaque membre de la haute disponibilité ait répercuté toutes les modifications. Sous une charge d'écriture intense et continue, ce délai d'attente peut expirer, et la tâche échoue alors une fois les écritures reprises. Le risque est plus élevé tant qu'un membre de la haute disponibilité (HA) est en cours de reconstruction. Le déploiement exécute alors la version cible sans sauvegarde post-mise à niveau, et le support technique doit mener à bien la mise à niveau.

Pour vérifier si votre charge d'écriture permet aux membres HA de rattraper leur retard, exécutez la requête suivante à l'heure prévue pour la mise à niveau. Répétez cette opération toutes les secondes pendant quelques minutes, par exemple à l'aide de la commande psql \watch 1. Le service nécessite que tous les membres HA soient 0 présents replay_lag_bytes en même temps. Si cela ne se produit jamais, réduisez la charge d'écriture avant de valider la mise à niveau.

SELECT application_name, state,
       pg_catalog.pg_wal_lsn_diff(pg_catalog.pg_current_wal_lsn(), replay_lsn) AS replay_lag_bytes
FROM pg_catalog.pg_stat_replication
ORDER BY application_name;

La mise à niveau ne met pas à jour les statistiques de l'optimiseur; les requêtes peuvent donc choisir des plans d'exécution lents jusqu'à ce que vous exécutiez ANALYZE. Les mises à niveau vers PostgreSQL 15, 16 ou 17 ne transfèrent pas les statistiques. Les mises à niveau vers PostgreSQL 18 transfèrent la plupart des statistiques, mais pas les statistiques étendues que vous avez créées avec CREATE STATISTICS, ni celles collectées par des extensions telles que PostGIS. Le autovacuum processus n'analyse une table qu'après un nombre suffisant d'écritures, et il n'analyse jamais les tables partitionnées. N'attendez pas la fin de la tâche. Dès que revient SHOW default_transaction_read_only;``off, actualisez les statistiques comme décrit dans la section Après la mise à niveau.

Le mode lecture seule définit une valeur par défaut pour les nouvelles transactions. Cela ne verrouille pas la base de données. Une session qui définit default_transaction_read_only sur off, ou qui lance explicitement une transaction en lecture-écriture, peut toujours écrire. Il en va de même pour un rôle dont le default_transaction_read_only contexte est off. Les commandes de maintenance telles que VACUUM, ANALYZE, REINDEX, et fonctionnent CLUSTER également toujours. Le mode lecture seule n'interrompt pas une tâche pg_cron déjà en cours d'exécution, ni un abonnement activé sur PostgreSQL 17. De telles écritures peuvent entraîner l'échec de la mise à niveau. Avant de valider la mise à jour, arrêtez les processus qui contournent le mode lecture seule. Suspendre les tâches planifiées qui écrivent ou exécutent des commandes de maintenance, telles que les tâches pg_cron, et attendre que les tâches en cours d'exécution soient terminées. Réinstallez-les comme indiqué dans la section Après la mise à niveau.

Les opérations de lecture peuvent également écrire des journaux de transactions en mode lecture seule, par exemple la première fois que des requêtes lisent des lignes après un chargement en masse ou une mise à jour volumineuse. Cette opération retarde le rattrapage attendu par les phases lecture seule et redémarrage; les écritures restent donc bloquées plus longtemps, et la mise à niveau peut échouer. Avant de valider la mise à jour, exécutez sur VACUUM les tables que vous avez récemment chargées ou modifiées de manière significative.

Lorsque le service met fin à une session, un client qui se connecte directement au déploiement reçoit le code SQLSTATE ( 57P01``admin_shutdown ). Une écriture dans une transaction en lecture seule échoue avec le code SQLSTATE 25006 (read_only_sql_transaction). Pendant la phase de conversion, une nouvelle connexion peut échouer en raison d’une erreur d’authentification, telle que le code SQLSTATE 28P01, même si vos identifiants restent inchangés. Réessayez la connexion après la conversion. Si ces erreurs persistent après que la tâche a affiché le message Échec, contactez le support. Grâce à un gestionnaire de pool de connexions, les applications peuvent détecter d'autres erreurs de connexion.

Les clients qui n'acceptent que les sessions en lecture-écriture ne peuvent pas se connecter lorsque le mode lecture seule est activé; ils ne peuvent donc pas non plus effectuer de lectures tant que les écritures ne reprennent pas. Cela s'applique aux libpq clients qui définissent target_session_attrs=read-write, ainsi qu'aux clients JDBC qui définissent targetServerType=primary ou master. Pour garantir la disponibilité des lectures, utilisez target_session_attrs=any, ou primary avec la version 14 libpq ou ultérieure. Pour l' JDBC, utilisez targetServerType=any.

Les applications doivent gérer les échecs de connexion et les erreurs de lecture seule, se reconnecter et ne réessayer les transactions interrompues que lorsque cela ne présente aucun risque. La mise en pool des connexions ne supprime pas ces exigences. L'accès à l'application ne prouve pas que la mise à niveau a été effectuée.

Sauvegardes et restauration

Le service n'effectue pas de sauvegarde des données avant la mise à niveau. Créez et vérifiez une sauvegarde à la demande récente avant l'IPMVU. Pour revenir à la version d'origine après une mise à niveau, restaurez une sauvegarde ou un point de restauration antérieur à la mise à niveau dans un nouveau déploiement exécutant la version d'origine. Indiquez explicitement la version, car une restauration à un instant donné sans version crée un déploiement qui exécute la version actuelle. Cette option nécessite que la version source soit toujours disponible pour les nouveaux déploiements. Tenir compte des modifications apportées depuis lors.

Une fois la mise à niveau réussie, le service met en file d'attente une sauvegarde du déploiement mis à niveau. La sauvegarde s'exécute séparément une fois la mise à niveau terminée et peut ne pas démarrer immédiatement. Cette première sauvegarde sur la nouvelle version copie l'intégralité de la base de données; elle peut donc prendre plusieurs heures si la base de données est volumineuse. Vérifiez son état dans la section Sauvegardes et restaurations. En cas de défaillance, effectuez une sauvegarde à la demande et contactez le support technique si les défaillances persistent. Un échec de la sauvegarde n'entraîne pas l'annulation de la mise à niveau.

La restauration à un instant donné (PITR) ne permet pas de rejouer les transactions lors d'une mise à niveau vers une nouvelle version majeure. Vous pouvez effectuer une restauration à un moment antérieur au lancement de la tâche de mise à niveau, ou après la fin de la première sauvegarde du déploiement mis à niveau. Les restaurations vers des points de récupération situés entre la mise à niveau et la fin de la sauvegarde post-mise à niveau ne sont pas prises en charge. Le service rejette certains de ces points de restauration, tandis que la restauration à partir d'autres peut être acceptée mais échouer au cours du processus de restauration. Cette période non prise en charge comprend le temps qui s'écoule après la reprise des écritures. Tant que la sauvegarde post-mise à niveau n'est pas terminée, les restaurations vers le dernier point de récupération disponible peuvent également échouer, même si le service accepte la demande de restauration.

Pour préserver la couverture PITR des modifications apportées après la mise à niveau, suspendez les écritures de l'application jusqu'à ce que la sauvegarde post-mise à niveau soit terminée. Intégrez-les dans vos applications. Lorsque les écritures reprennent, la mise à niveau est réinitialisée sur default_transaction_read_only chaque base de données; par conséquent, un paramètre lecture seule au niveau de la base de données ne permet pas de maintenir les écritures en pause.

Une mise à niveau qui a échoué ne déclenche pas de sauvegarde. La fonctionnalité PITR peut être indisponible à certains moments entre le début de la tentative et la prochaine sauvegarde terminée. Après une mise à niveau ayant échoué, si SHOW server_version; signale la version source et que le déploiement accepte les écritures, effectuez une sauvegarde à la demande. Sinon, contactez le support avant de procéder à une sauvegarde ou d'effectuer d'autres modifications.

Les sauvegardes et les points de restauration antérieurs à la mise à niveau appartiennent à la version précédente et restent soumis aux limites de conservation. Pour plus d'informations, consultez PITR.

Les options de saut de sauvegarde ne sont pas prises en charge pour PostgreSQL: skip_backup dans l'API, --skip-backup dans l'interface de ligne de commande (CLI) et version_upgrade_skip_backup dans Terraform. Les requêtes qui les font échouer. L'API et l'interface de ligne de commande renvoient une erreur, et les plans Terraform échouent.

Avant de commencer

Appliquez ces exigences aussi bien à l'environnement de préproduction qu'à l'environnement de production :

  • Effectuez la préparation de l'application, de l'extension et de la réplication, ainsi que la préparation de la sauvegarde.

  • Résolvez les problèmes non détectés par les vérifications préalables, puis exécutez les requêtes d'autocontrôle.

  • Veillez à ce que chaque membre de données utilise nettement moins de la moitié de son espace disque disponible, afin qu'une reconstruction des membres HA ne se heurte pas à un manque d'espace. Pour plus d'informations, consultez la section Disponibilité pendant une mise à niveau.

  • Assurez-vous que le déploiement dispose d'au moins une sauvegarde terminée. Jusqu'à ce moment-là, la console désactive le bouton Mettre à niveau la version majeure et l'API rejette la requête.

  • IPMVU n'est pas disponible dans un déploiement de réplique en lecture seule. Pour mettre à niveau une réplique, effectuez une mise à niveau de version.

  • Promeuvez ou supprimez toutes les répliques en lecture seule du déploiement, y compris celles situées dans d'autres régions, puis attendez que chaque opération soit terminée. Une réplique supprimée reste associée au déploiement jusqu'à ce qu'elle soit définitivement supprimée. La mise à niveau échoue aux vérifications préalables tant qu'une réplique est associée au déploiement. Prévoyez des applications qui lisent à partir de ces répliques. Pour plus d'informations, consultez les sections Répliques en lecture seule et IPMVU.

  • Effectuez une mise à niveau à la fois. Le service rejette une nouvelle demande de mise à niveau lorsqu'une autre tâche de mise à niveau est en attente ou en cours d'exécution.

  • Si vous avez défini la configuration synchronous_commit du déploiement sur on, remplacez-la par avant local de valider la mise à niveau. Rétablissez la version d'origine une fois que la tâche apparaît comme Terminée. Avec on, une mise à niveau qui échoue peut rendre toutes les bases de données en lecture seule ou bloquer les validations jusqu’à ce que le support technique rétablisse le déploiement. La configuration du déploiement est la suivante on si la requête suivante renvoie le résultat suivant on avec la source configuration file:

    SELECT setting, source
    FROM pg_catalog.pg_settings
    WHERE name = 'synchronous_commit';
    
  • Choisissez une cible parmi les fonctionnalités de votre déploiement. Vous pouvez effectuer une mise à niveau directement vers n'importe quelle version ultérieure figurant dans le parcours de mise à niveau, sans passer par les versions intermédiaires. Une version que vous pouvez provisionner n'est pas nécessairement une cible de mise à niveau sur place :

    ibmcloud cdb deployment-capability-show <NAME|CRN> versions
    

    Dans le résultat, utilisez la valeur to_version d'une entrée Upgrade Transition.

Vérifications préalables et préparation

Le service effectue les vérifications suivantes avant le démarrage du mode lecture seule. Si une vérification échoue, la tâche affiche le message Échec et le déploiement conserve sa version actuelle sans bloquer les écritures. Si une base de données a la valeur définie default_transaction_read_only sur on, un contrôle ayant échoué réinitialise également ce paramètre sur toutes les bases de données et met fin à toutes les sessions client. La tâche n'indique pas quelle vérification a échoué; veillez donc à vérifier chaque élément avant de valider la mise à jour.

Contrôles préalables IPMVU
Vérifier Conforme lorsque Votre action
État de santé du déploiement Tous les nœuds de données sont en cours d'exécution, et chaque nœud HA reçoit les données en continu depuis le nœud principal. Attendez que la mise à l'échelle, la maintenance et la reconstruction des nœuds de haute disponibilité soient terminées. Vérifier à l'aide de la requête d'autocontrôle n° 1. Les autres tâches ne font pas échouer cette vérification, mais elles retardent le début de la mise à niveau. Consultez les tâches récentes ou affichez la liste des tâches à l'aide de ibmcloud cdb deployment-tasks-list. Si cette vérification continue d'échouer, contactez le support technique.
Espace disque Chaque élément de données utilise au maximum 90 % de l'espace disque qui lui est alloué. Adaptez la capacité du disque ou supprimez les données dont vous n'avez plus besoin. Les emplacements de réplication logique inutilisés peuvent également conserver des journaux de transactions. Ce contrôle autorise jusqu’à 90 %, mais une reconstruction des membres HA nécessite que chaque membre de données utilise bien moins de la moitié de son espace disque. Voir la section Disponibilité pendant une mise à niveau.
CPU, mémoire et E/S disque Pour chaque élément de données, la charge moyenne sur 1 minute de l'hôte ne dépasse pas 90 % de son nombre de cœurs de processeur, et l'utilisation de la mémoire de l'hôte ne dépasse pas 90 %. L'utilisation des E/S disque est également limitée à 90 % au maximum. Effectuez la mise à niveau pendant une période de faible activité, ou relancez la mise à niveau ultérieurement. Le service mesure la charge et la mémoire de l'hôte dans son ensemble, y compris les autres charges de travail qui y sont exécutées, et échantillonne les E/S disque sur quelques secondes. La charge moyenne prend également en compte les processus en attente d'E/S disque. Leurs valeurs peuvent donc différer de vos indicateurs de surveillance, et la mise à l'échelle de votre déploiement ne permettra pas nécessairement de les réduire. Si cette vérification continue d'échouer, contactez le support technique.
Archivage du journal des transactions L'archivage ne présente pas d'échec, et le volume des journaux de transactions en attente d'archivage ne dépasse pas 4 Go. Réduire le débit d'écriture jusqu'à ce que le retard soit résorbé. Vérifier à l'aide de la requête d'auto-vérification n° 5. La vérification échoue également si un membre HA a des journaux de transactions en attente, par exemple peu après un basculement. Si cette vérification continue d'échouer, contactez le support technique.
Réplication logique Il n'existe aucun emplacement de réplication logique. Sur PostgreSQL 16 et les versions antérieures, il n'existe aucun abonnement logique, y compris les abonnements désactivés. Supprimer les emplacements. Sous PostgreSQL 16 et versions antérieures, supprimez les abonnements. Sous PostgreSQL 17, désactivez-les. Vérifier à l'aide des questions d'auto-évaluation n° 2 et 3.
Répliques en lecture seule et clients de réplication Le déploiement ne dispose d'aucune réplique en lecture seule associée, et aucun client de réplication autre que les membres HA ne s'y connecte. Le nombre de répliques est comptabilisé dans toutes les régions et tous les états, y compris les répliques en cours de provisionnement ou déconnectées. Répertoriez les répliques associées dans la console ou à l'aide de ibmcloud cdb deployment-read-replicas. Promeouvez ou supprimez chacun d'entre eux, puis attendez que chaque opération soit terminée. Une réplique supprimée continue d'être prise en compte jusqu'à ce qu'elle soit définitivement supprimée, même si elle n'apparaît plus dans la liste. Voir Répliques en lecture seule et IPMVU. Déconnectez les autres clients de réplication. La requête d'autocontrôle n° 1 affiche uniquement les clients connectés.
Transactions préparées Aucune transaction n'a été préparée. Demandez au responsable de l'application ou des transactions concernées de résoudre les transactions en cours et d'empêcher toute nouvelle transaction jusqu'à ce que la mise à niveau soit terminée. Ne les validez pas et ne les annulez pas uniquement pour valider le contrôle. Vérifier à l'aide de la requête d'autocontrôle n° 4.
Exportation de schémas Le schéma de chaque base de données s'exporte sans erreur. Une exportation qui expire ou qui manque d'espace de verrouillage ne fait pas l'objet d'un échec à cette vérification. Testez la mise à niveau sur un environnement de test que vous restaurez à partir d'une sauvegarde récente. Ce contrôle ne vérifie pas si la version cible est capable de recréer le schéma; il convient donc également de résoudre les problèmes que les pré-contrôles ne détectent pas. Si cette vérification continue d'échouer, contactez le support technique.
Compatibilité des mises à niveau Les vérifications de compatibilité de la mise à niveau de PostgreSQL sont réussies sur le serveur principal et sur chaque nœud de haute disponibilité. Terminez la préparation de l'extension, y compris la vérification pgRouting. Sur PostgreSQL 17, ne conservez pas plus de 10 abonnements. Vérifiez à l'aide des questions d'auto-évaluation n° 6, 8, 9 et 10.

Conditions non détectées par les pré-vérifications

Les contrôles préalables ne détectent pas les conditions suivantes. Certains d'entre eux entraînent l'échec de la mise à niveau une fois que les écritures sont bloquées. Si la cause réside dans le schéma, par exemple au niveau d'une fonction ou d'un nom de base de données, chaque nouvelle tentative échouera de la même manière jusqu'à ce que vous résolviez le problème. D'autres conditions peuvent entraîner la copie intégrale de la base de données vers les nœuds de haute disponibilité, ce qui bloque les écritures pendant beaucoup plus longtemps, ou provoquer l'échec de la mise à niveau une fois les écritures rétablies. Une défaillance au cours de la phase de conversion ou de redémarrage peut également entraîner l'arrêt des membres HA jusqu'à ce que le support technique les redémarre. Résolvez ou prévoyez une solution pour chaque cas de figure avant de valider la mise à niveau.

Conditions non détectées par les pré-vérifications
Condition Effet Action
Une base de données contient une table UNLOGGED. Chaque membre HA est reconstruit et son contenu UNLOGGED est réinitialisé. Vérifier à l'aide de la requête d'auto-vérification n° 11. Voir les tableaux UNLOGGED et les séquences.
Le déploiement utilise PostgreSQL 16 ou 17, et les tables ont grossi à la suite d'opérations en masse ou d'un grand nombre d'insertions ou de mises à jour simultanées. Les membres HA sont reconstitués. Planifiez la fenêtre de maintenance et l'espace disque nécessaire à la reconstruction. Voir la section Disponibilité pendant une mise à niveau.
Un membre de données utilise environ la moitié de son espace disque, voire plus, lors de la reconstruction des membres HA. La reconstruction manque d'espace. Les écritures peuvent rester bloquées pendant des heures avant que la tâche n'échoue. Avant de valider la mise à niveau, redimensionnez le disque jusqu’à ce que chaque élément de données utilise nettement moins de 50 % de son espace disque disponible.
Un index, une clé de partition, une colonne générée en arrière-plan ou des statistiques étendues utilisent une fonction LANGUAGE sql dont le corps est une chaîne de caractères qui nomme des objets externes pg_catalog sans leur schéma. Dans un index, nommer le schéma ibm_extension a le même effet. La conversion a échoué. Vérifier à l'aide de la requête d'auto-vérification n° 12. Consultez les fonctions SQL dans les index, les clés de partition et les colonnes générées.
Un index ou une colonne générée en arrière-plan utilise la version earthdistance 1.1. La conversion a échoué. Vérifier à l'aide de la requête d'auto-vérification n° 13. Voir earthdistance.
Une vue, un agrégat ou une fonction dont le corps est conforme à la norme SQL utilise un nom de système qui a été supprimé dans la version cible. Ou bien une fonction, un rôle ou un paramètre de base de données utilise un paramètre supprimé. La conversion a échoué. Vérifier à l'aide des questions d'auto-évaluation n° 7 et 14. Voir les objets qui utilisent des noms de système supprimés.
anon La version 2 est installée. La conversion a échoué. Terminez la préparation anon.
Un nom de base de données contient un guillemet simple ('), une barre oblique inversée (``), un signe égal (=), un saut de ligne ou un retour chariot. La mise à niveau échoue, parfois après le blocage des écritures. Vérifier à l'aide de la requête d'auto-vérification n° 15. Renommez la base de données et mettez à jour vos chaînes de connexion.
Les bases de données contiennent plusieurs milliers de tables et de séquences ou, sous PostgreSQL s 14 et 15, de vues. La conversion manque d'espace de verrouillage et échoue. Vérifiez à l'aide de la requête d'auto-évaluation n° 16 et augmentez le niveau max_locks_per_transaction si la requête indique que cela est nécessaire.
Le déploiement comporte un très grand nombre de bases de données, de tables ou d'objets volumineux. La conversion dépasse le délai imparti. La tâche échoue ou reste en cours tant que la base de données n'est pas disponible. Comptez les tables et les objets volumineux à l'aide de la requête d'autovérification n° 16. Entraînez-vous sur un environnement de test que vous restaurez à partir d'une sauvegarde récente de l'environnement de production. Si la simulation échoue, contactez le support technique.
L'activité d'écriture est élevée lorsque la mise à niveau démarre ou lorsque de nombreux journaux de transactions sont en attente d'archivage. Une fois le mode lecture seule activé, les membres HA et l'archivage du journal des transactions ne disposent que de quelques minutes pour rattraper leur retard. Un backlog qui passe le contrôle préalable peut prendre plus de temps à archiver, ce qui entraîne l'échec de la mise à niveau. Veillez à maintenir une charge faible depuis le début de la mise à niveau jusqu'à la reprise des écritures, et effectuez les opérations sur VACUUM des tables récemment chargées avant la mise à niveau. Vérifiez le décalage de réplication à l'aide de la requête décrite dans la section « Disponibilité pendant une mise à niveau », puis vérifiez l'archivage à l'aide de la requête d'autocontrôle n° 5.
Les écritures se poursuivent après le début du mode lecture seule, par exemple à la suite de remplacements en lecture seule, de commandes de maintenance, de tâches pg_cron en cours d'exécution ou d'abonnements activés sur PostgreSQL 17. Il se peut que les membres HA et l'archivage ne parviennent pas à suivre le rythme, ce qui entraînerait l'échec de la mise à niveau. Interrompez ces rédacteurs avant de valider la mise à niveau, comme décrit dans la section Disponibilité pendant une mise à niveau.
Un client prépare une transaction après les vérifications préalables. fonctionne toujours PREPARE TRANSACTION en mode lecture seule. La mise à niveau échoue lorsque les écritures sont bloquées. Une transaction préparée peu avant l'arrêt d' PostgreSQL peut entraîner l'échec de la conversion. Arrêtez les clients qui utilisent la validation en deux phases jusqu'à ce que la tâche affiche Terminé. Vérifier à l'aide de la requête d'autocontrôle n° 4.
Un client de réplication se connecte pendant la mise à niveau. Le créneau ainsi créé n'est pas conservé, et la mise à niveau peut échouer ou se bloquer tant que la base de données est indisponible. Laissez les clients de réplication déconnectés jusqu'à ce que la tâche affiche Terminé. Vérifier à l'aide des questions d'auto-évaluation n° 1 et n° 2.
Un chargement en masse continu s'exécute après la reprise des écritures. La tâche échoue après la reprise des écritures, et le déploiement exécute la version cible jusqu’à ce que le support technique ait terminé la mise à niveau. Évitez les chargements en masse tant que la tâche n'affiche pas le statut Terminé.
Le paramètre synchronous_commit de déploiement est on. Une mise à niveau qui échoue peut rendre toutes les bases de données accessibles en lecture seule jusqu'à ce que le support technique rétablisse le déploiement. Modifiez-le comme local indiqué dans la section Avant de commencer.
Vous effectuez une mise à niveau depuis PostgreSQL 16 ou une version antérieure vers la version 17 ou une version ultérieure, et un index, une vue matérialisée ou des statistiques étendues utilisent une fonction sans search_path paramètre. Après la mise à niveau, ANALYZE, REINDEX, CLUSTER, VACUUM FULL, et REFRESH MATERIALIZED VIEW peuvent échouer pour ces objets. Vérifier à l'aide de la requête d'auto-vérification n° 17. Consultez les fonctions SQL dans les index, les clés de partition et les colonnes générées.

Ne modifiez pas les schémas, les extensions, les bases de données, les emplacements de réplication logique ou les abonnements entre le moment où vous soumettez la mise à niveau et celui où la tâche est terminée.

Vérifier soi-même si l'on est prêt

Exécutez les requêtes suivantes en tant qu'utilisateur admin avec avant psql de valider la mise à niveau. Ils fonctionnent avec PostgreSQL, versions 14 à 18. Les requêtes 1 à 7 et la requête 15 couvrent l'ensemble du déploiement; il suffit donc de les exécuter une seule fois dans n'importe quelle base de données. Exécutez les autres requêtes dans chaque base de données.

  1. Connexions de réplication. Il y a une ligne pour chaque membre HA, soit le nombre de membres de données moins un, chacun avec l'état streaming. Toute autre ligne correspond à une réplique en lecture seule ou à un autre client de réplication. Une ligne intitulée signifie pg_basebackup que le service copie la base de données vers un membre HA ou vers une réplique en lecture seule. Attendez que la copie soit terminée, puis relancez la requête.

    SELECT application_name, client_addr, state
    FROM pg_catalog.pg_stat_replication
    ORDER BY application_name;
    
  2. Emplacements de réplication logique. Pas de lignes.

    SELECT slot_name, plugin, database, active
    FROM pg_catalog.pg_replication_slots
    WHERE slot_type = 'logical';
    
  3. Abonnements logiques. Sous PostgreSQL 16 et les versions antérieures, il ne faut s'attendre à aucune ligne. Dans PostgreSQL 17, attendez-vous à voir dans f la colonne subenabled de chaque ligne.

    SELECT d.datname AS database_name, s.subname, s.subenabled
    FROM pg_catalog.pg_subscription AS s
    JOIN pg_catalog.pg_database AS d ON d.oid = s.subdbid;
    
  4. Transactions préparées. Pas de lignes.

    SELECT gid, owner, database, prepared
    FROM pg_catalog.pg_prepared_xacts;
    
  5. Archivage des journaux de transactions. On s'attend à ce last_failed_time que soit vide ou antérieur à last_archived_time, et waiting_files à ce que soit égal à 0 ou proche de 0. Un backlog qui passe le contrôle préalable peut tout de même s'avérer trop volumineux pour être archivé une fois le mode lecture seule activé.

    SELECT failed_count, last_failed_time, last_archived_time
    FROM pg_catalog.pg_stat_archiver;
    
    SELECT count(*) AS waiting_files,
           pg_catalog.pg_size_pretty(count(*) * pg_catalog.pg_size_bytes(pg_catalog.current_setting('wal_segment_size'))) AS waiting_size
    FROM pg_catalog.pg_ls_archive_statusdir()
    WHERE name LIKE '%.ready';
    
  6. Paramètres de connexion à la base de données. Pas de lignes. Supprimez une base de données répertoriée dont le est datconnlimit -2, car elle n'est pas valide. Pour toute autre base de données répertoriée, autorisez les connexions ou supprimez-la. Si la requête contient des template0, contactez le support.

    SELECT datname, datallowconn, datconnlimit
    FROM pg_catalog.pg_database
    WHERE (datname <> 'template0' AND (NOT datallowconn OR datconnlimit = -2))
       OR (datname = 'template0' AND datallowconn);
    
  7. Rôles et paramètres de la base de données. Assurez-vous que chaque paramètre présent dans existe setconfig dans la version cible. Réinitialisez un paramètre qui a été supprimé ou renommé dans la version cible, puis définissez son équivalent après la mise à niveau. Cela s'applique également aux paramètres définis par les extensions, dont les noms contiennent un point. Assurez-vous qu'aucun rôle ne soit défini sur default_transaction_read_only une valeur fausse, telle que off, false, no, ou 0. Notez chaque base de données sur laquelle ce paramètre est défini default_transaction_read_only, car la mise à niveau réinitialise ce paramètre. La requête d'autocontrôle n° 14 vérifie les paramètres des fonctions.

    SELECT r.rolname AS role_name, d.datname AS database_name, s.setconfig
    FROM pg_catalog.pg_db_role_setting AS s
    LEFT JOIN pg_catalog.pg_roles AS r ON r.oid = s.setrole
    LEFT JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase;
    
  8. Types de données de colonne qu' PostgreSQL ne peut pas mettre à niveau. Pas de lignes. La requête répertorie également les colonnes de types composites système, ainsi que les domaines, les tableaux, les types composites et les plages basés sur ces types. La colonne base_type indique le type d'élément qui bloque la mise à niveau. Le bloc de type aclitem ne prend en charge que les mises à niveau depuis PostgreSQL 14 ou 15 vers la version 16 ou une version ultérieure.

    WITH RECURSIVE problem_types (type_oid, base_type) AS (
      SELECT t.oid, t.typname::text
      FROM pg_catalog.pg_type AS t
      WHERE t.typnamespace = 'pg_catalog'::pg_catalog.regnamespace
        AND t.typname IN ('regcollation', 'regconfig', 'regdictionary', 'regnamespace',
                          'regoper', 'regoperator', 'regproc', 'regprocedure', 'aclitem')
      UNION ALL
      SELECT t.oid, 'system composite type ' || t.oid::pg_catalog.regtype::text
      FROM pg_catalog.pg_type AS t
      LEFT JOIN pg_catalog.pg_namespace AS n ON n.oid = t.typnamespace
      WHERE t.typtype = 'c'
        AND (t.oid < 16384 OR n.nspname = 'information_schema')
      UNION ALL
      SELECT derived.type_oid, derived.base_type
      FROM (
        WITH found AS (SELECT type_oid, base_type FROM problem_types)
        SELECT t.oid AS type_oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN found AS f ON t.typtype = 'd' AND t.typbasetype = f.type_oid
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN found AS f ON t.typtype = 'b' AND t.typelem = f.type_oid
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN pg_catalog.pg_class AS c ON c.reltype = t.oid
        JOIN pg_catalog.pg_attribute AS a ON a.attrelid = c.oid AND NOT a.attisdropped
        JOIN found AS f ON a.atttypid = f.type_oid
        WHERE t.typtype = 'c'
        UNION ALL
        SELECT t.oid, f.base_type
        FROM pg_catalog.pg_type AS t
        JOIN pg_catalog.pg_range AS r ON r.rngtypid = t.oid
        JOIN found AS f ON r.rngsubtype = f.type_oid
        WHERE t.typtype = 'r'
      ) AS derived
    )
    SELECT DISTINCT n.nspname AS schema_name, c.relname AS relation_name, a.attname AS column_name,
           a.atttypid::pg_catalog.regtype AS data_type, p.base_type
    FROM pg_catalog.pg_attribute AS a
    JOIN pg_catalog.pg_class AS c ON c.oid = a.attrelid
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    JOIN problem_types AS p ON p.type_oid = a.atttypid
    WHERE a.attnum > 0
      AND NOT a.attisdropped
      AND c.relkind IN ('r', 'm', 'i')
      AND n.nspname NOT IN ('pg_catalog', 'information_schema')
      AND n.nspname !~ '^pg_toast_temp_|^pg_temp_'
    ORDER BY 1, 2, 3;
    
  9. Colonnes héritées ne disposant pas d'une contrainte NOT NULL présente dans leur table parente. Pas de lignes. Pour corriger une colonne répertoriée, le propriétaire de la table exécute ALTER TABLE <table_name> ALTER COLUMN <column_name> SET NOT NULL;.

    SELECT n.nspname AS schema_name, c.relname AS table_name, child.attname AS column_name
    FROM pg_catalog.pg_inherits AS i
    JOIN pg_catalog.pg_attribute AS child ON child.attrelid = i.inhrelid
    JOIN pg_catalog.pg_attribute AS parent
      ON parent.attrelid = i.inhparent AND parent.attname = child.attname
    JOIN pg_catalog.pg_class AS c ON c.oid = i.inhrelid
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    WHERE parent.attnum > 0
      AND parent.attnotnull
      AND NOT child.attnotnull
      AND NOT child.attisdropped;
    
  10. Extensions installées. Terminez la préparation de l'extension. Vérifiez ensuite que toutes les extensions restantes sont disponibles dans la version cible, par exemple sur un environnement de préproduction de cette version.

    SELECT extname, extversion
    FROM pg_catalog.pg_extension
    ORDER BY extname;
    
  11. UNLOGGED tableaux et séquences. Leur contenu n'est pas conservé lors de la mise à niveau, et un tableau répertorié oblige le service à reconstruire chaque membre HA. Avant de procéder à la mise à niveau, consultez les tableaux UNLOGGED et les séquences.

    SELECT n.nspname AS schema_name, c.relname AS relation_name, c.relkind
    FROM pg_catalog.pg_class AS c
    JOIN pg_catalog.pg_namespace AS n ON n.oid = c.relnamespace
    WHERE c.relpersistence = 'u'
      AND c.relkind IN ('r', 'S');
    
  12. Fonctions SQL susceptibles d'entraîner l'échec de la conversion. Pas de lignes. La requête répertorie les fonctions LANGUAGE sql dont le corps est une chaîne de caractères et qui sont utilisées par un index, un prédicat d'index partiel, une clé de partition, une colonne générée en base de données ou des statistiques étendues. Il traite des appels via des opérateurs, des contraintes de vérification de domaine et des fonctions dont le corps est conforme à la norme SQL. Pour chaque fonction répertoriée, consultez les fonctions SQL dans les index, les clés de partition et les colonnes générées.

    WITH RECURSIVE uses (refclassid, refobjid, used_by) AS (
      SELECT d.refclassid, d.refobjid,
             CASE WHEN c.relkind = 'p' THEN 'partition key of ' ELSE 'index ' END
               || c.oid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND c.oid = d.objid
      WHERE c.relkind IN ('i', 'I') OR (c.relkind = 'p' AND d.objsubid = 0)
      UNION
      SELECT d.refclassid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_attrdef AS ad
        ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass
       AND ad.oid = d.objid
      JOIN pg_catalog.pg_attribute AS a
        ON a.attrelid = ad.adrelid
       AND a.attnum = ad.adnum
      WHERE a.attgenerated = 's'
      UNION
      SELECT d.refclassid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_attribute AS a
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND a.attrelid = d.objid
       AND a.attnum = d.objsubid
      WHERE a.attgenerated = 's'
      UNION
      SELECT d.refclassid, d.refobjid, 'statistics ' || s.stxname || ' on ' || s.stxrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_statistic_ext AS s
        ON d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass
       AND s.oid = d.objid
    ), used (fn, used_by) AS (
      SELECT x.fn, u.used_by
      FROM uses AS u
      CROSS JOIN LATERAL (
        SELECT u.refobjid AS fn
        WHERE u.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE u.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = u.refobjid
        UNION ALL
        SELECT dc.refobjid
        FROM pg_catalog.pg_constraint AS con
        JOIN pg_catalog.pg_depend AS dc
          ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass
         AND dc.objid = con.oid
         AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        WHERE u.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass
          AND con.contypid = u.refobjid
      ) AS x
      UNION
      SELECT x.fn, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND p.proconfig IS NULL
       AND NOT p.prosecdef
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
      CROSS JOIN LATERAL (
        SELECT d.refobjid AS fn
        WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = d.refobjid
      ) AS x
    )
    SELECT DISTINCT u.fn::pg_catalog.regprocedure AS function_name, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE l.lanname = 'sql'
      AND p.prosqlbody IS NULL
      AND p.proconfig IS NULL
      AND NOT p.prosecdef
      AND p.pronamespace <> 'pg_catalog'::pg_catalog.regnamespace
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.pg_depend AS e
                      WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
                        AND e.objid = p.oid
                        AND e.deptype = 'e')
    ORDER BY 1, 2;
    
  13. Index et colonnes générées stockées qui utilisent earthdistance la version 1.1, directement ou via des fonctions dont le corps est conforme à la norme SQL. Pas de lignes. Pour chaque élément répertorié, voir earthdistance.

    WITH RECURSIVE used (fn, via, used_by) AS (
      SELECT d.refobjid, d.refobjid, 'index ' || c.oid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c
        ON d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
       AND c.oid = d.objid
       AND c.relkind IN ('i', 'I')
      WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
      UNION
      SELECT d.refobjid, d.refobjid,
             'generated column ' || a.attname || ' of ' || a.attrelid::pg_catalog.regclass::text
      FROM pg_catalog.pg_depend AS d
      LEFT JOIN pg_catalog.pg_attrdef AS ad
        ON d.classid = 'pg_catalog.pg_attrdef'::pg_catalog.regclass
       AND ad.oid = d.objid
      JOIN pg_catalog.pg_attribute AS a
        ON a.attgenerated = 's'
       AND ((a.attrelid = ad.adrelid AND a.attnum = ad.adnum)
            OR (d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
                AND a.attrelid = d.objid
                AND a.attnum = d.objsubid))
      WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
      UNION
      SELECT d.refobjid, u.via, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND p.proconfig IS NULL
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
       AND d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
    )
    SELECT e.extversion, u.via::pg_catalog.regprocedure AS used_function, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_depend AS m
      ON m.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
     AND m.objid = u.fn
     AND m.refclassid = 'pg_catalog.pg_extension'::pg_catalog.regclass
     AND m.deptype = 'e'
    JOIN pg_catalog.pg_extension AS e ON e.oid = m.refobjid
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE e.extname = 'earthdistance'
      AND e.extversion IN ('1.0', '1.1')
      AND l.lanname = 'sql'
      AND p.proconfig IS NULL
    ORDER BY 2, 3;
    
  14. Vues, vues matérialisées, agrégats et fonctions utilisant des noms de catalogue système ou des paramètres de configuration supprimés dans une version ultérieure de PostgreSQL. La colonne removed_in présente la première version sans le nom. Il ne devrait y avoir aucune ligne dont la version removed_in est égale ou inférieure à votre version cible. Un nom peut correspondre à un texte qui n'est pas une référence de catalogue; veuillez donc vérifier chaque élément répertorié. Voir les objets qui utilisent des noms de système supprimés.

    WITH removed (relation_name, identifier, removed_in) AS (
      VALUES (NULL, 'pg_is_in_backup', 15), (NULL, 'pg_backup_start_time', 15),
             (NULL, 'pg_start_backup', 15), (NULL, 'pg_stop_backup', 15),
             ('pg_database', 'datlastsysoid', 15),
             (NULL, 'force_parallel_mode', 16),
             ('pg_stat_bgwriter', 'checkpoints_timed', 17), ('pg_stat_bgwriter', 'checkpoints_req', 17),
             ('pg_stat_bgwriter', 'checkpoint_write_time', 17), ('pg_stat_bgwriter', 'checkpoint_sync_time', 17),
             ('pg_stat_bgwriter', 'buffers_checkpoint', 17), ('pg_stat_bgwriter', 'buffers_backend', 17),
             ('pg_stat_bgwriter', 'buffers_backend_fsync', 17),
             (NULL, 'pg_stat_get_bgwriter_timed_checkpoints', 17),
             (NULL, 'pg_stat_get_bgwriter_requested_checkpoints', 17),
             (NULL, 'pg_stat_get_checkpoint_write_time', 17), (NULL, 'pg_stat_get_checkpoint_sync_time', 17),
             (NULL, 'pg_stat_get_bgwriter_buf_written_checkpoints', 17),
             (NULL, 'pg_stat_get_buf_written_backend', 17), (NULL, 'pg_stat_get_buf_fsync_backend', 17),
             ('pg_stat_progress_vacuum', 'max_dead_tuples', 17),
             ('pg_stat_progress_vacuum', 'num_dead_tuples', 17),
             ('pg_database', 'daticulocale', 17), ('pg_collation', 'colliculocale', 17),
             ('element_types', 'domain_default', 17),
             (NULL, 'interval_accum', 17), (NULL, 'interval_accum_inv', 17), (NULL, 'interval_combine', 17),
             ('pg_stat_wal', 'wal_write', 18), ('pg_stat_wal', 'wal_sync', 18),
             ('pg_stat_wal', 'wal_write_time', 18), ('pg_stat_wal', 'wal_sync_time', 18),
             ('pg_stat_io', 'op_bytes', 18), ('pg_backend_memory_contexts', 'parent', 18),
             ('pg_attribute', 'attcacheoff', 18)
    ), definitions (object_name, definition) AS (
      SELECT 'view ' || c.oid::pg_catalog.regclass::text, pg_catalog.pg_get_viewdef(c.oid)
      FROM pg_catalog.pg_class AS c
      WHERE c.relkind IN ('v', 'm')
        AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
      UNION ALL
      SELECT 'function ' || p.oid::pg_catalog.regprocedure::text,
             pg_catalog.concat_ws(' ', pg_catalog.pg_get_function_sqlbody(p.oid),
                                  pg_catalog.array_to_string(p.proconfig, ' '))
      FROM pg_catalog.pg_proc AS p
      WHERE (p.prosqlbody IS NOT NULL OR p.proconfig IS NOT NULL)
        AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
      UNION ALL
      SELECT 'aggregate ' || a.aggfnoid::pg_catalog.regprocedure::text,
             pg_catalog.concat_ws(' ', a.aggtransfn, a.aggfinalfn, a.aggcombinefn,
                                  a.aggmtransfn, a.aggminvtransfn, a.aggmfinalfn)
      FROM pg_catalog.pg_aggregate AS a
      JOIN pg_catalog.pg_proc AS p ON p.oid = a.aggfnoid
      WHERE p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                   'information_schema'::pg_catalog.regnamespace)
    )
    SELECT d.object_name, r.identifier, r.removed_in
    FROM definitions AS d
    JOIN removed AS r
      ON d.definition ~ ('\m' || r.identifier || '\M')
     AND (r.relation_name IS NULL OR d.definition ~ ('\m' || r.relation_name || '\M'))
    ORDER BY 3, 1, 2;
    
  15. Noms de bases de données que la mise à niveau ne peut pas utiliser. Pas de lignes. Pour corriger une base de données répertoriée, son propriétaire doit se connecter à une autre base de données et exécuter la commande ALTER DATABASE "<database_name>" RENAME TO <new_name>; tant qu'aucune session n'est connectée à la base de données en cours de renommage. Le propriétaire doit également disposer de l'attribut CREATEDB. Ensuite, mettez à jour toutes les applications qui se connectent à la base de données.

    SELECT datname
    FROM pg_catalog.pg_database
    WHERE pg_catalog.strpos(datname, '''') > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(92)) > 0
       OR pg_catalog.strpos(datname, '=') > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(10)) > 0
       OR pg_catalog.strpos(datname, pg_catalog.chr(13)) > 0
    ORDER BY datname;
    
  16. Les relations verrouillées par la mise à niveau, les objets volumineux et la capacité de verrouillage du déploiement. Additionnez les valeurs des locked_relations quatre bases de données présentant les valeurs les plus élevées. Sur PostgreSQL 14 et 15, cela inclut locked_relations les vues et les vues matérialisées, car la mise à niveau les verrouille également. Si le total dépasse lock_capacity, augmentez max_locks_per_transaction jusqu'à ce que dépasse lock_capacity le total. Cette modification entraîne le redémarrage de la base de données; veillez donc à l'effectuer avant de valider la mise à jour. La présence de nombreux tableaux ou d'objets volumineux peut également allonger la durée de la conversion; veillez donc à tester la mise à niveau avec votre schéma et vos données réels.

    SELECT pg_catalog.current_database() AS database_name,
           (SELECT pg_catalog.count(*)
            FROM pg_catalog.pg_class AS c
            WHERE (c.relkind IN ('r', 'p', 'S')
                   OR (c.relkind IN ('v', 'm')
                       AND pg_catalog.current_setting('server_version_num')::integer < 160000))
              AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                         'information_schema'::pg_catalog.regnamespace)) AS locked_relations,
           (SELECT pg_catalog.count(*)
            FROM pg_catalog.pg_largeobject_metadata) AS large_objects,
           pg_catalog.current_setting('max_locks_per_transaction')::integer
             * (pg_catalog.current_setting('max_connections')::integer
                + pg_catalog.current_setting('max_prepared_transactions')::integer) AS lock_capacity;
    
  17. Fonctions sans search_path paramètre d’indexation, vues matérialisées et statistiques étendues. La requête suit les appels via des opérateurs, des contraintes de vérification de domaine et des fonctions, avec un corps conforme à la norme SQL. Exécutez cette requête si vous effectuez une mise à niveau depuis PostgreSQL 16 ou une version antérieure vers PostgreSQL 17 ou une version ultérieure. Une fonction répertoriée dont le corps nomme des objets externes sans pg_catalog leur schéma entraîne l'échec des commandes de maintenance après la mise à niveau. Une fonction n'est pas affectée uniquement si son corps, ainsi que toutes les fonctions qu'elle appelle, désignent chaque objet externe pg_catalog avec son schéma. Pour chaque autre fonction répertoriée, son propriétaire ajoute un search_path paramètre, comme décrit dans la section Fonctions SQL dans les index, les clés de partition et les colonnes générées.

    WITH RECURSIVE refreshed (relid, used_by) AS (
      SELECT c.oid, c.oid::pg_catalog.regclass
      FROM pg_catalog.pg_class AS c
      WHERE c.relkind = 'm'
      UNION
      SELECT v.oid, f.used_by
      FROM refreshed AS f
      JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass
       AND d.objid = r.oid
       AND d.refclassid = 'pg_catalog.pg_class'::pg_catalog.regclass
      JOIN pg_catalog.pg_class AS v ON v.oid = d.refobjid AND v.relkind = 'v'
    ), refs (refclassid, refobjid, used_by) AS (
      SELECT d.refclassid, d.refobjid, c.oid::pg_catalog.regclass
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_class AS c ON c.oid = d.objid AND c.relkind IN ('i', 'I')
      WHERE d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
      UNION
      SELECT d.refclassid, d.refobjid, f.used_by
      FROM refreshed AS f
      JOIN pg_catalog.pg_rewrite AS r ON r.ev_class = f.relid
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_rewrite'::pg_catalog.regclass
       AND d.objid = r.oid
      UNION
      SELECT d.refclassid, d.refobjid, s.stxrelid::pg_catalog.regclass
      FROM pg_catalog.pg_depend AS d
      JOIN pg_catalog.pg_statistic_ext AS s ON s.oid = d.objid
      WHERE d.classid = 'pg_catalog.pg_statistic_ext'::pg_catalog.regclass
    ), used (fn, used_by) AS (
      SELECT x.fn, r.used_by
      FROM refs AS r
      CROSS JOIN LATERAL (
        SELECT r.refobjid AS fn
        WHERE r.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE r.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = r.refobjid
        UNION ALL
        SELECT dc.refobjid
        FROM pg_catalog.pg_constraint AS con
        JOIN pg_catalog.pg_depend AS dc
          ON dc.classid = 'pg_catalog.pg_constraint'::pg_catalog.regclass
         AND dc.objid = con.oid
         AND dc.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        WHERE r.refclassid = 'pg_catalog.pg_type'::pg_catalog.regclass
          AND con.contypid = r.refobjid
      ) AS x
      UNION
      SELECT x.fn, u.used_by
      FROM used AS u
      JOIN pg_catalog.pg_proc AS p
        ON p.oid = u.fn
       AND p.prosqlbody IS NOT NULL
       AND NOT EXISTS (SELECT 1
                       FROM pg_catalog.unnest(p.proconfig) AS setting
                       WHERE setting LIKE 'search\_path=%')
      JOIN pg_catalog.pg_depend AS d
        ON d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
       AND d.objid = u.fn
      CROSS JOIN LATERAL (
        SELECT d.refobjid AS fn
        WHERE d.refclassid = 'pg_catalog.pg_proc'::pg_catalog.regclass
        UNION ALL
        SELECT o.oprcode::pg_catalog.oid
        FROM pg_catalog.pg_operator AS o
        WHERE d.refclassid = 'pg_catalog.pg_operator'::pg_catalog.regclass
          AND o.oid = d.refobjid
      ) AS x
    )
    SELECT DISTINCT p.oid::pg_catalog.regprocedure AS function_name, u.used_by
    FROM used AS u
    JOIN pg_catalog.pg_proc AS p ON p.oid = u.fn
    JOIN pg_catalog.pg_language AS l ON l.oid = p.prolang
    WHERE l.lanname NOT IN ('c', 'internal')
      AND p.prosqlbody IS NULL
      AND p.pronamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                                 'information_schema'::pg_catalog.regnamespace)
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.unnest(p.proconfig) AS setting
                      WHERE setting LIKE 'search\_path=%')
      AND NOT EXISTS (SELECT 1
                      FROM pg_catalog.pg_depend AS e
                      WHERE e.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass
                        AND e.objid = p.oid
                        AND e.deptype = 'e')
    ORDER BY 1, 2;
    

Le fait de satisfaire à ces vérifications ne garantit pas que la mise à niveau aboutira ni que vos applications seront compatibles avec la version cible. Seule une simulation sur un environnement de test exécute la conversion dans son intégralité.

Planification de la fenêtre de mise à niveau

Utilisez votre simulation de mise en place pour estimer une fenêtre de maintenance. La durée de la conversion dépend principalement du nombre de bases de données et d'objets. La reconstruction d'un nœud HA dépend de la taille de la base de données. La charge de travail et le volume des journaux de transactions ont une incidence sur les vérifications et la mise à jour. Prévoyez suffisamment de temps pour l'ensemble de la mise à niveau, et pas seulement pour la durée pendant laquelle les écritures sont bloquées.

L'heure de début d'expiration définit l'heure la plus tardive à laquelle une mise à niveau en file d'attente peut commencer. Par défaut, le délai est de 5 minutes après la demande, et vous pouvez le configurer jusqu'à 24 heures à l'avance. Les opérations en cours, telles qu'une sauvegarde, ainsi que les demandes mises en file d'attente précédemment retardent le démarrage. Si la mise à niveau ne démarre pas avant son heure d'expiration, elle ne s'exécute pas et la tâche correspondante affiche le statut Expiré. L'expiration n'interrompt pas une mise à niveau qui a déjà commencé. Par exemple, une requête mise en file d'attente expire à 22 h 30 UTC. Une tâche qui démarre à 22 h 25 UTC peut se poursuivre au-delà de cette heure.

Pendant la mise à jour, les autres demandes de déploiement sont mises en attente jusqu'à ce qu'elle soit terminée. Ces opérations comprennent la mise à l'échelle manuelle et automatique, les modifications de configuration, les modifications apportées aux utilisateurs et aux mots de passe, les modifications des adresses IP autorisées et les sauvegardes. Ne supprimez pas le déploiement tant que la tâche de mise à niveau est en attente ou en cours d'exécution.

Ne créez pas de répliques en lecture seule tant que la tâche n'est pas terminée. Le service ne bloque pas ce type de requêtes. Si vous en créez une, la mise à niveau peut échouer lors des vérifications préalables, ou la nouvelle réplique ne pourra pas se répliquer à partir du déploiement mis à niveau. Supprimez cette réplique, puis créez-en une nouvelle une fois la tâche terminée.

Mise à niveau via l'interface utilisateur

  1. Créer et vérifier une sauvegarde à la demande. La mise à niveau ne dure pas une seconde.
  2. Sur la page Aperçu du déploiement, cliquez sur Mettre à niveau la version majeure.
  3. À l'étape Conseils, consultez les conseils, sélectionnez J'ai lu les conseils et je suis prêt à procéder à la mise à niveau, puis cliquez sur Suivant. Pour savoir quand les opérations de lecture et d'écriture ne sont pas disponibles, consultez la section Disponibilité pendant une mise à niveau.
  4. Dans la section Mise à niveau vers la version, sélectionnez la version cible. Si plusieurs cibles sont disponibles, la liste sélectionne par défaut la plus récente. La remarque concernant les répliques de lecture dans cette étape est obsolète. La mise à niveau échoue aux vérifications préalables tant qu'une réplique en lecture seule est associée au déploiement; veillez donc à promouvoir ou à supprimer toutes les répliques avant de procéder à la mise à niveau.
  5. Dans le champ Délai d'expiration avant le lancement de la mise à niveau, sélectionnez la durée pendant laquelle la demande peut rester en attente avant d'être lancée. La valeur par défaut est 5 minutes.
  6. Cliquez sur Upgrade. Tant que la demande est en attente ou en cours d'exécution, la ligne Version de la page Aperçu affiche Mise à niveau en attente ou Mise à niveau en cours.
  7. Suivez la tâche dans la section Tâches récentes. Dès que les écritures reprennent, actualisez les statistiques comme décrit dans la section Après la mise à niveau. Lorsque la tâche indique Terminé, effectuez les étapes restantes de cette section. Si le message Échec s'affiche, consultez la section Dépannage. Si la mention Expiré s'affiche, cela signifie que la mise à niveau n'a pas démarré; vous pouvez la soumettre à nouveau en indiquant une date d'expiration ultérieure.

Mise à niveau via l'API

Envoyer une requête PATCH à l'endpoint /deployments/{id}/version. Définissez version la version majeure cible, puis définissez la date de début d'expiration à l'aide du paramètre de requête expiration_datetime:

curl -X PATCH \
  'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/version?expiration_datetime=<EXPIRATION_TIME>' \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"version": "18"}'

Remplacer <EXPIRATION_TIME> par une heure UTC au format ISO 8601, par exemple 2026-11-03T22:30:00Z, entre 5 minutes et 24 heures après la requête. Si vous omettez expiration_datetime, la requête expire si elle ne démarre pas dans les 5 minutes.

Une requête réussie renvoie une tâche. Une demande acceptée ne signifie pas que la mise à niveau est terminée. Utilisez l'ID de la tâche avec la fonction Obtenir des informations sur une tâche pour suivre la mise à niveau. Pour répertorier les cibles disponibles, utilisez la fonctionnalité Discover à partir d'un déploiement disposant de cette fonctionnalité versions. Pour tous les paramètres, consultez la documentation de référence de l'API.

Mise à niveau via l'interface de ligne de commande

Utilisez la version 0.20.0 ou une version ultérieure du plug-in CLI Cloud Databases. Définissez le délai d'expiration initial à l'aide de --expire-in ou --expire-at, entre 5 minutes et 24 heures après la requête. La valeur par défaut est 5 minutes.

ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION> --expire-in 1h --nowait

Sans --nowait, la commande attend que la tâche soit terminée ou échoue. Elle ne renvoie rien si la mise à niveau expire avant de démarrer; utilisez donc dans --nowait les scripts. Avec --nowait, la commande renvoie une réponse une fois que le service a accepté la requête. Suivre la tâche avec deployment-tasks-list:

ibmcloud cdb deployment-tasks-list <NAME|CRN>

Pour tous les paramètres, exécutez ibmcloud cdb deployment-version-upgrade --help.

Mise à niveau via Terraform

Utilisez le fournisseur Terraform IBM Cloud®, version 1.79.2 ou ultérieure. Définissez une version cible réalisable, examinez le plan et mettez-le en œuvre. Le plan échoue si la cible n'est pas disponible pour une mise à niveau sur place.

Définissez le délai d'expiration de mise à jour de la ressource sur une durée suffisante pour permettre la mise à niveau complète, et d'au moins 5 minutes. Le fournisseur utilise également ce délai d'expiration, pouvant aller jusqu'à 24 heures, comme date de début d'expiration. Une mise à jour mise en file d'attente peut donc démarrer à tout moment jusqu'à l'expiration du délai. Appliquez la modification lorsqu'aucune sauvegarde ni aucune autre opération n'est en cours d'exécution ou en attente, afin que la mise à niveau démarre immédiatement. Si le délai d'application expire après le début de la mise à niveau, celle-ci se poursuit. Si la mise à niveau est toujours en attente à l'expiration du délai, elle expire et n'est pas exécutée. Attendez que la tâche soit terminée avant de relancer ou terraform plan à nouveau terraform apply.

Si la mise à niveau échoue, effectuez les étapes de dépannage avant de terraform apply relancer l'opération. Terraform renvoie la mise à jour dès que le déploiement signale encore la version source.

Après une mise à jour effectuée en dehors de Terraform, définissez version sur la nouvelle version ou supprimez version de la configuration. Les mises à jour hors Terraform comprennent les mises à jour de l'interface utilisateur, de l'interface de ligne de commande ou de l'API, ainsi que les mises à jour forcées. Tant que vous n’avez pas mis à jour la configuration, toutes les opérations et terraform plan qui terraform apply incluent ce déploiement échouent, ce qui empêche toute modification des autres ressources de cette même configuration. L'erreur est similaire à ou Version 14 is not a valid upgrade version No available upgrade versions for version 18.

Cet argument version_upgrade_skip_backup n'est pas pris en charge par PostgreSQL. Pour plus d'informations, consultez le guide de référence des ressources de la base de données.

Après la mise à jour

Dès que les écritures reprennent, assurez-vous que les statistiques de l'optimiseur sont complètes. N'attendez pas la fin de la tâche. Les écritures reprennent lorsque l'on revient SHOW default_transaction_read_only; dans off une nouvelle session. Dans chaque base de données, la requête suivante répertorie vos tables et vos vues matérialisées qui ne disposent d'aucune statistique. Exécuter ANALYZE <table_name>; pour chaque relation répertoriée. Si votre utilisateur ne dispose pas des autorisations nécessaires pour analyser une relation, exécutez la commande en tant que propriétaire de la relation. L'analyse d'une table partitionnée implique également l'analyse de ses partitions.

SELECT c.oid::pg_catalog.regclass AS relation_name
FROM pg_catalog.pg_class AS c
WHERE c.relkind IN ('r', 'm', 'p')
  AND c.reltuples < 0
  AND NOT c.relispartition
  AND c.relpersistence <> 't'
  AND c.relnamespace NOT IN ('pg_catalog'::pg_catalog.regnamespace,
                             'information_schema'::pg_catalog.regnamespace)
  AND NOT EXISTS (SELECT 1
                  FROM pg_catalog.pg_depend AS e
                  WHERE e.classid = 'pg_catalog.pg_class'::pg_catalog.regclass
                    AND e.objid = c.oid
                    AND e.deptype = 'e');

Sous PostgreSQL 17 et versions ultérieures, ANALYZE peut échouer et générer une erreur telle que function ... does not exist. Dans ce cas, corrigez la fonction répertoriée dans la requête d'autocontrôle n° 17, puis relancez l'opération ANALYZE. Une requête portant sur l'ensemble de la base de données ANALYZE qui s'interrompt en raison d'une erreur n'analyse pas les tables restantes. Sous PostgreSQL 18, analysez également chaque table comportant des objets statistiques, tels que répertoriés par la commande psql \dX, ainsi que chaque table contenant des colonnes PostGIS, car la mise à niveau ne transfère pas ces statistiques.

Une fois que la tâche affiche Terminé:

  1. Vérifiez que la version du déploiement affichée dans la console ou via l’API correspond bien à la version cible, et que la commande la renvoie SHOW server_version;. Exécutez la requête d'autovérification n° 1 et vérifiez que tous les membres HA transmettent des données en continu. Vérifiez également que les écritures ont bien repris dans toutes les bases de données : la requête suivante ne renvoie aucune ligne. Si un membre HA est manquant, si une ligne nommée pg_basebackup subsiste ou si la requête répertorie une base de données, contactez le support.

    SELECT d.datname AS database_name, s.setconfig
    FROM pg_catalog.pg_db_role_setting AS s
    JOIN pg_catalog.pg_database AS d ON d.oid = s.setdatabase
    WHERE s.setrole = 0
      AND d.datallowconn
      AND NOT d.datistemplate
      AND EXISTS (SELECT 1
                  FROM pg_catalog.unnest(s.setconfig) AS c(setting)
                  WHERE c.setting LIKE 'default_transaction_read_only=%');
    
  2. Mise à jour des extensions. La mise à jour conserve chaque extension à la version installée. Dans chaque base de données, répertoriez les extensions pour lesquelles une version plus récente est disponible, puis mettez-les à jour :

    SELECT name, installed_version, default_version
    FROM pg_catalog.pg_available_extensions
    WHERE installed_version <> default_version;
    
    ALTER EXTENSION <extension_name> UPDATE;
    

    Si vous avez effectué une mise à niveau depuis PostgreSQL 14, 15 ou 16 vers PostgreSQL 17 ou une version ultérieure, la mise à jour renomme pg_stat_statements ses colonnes blk_write_time blk_read_time et en shared_blk_read_time et shared_blk_write_time. Mettez à jour les requêtes qui consultent ces colonnes.

  3. Restaurer les extensions et le masquage comme décrit dans la phase de préparation. Rechargez les tableaux UNLOGGED à partir du contenu que vous avez exporté. Définissez chaque UNLOGGED séquence en dépassant les valeurs utilisées, par exemple avec SELECT setval('<sequence_name>', (SELECT max(<column_name>) FROM <table_name>));. Recréez les slots de réplication logiques, les abonnements et les répliques en lecture seule que vous avez supprimés, puis activez les abonnements que vous avez désactivés. Reconnectez les consommateurs et resynchronisez les données avant de relancer les applications dépendantes.

  4. Si vous avez défini default_transaction_read_only pour une base de données, redéfinissez-le. La mise à niveau réinitialise ce paramètre sur chaque base de données, afin que celles-ci acceptent à nouveau les écritures.

  5. Vérifiez que la sauvegarde post-mise à niveau s'est bien effectuée. Comme il copie l'intégralité de la base de données, cette opération peut prendre plusieurs heures. Si vous avez besoin d'une restauration à un instant donné pour les modifications apportées après la mise à niveau, suspendez les écritures de l'application jusqu'à ce moment-là.

  6. Si vous avez effectué une mise à niveau depuis PostgreSQL 14 ou 15 vers PostgreSQL 16 ou une version ultérieure, exécutez la requête relative aux rôles décrite dans la section Problèmes de privilèges liés aux rôles lors des mises à niveau de version. Attribuez les rôles répertoriés avant de relancer les tâches qui gèrent ces rôles.

  7. Si Terraform gère le déploiement et que vous avez effectué la mise à niveau en dehors de Terraform, définissez version sur la nouvelle version ou supprimez-le, comme décrit dans la section Mise à niveau via Terraform.

  8. Reprenez les écritures d'application et les tâches planifiées que vous aviez mises en pause. Restaurez les paramètres que vous avez modifiés lors de la mise à niveau, tels que synchronous_commit.

  9. Recompilez les objets qui dépendent de données Unicode, car les versions récentes de PostgreSQL utilisent des données Unicode plus récentes :

    • À moins que vous n'ayez effectué une mise à niveau de PostgreSQL 16 vers PostgreSQL 17, vérifiez les index, les vues matérialisées, les contraintes de validation et les clés de partition dont les expressions utilisent normalize() ou is_normalized(). Seuls les textes contenant des caractères apparus dans une version ultérieure d'Unicode sont concernés.
    • Si vous êtes passé de PostgreSQL 17 à PostgreSQL 18, vérifiez également les objets qui utilisent unicode_assigned(). Vérifiez également les objets qui appliquent les expressions régulières, ILIKE, lower()``upper(), ou initcap() au texte dans la locale C.UTF-8 intégrée. Le classement pg_c_utf8 et les bases de données qui utilisent le fournisseur de paramètres régionaux builtin avec C.UTF-8 utilisent ces paramètres régionaux.
    • Si vous avez effectué une mise à niveau vers PostgreSQL 18 et qu'une base de données utilise le fournisseur de paramètres régionaux builtin icu ou, reconstruisez sa recherche en texte intégral et ses index pg_trgm.

    Exécutez REINDEX INDEX <index_name>; pour chaque index concerné et REFRESH MATERIALIZED VIEW <view_name>; pour chaque vue matérialisée concernée. Assurez-vous que les lignes respectent toujours les contraintes de vérification concernées et se trouvent dans les partitions appropriées.

  10. Comparez le comportement et les performances de l'application avec vos résultats de préproduction.

Traitement des incidents

Si le service rejette une requête, l'erreur s'affiche immédiatement. L'interface utilisateur affiche généralement le message Échec de la mise à niveau accompagné de la raison, l'API renvoie le message d'erreur et l'interface en ligne de commande affiche l'erreur avec une indication. Corrigez la demande, puis renvoyez-la.

Si la tâche indique Expiré, cela signifie que la mise à niveau n'a pas démarré et que le déploiement reste inchangé. Lancez à nouveau la mise à niveau lorsqu'aucune autre opération n'est en cours d'exécution ou en file d'attente, ou définissez une date d'expiration de démarrage ultérieure.

Une tâche qui affiche par la suite le statut Échec n'identifie pas la vérification ou l'étape ayant échoué, et l'interface utilisateur n'affiche pas la cause. En fonction de l'étape ayant échoué, le déploiement peut se trouver dans l'un des états suivants :

  • Concernant la version source: le déploiement exécute la version source et accepte les écritures. L'échec d'un contrôle préalable maintient le déploiement dans cet état, et le service rétablit l'accès en écriture après la plupart des défaillances survenues en mode lecture seule. Une tentative infructueuse peut tout de même avoir des conséquences durables. Cela peut supprimer des tables old_snapshot``UNLOGGED, vider des tables, réinitialiser des séquences UNLOGGED et créer une lacune dans la couverture PITR. Il permet également de réinitialiser les paramètres default_transaction_read_only au niveau de la base de données, afin que celles-ci acceptent à nouveau les écritures. Si vous définissez default_transaction_read_only sur pour on une base de données quelconque, une tentative infructueuse met également fin à toutes les sessions client, même en cas d'échec d'un contrôle préalable.
  • À propos de la version cible: le déploiement utilise la version cible, mais la mise à niveau n'est pas terminée tant que le support technique ne l'a pas finalisée. La console et l'API peuvent toujours afficher la version source. Jusqu'à ce moment-là, les membres de la haute disponibilité (HA) risquent de ne pas fonctionner, et les sauvegardes ainsi que l'archivage des journaux de transactions peuvent échouer. Si l'autodiagnostic 1 ou 5 détecte un problème, suspendez les écritures de l'application jusqu'à ce que le support technique ait terminé la mise à niveau.
  • Problème: le déploiement reste en lecture seule ou indisponible, ou fonctionne sans ses composants HA, jusqu’à ce que le support technique le rétablisse. Un échec lors de la phase de conversion ou de redémarrage peut entraîner l'arrêt des membres HA jusqu'à ce que le support technique les redémarre, même après la reprise des écritures.

Pour identifier l'état, connectez-vous en tant que admin et exécutez SHOW server_version;. Dans chaque base de données que vous utilisez, exécutez SHOW default_transaction_read_only;. Exécutez la requête d'autocontrôle n° 1 pour vérifier que tous les membres HA transmettent des données en continu. Si vous ne parvenez pas admin à vous connecter après l'échec d'une tâche, par exemple en raison d'une erreur d'authentification, contactez le support technique. La mise à jour n'entraîne aucune modification de vos identifiants.

Si le déploiement accepte les écritures, exécute la version source et que tous les membres HA effectuent un streaming, vérifiez les pré-vérifications et exécutez les requêtes d'autocontrôle. Résolvez tous les problèmes non résolus, effectuez une sauvegarde à la demande, puis relancez la mise à niveau. Dans tous les autres cas, ou si la tentative suivante échoue également, contactez le support avant de réessayer ou d'effectuer d'autres modifications. Inclure :

  • Le CRN du déploiement et l'ID de la tâche ayant échoué. Notez l'ID de la tâche en cas d'échec, car les listes de tâches n'affichent que les tâches récentes.
  • Les versions source et cible demandées d' PostgreSQL, ainsi que la sortie de SHOW server_version;.
  • L'heure approximative de la panne et le fuseau horaire.
  • Si les applications peuvent se connecter, lire et écrire.
  • Résultats des requêtes d'autocontrôle.
  • Le CRN de chaque réplique en lecture seule associée, y compris toute réplique récemment promue ou supprimée.

Si la requête échoue en raison d'une erreur interne, contactez le support technique. Dans l'interface utilisateur, cette erreur s'affiche sous la forme Échec de la mise à niveau avec le message Échec de la création de la tâche de mise à niveau sur place. L'interface utilisateur affiche également ce message pour d'autres requêtes rejetées lorsqu'elle ne peut pas afficher la raison réelle du rejet. Pour connaître la raison, envoyez la requête à l'aide de l'interface de ligne de commande (CLI) ou de l'API. Contactez également le support si la tâche reste en cours bien plus longtemps que lors de votre simulation. Après une défaillance, la tâche peut rester en cours (statut running dans l’interface CLI et l’API) pendant que le service tente de se rétablir.

Ne supprimez que les objets indiqués dans les étapes de préparation et les requêtes d'autocontrôle. Ne laissez pas tomber d'autres objets pour passer un contrôle. Contactez plutôt le service d'assistance.

Mise à niveau à partir d'une réplique accessible en lecture seule

Créez une réplique en lecture seule à partir du déploiement source et attendez que la réplique se synchronise. Ensuite, effectuez la promotion et la mise à niveau de la réplique à l'aide du point de terminaison /remotes/promotion. Définir version une cible que la réplique mentionne parmi ses capacités :

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "promotion": {
        "version": "18",
        "skip_initial_backup": false
    }
}'

Définissez la valeur sur skip_initial_backup only true uniquement si vous souhaitez ignorer la sauvegarde initiale créée par la promotion. Ce paramètre peut raccourcir la durée de la tâche de promotion, mais la restauration à partir du déploiement promu nécessite ensuite une sauvegarde programmée ou à la demande réussie.

Si une mise à niveau vers une nouvelle version échoue, le service désactive le déploiement mis à niveau. Prenez contact avec le support. Testez une mise à niveau de version sur une réplique d'un déploiement de préproduction avant de l'utiliser en production.

Mise à niveau par restauration d'une sauvegarde

Restaurer une sauvegarde vers un déploiement utilisant une version cible prise en charge. Si vous restaurez une sauvegarde à l'aide de l'interface de ligne de commande (CLI) ou de l'API sans spécifier les paramètres d'allocation des ressources, le nouveau déploiement utilise les allocations de ressources dont disposait le déploiement source au moment de la création de la sauvegarde. Dans l'interface utilisateur, la page de restauration s'ouvre sur les allocations actuelles du déploiement source, que vous pouvez modifier.

Restauration d'une sauvegarde dans l'interface utilisateur

Dans la section Sauvegardes et restaurations du tableau de bord de déploiement, cliquez sur Restaurer la sauvegarde pour la sauvegarde que vous souhaitez utiliser. Sur la page qui s'ouvre, sélectionnez une version cible prise en charge dans la section Version de la base de données, puis configurez les options pour le nouveau déploiement. Cliquez ensuite sur Restaurer la sauvegarde.

Restauration d'une sauvegarde via l'interface de ligne de commande (CLI)

Créez le déploiement en indiquant la version cible et l'ID de sauvegarde dans l'argument JSON -p:

ibmcloud resource service-instance-create example-upgrade databases-for-postgresql standard us-south \
  -p '{
  "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "version": "18"
}' \
  --service-endpoints "public"

Restauration d'une sauvegarde via l'API

Utilisez l'API du contrôleur de ressources pour restaurer une sauvegarde dans un nouveau déploiement exécutant la version cible. Indiquez le nom du déploiement, l'emplacement, le groupe de ressources, le forfait, l'ID de sauvegarde et la version cible :

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <IAM_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "databases-for-postgresql-standard",
    "parameters": {
      "backup_id": "crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
      "version": "18"
    }
  }'

Mise à niveau forcée

Après la date de fin de vie, tous les déploiements actifs d' Databases for PostgreSQL qui exécutent la version obsolète sont automatiquement mis à niveau vers la prochaine version prise en charge.

Une mise à niveau forcée correspond à une procédure IPMVU; veillez donc à effectuer les préparatifs IPMVU avant la date de fin de vie.

Procédez à la mise à niveau avant la date de fin de vie pour éviter les risques suivants :

  • Aucun accord de niveau de service n'est prévu pour ce type de mise à niveau forcée.
  • Vous risquez de perdre certaines données.
  • Votre application pourrait subir une interruption de service prolongée.
  • Votre application risque de ne plus fonctionner si elle n'est pas compatible avec la nouvelle version.
  • Vous ne pouvez pas contrôler le moment où cette mise à niveau aura lieu pour votre déploiement.
  • Il n'y a pas de processus de retour en arrière pour cette mise à niveau forcée.
  • Si Terraform gère le déploiement et configure version, chaque échoue terraform plan après la mise à niveau forcée jusqu'à ce que vous mettiez à jour version.

Pour connaître les dates de fin de vie, consultez la page relative à la politique de version.

Problèmes liés aux privilèges des rôles lors des mises à niveau de version

Dans PostgreSQL 16 et versions ultérieures, un rôle doté de l'attribut CREATEROLE, tel que admin, nécessite le droit sur ADMIN OPTION un autre rôle pour pouvoir le gérer. La gestion d'un rôle comprend la modification de son mot de passe ou de ses attributs, sa suppression et l'attribution de son appartenance. Une mise à niveau d’ PostgreSQL 14 ou 15 vers la version 16 ou une version ultérieure ne permet pas d’utiliser cette admin option sur les rôles qui existaient avant la mise à niveau. Les tâches qui gèrent ces rôles admin, telles que la rotation des mots de passe, échouent alors. Pour plus d'informations, consultez les notes de mise à jour d' PostgreSQL 16, les attributs de rôle et les autorisations de rôle.

Par exemple, un changement de mot de passe échoue avec le message suivant :

ERROR:  permission denied to alter role
DETAIL:  To change another role's password, the current user must have the CREATEROLE attribute and the ADMIN option on the role.

Avant de procéder à la mise à niveau, exécutez la requête suivante en tant que admin. Il répertorie les rôles qui admin ne peuvent plus être gérés après la mise à niveau, à l'exception des utilisateurs que vous créez via l'interface utilisateur, la ligne de commande ou l'API. À partir d' PostgreSQL 16, il admin n'est pas non plus possible de modifier ces utilisateurs; vous devez donc les gérer via l'interface utilisateur, la ligne de commande ou l'API.

SELECT r.rolname AS role_name,
       pg_catalog.pg_has_role(r.oid, 'admin'::name, 'MEMBER') AS member_of_admin
FROM pg_catalog.pg_roles AS r
WHERE NOT r.rolsuper
  AND NOT r.rolreplication
  AND r.rolname <> 'admin'
  AND r.rolname !~ '^(pg_|ibm-)'
  AND NOT EXISTS (
      SELECT 1
      FROM pg_catalog.pg_auth_members AS m
      JOIN pg_catalog.pg_roles AS b ON b.oid = m.roleid
      WHERE m.member = r.oid
        AND b.rolname IN ('ibm-cloud-base-user', 'ibm-cloud-base-user-ro'))
  AND NOT pg_catalog.pg_has_role(r.oid, 'MEMBER WITH ADMIN OPTION')
ORDER BY 1;

Pour continuer à gérer un rôle répertorié, attribuez-le à avant admin de procéder à la mise à niveau :

GRANT <role_name> TO admin WITH ADMIN OPTION;

Cette attribution échoue pour un rôle dont la valeur member_of_admin est t, car ce rôle est membre de admin. Après la mise à niveau, il n'est admin plus possible de gérer ce type de rôle.

Après une mise à niveau vers PostgreSQL, version 16 ou ultérieure, relancez la requête. Pour chaque rôle répertorié dont la valeur member_of_admin est f, exécutez l'utilitaire suivant lorsque vous êtes connecté à ou ibmclouddb à n'importe quelle base de données, à l'exception de postgres. Ne mentionnez pas d'autres rôles, car l'échec d'une seule attribution annule l'ensemble de l'appel. Vous pouvez exécuter l'assistant en toute sécurité plusieurs fois :

SELECT grant_admin_option_to_roles('role1', 'role2', 'role3');

Ces deux attributions font également de admin un membre du rôle, ce qui lui admin permet d'utiliser les privilèges de ce rôle.

Journal des modifications des versions PostgreSQL principales