Guide de mise à niveau des versions majeures pour OCI Database with PostgreSQL

• pg_dump et pg_restore sont des outils de sauvegarde logique.
• Convient pour les mises à niveau de version majeures.
• Requiert un temps d'inactivité pendant la permutation finale.
• Les rôles doivent toujours être gérés séparément.

Le processus de mise à niveau à l'aide de pg_dump et pg_restore comprend les étapes suivantes.

1. Etape 1 : vidage des objets globaux (rôles)

   Cette étape permet de garantir que tous les rôles, droits d'accès et contrôles d'accès sont préservés, ce qui permet aux utilisateurs et aux applications de maintenir un accès cohérent après la mise à niveau.

2. Etape 2 : vidage de la base de données

   Cette étape crée une sauvegarde logique complète de la base de données, fournissant un moyen fiable de transférer des données dans l'environnement mis à niveau.

3. Etape 3 : modification du fichier dump global

   Cette étape nous permet d'examiner et d'ajuster le vidage selon les besoins, ce qui contribue à assurer la compatibilité avec la version cible de PostgreSQL et un processus de restauration plus fluide.

4. Etape 4 : Restauration d'objets globaux

   La restauration des rôles permet de s'assurer que les utilisateurs et les droits d'accès appropriés sont en place avant la réintroduction des données, ce qui prend en charge un environnement cohérent et sécurisé.

5. Etape 5 : restauration de la base de données

   Cette étape amène les données dans le système mis à niveau, en terminant la transition et en rendant la base de données prête à être utilisée sur la nouvelle version de PostgreSQL.

• Utiliser des valeurs -j supérieures en fonction de l'UC disponible
• Utilisez -Z0 pendant le vidage pour des performances plus rapides
• Garantir une capacité d'E/S disque suffisante
• Surveiller la progression des restaurations à l'aide de journaux détaillés

Après avoir effectué la restauration, effectuez les tâches suivantes.

• Vérifier le nombre de lignes

  Cette tâche permet de vérifier que toutes les données ont été migrées et qu'il n'y a pas d'écart entre les bases de données source et cible.

• Vérifier la connectivité de l'application

  Cette tâche permet de s'assurer que les applications peuvent se connecter à la base de données mise à niveau et interagir avec elle comme prévu.

• Valider les rôles et les autorisations

  Cette tâche permet de vérifier que les utilisateurs et les rôles disposent des droits d'accès et privilèges appropriés dans le nouvel environnement.

• Exécutez la commande suivante pour chaque base de données.

  VACUUM ANALYZE <database_name>;

  Cette commande permet de mettre à jour les statistiques internes utilisées par le planificateur de requêtes, ce qui permet à OCI PostgreSQL de générer des plans d'exécution plus efficaces en fonction des données actuelles. Il peut également aider à optimiser les performances globales après la restauration, en particulier pour les bases de données ou les charges de travail plus volumineuses avec des requêtes complexes.

• Si les deux systèmes de base de données se trouvent dans le même VCN, la connectivité est automatiquement disponible.
• Si les bases de données se trouvent dans différents réseaux cloud virtuels de la même région, configurez la passerelle d'appairage local pour établir la communication.
• Si les bases de données se trouvent dans des différents réseaux cloud virtuels de la région, configurez DRG (Dynamic Route Gateway) pour établir la communication.

Effectuez les étapes suivantes sur les bases de données source (version antérieure) et cible (version ultérieure) :

1. Connectez-vous à la console Oracle Cloud et accédez à votre système de base de données OCI PostgreSQL.
2. Modifiez la configuration en accédant au fichier de configuration.
3. Sélectionnez Copier la configuration et mettez à jour les paramètres requis. Sous Variables utilisateur (lecture/écriture), :
   • wal_level = logical
   • track_commit_timestamp = 1
4. Activer l'extension : sous Configurer les extensions, sélectionnez pglogical et créez la configuration.
5. Accédez à votre système de base de données, sélectionnez Modifier sous Configuration, puis appliquez la configuration précédemment créée au système de base de données.

   L'état du système de base de données est initialement Mise à jour. Attendez qu'il devienne actif avant de continuer.

   Cette configuration prépare les deux environnements pour la réplication logique en activant les paramètres et extensions requis, ce qui permet à pglogical de capturer et de synchroniser les modifications de manière fiable entre les bases de données source et cible au cours du processus de mise à niveau.

6. Une fois le système de base de données actif, connectez-vous à la base de données et vérifiez les extensions activées à l'aide de la requête suivante.

   SHOW oci.admin_enabled_extensions;

7. Créez l'extension pglogical à l'aide de la commande suivante :

   CREATE EXTENSION pglogical;

Connectez-vous en tant qu'administrateur (utilisateur indiqué lors de la création de la base de données OCI PostgreSQL) et accordez les privilèges nécessaires pour activer la réplication logique.

alter role xxx with replication; 
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_reset() to xxx ; 
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx ; 
grant all on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx;

xxx est l'exemple d'utilisateur créé lors du provisionnement du système de base de données.

Connectez-vous en tant qu'administrateur (utilisateur indiqué lors de la création de la base de données OCI PostgreSQL) et accordez les privilèges nécessaires pour activer la réplication logique.

alter role xxx with replication;
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_reset() to xxx ;
grant EXECUTE on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx ;
grant all on FUNCTION pg_catalog.pg_replication_origin_session_setup to xxx;

xxx est l'exemple d'utilisateur créé lors de la configuration de la base de données.

Avant de poursuivre, assurez-vous que :

• Tous les schémas et objets requis existent sur la cible

  Les éléments incluent les schémas, les tables, les index, les extensions et tous les objets de base de données requis. La mise en place de ces éléments permet de garantir que les opérations de réplication ou de restauration peuvent se poursuivre sans erreurs de dépendances manquantes. L'existence peut être confirmée en comparant les listes de schémas (par exemple, en utilisant \dn et \dt dans psql) et en validant que les extensions requises sont installées sur la source et la cible.

• La structure de la base de données correspond à la source

  La base de données cible doit être étroitement alignée sur la source en termes de définitions de schéma, de noms d'objet et de structure globale. Cette cohérence facilite la migration des données et réduit les risques de conflits ou d'incohérences lors de la synchronisation. Vérifiez les définitions de schéma (par exemple, en utilisant pg_dump --schema-only) ou en comparant les structures de table et le nombre d'objets entre les systèmes source et cible.

1. Créez le noeud abonné sur la base de données cible :

   SELECT pglogical.create_node(node_name := 'subscriber1', dsn := 'host=<target_database_fqdn> port=5432 user=xxx password=xxxxx dbname=pglogical_target');

   • node_name : définissez le nom de l'abonné sur la base de données cible.
   • host : entrez le nom de domaine qualifié complet de la base de données cible.
   • port_number : entrez le port sur lequel la base de données cible est exécutée.
   • database_name : indiquez le nom de la base de données dans laquelle l'abonnement sera créé.
2. Créez l'abonnement pour démarrer les processus de synchronisation et de réplication en arrière-plan :

   SELECT pglogical.create_subscription(subscription_name := 'subscription1', provider_dsn := 'host=<source_database_fqdn> port=5432 user=xxx password=xxxxxx dbname=pglogical_source sslmode=require');

   • subscription_name : indiquez le nom de l'abonnement.
   • host : indiquez le nom de domaine qualifié complet de la base de données source.
   • port_number : indiquez le port sur lequel la base de données cible est exécutée.
   • database_name : indiquez le nom des bases de données source.

1. Vérifier le statut de l'abonnement (cible) : exécutez l'instruction suivante pour vérifier le statut de l'abonnement sur la base de données cible.

   SELECT * FROM pglogical.show_subscription_status();

2. Vérifier le statut de la réplication (source) : exécutez l'instruction suivante pour vérifier le statut de la réplication sur la base de données source.

   SELECT * FROM pg_stat_replication;

Si les deux vérifications indiquent un statut actif sans décalage ou modifications en attente, ce résultat suggère que la réplication est terminée et que la base de données cible est entièrement synchronisée avec la source.

Pour plus d'informations sur pglogical, y compris des étapes détaillées et des explications, reportez-vous à Synchronisation inter-région d'OCI Database with PostgreSQL à l'aide de l'extension pglogical