Guida all'upgrade delle versioni principali per il database OCI con PostgreSQL

• pg_dump e pg_restore sono strumenti di backup logici.
• Adatto per gli upgrade della versione principale.
• Richiede tempo di inattività durante lo switchover finale.
• I ruoli devono essere sempre gestiti separatamente.

Il processo di aggiornamento che utilizza pg_dump e pg_restore consiste nei passi riportati di seguito.

1. Passo 1: eseguire il dump degli oggetti globali (ruoli)

   Questo passo consente di garantire la conservazione di tutti i ruoli, le autorizzazioni e i controlli dell'accesso, consentendo agli utenti e alle applicazioni di mantenere l'accesso coerente dopo l'aggiornamento.

2. Passo 2: eseguire il dump del database

   Questo passo crea un backup logico completo del database, fornendo un modo affidabile per trasferire i dati nell'ambiente aggiornato.

3. Passo 3: Modificare il file di dump globale

   Questo passaggio ci consente di rivedere e modificare il dump in base alle esigenze, contribuendo a garantire la compatibilità con la versione PostgreSQL di destinazione e un processo di ripristino più fluido.

4. Passo 4: Ripristino degli oggetti globali

   Prima di reintrodurre i dati, il ripristino dei ruoli garantisce la disponibilità degli utenti e delle autorizzazioni appropriati in modo da supportare un ambiente coerente e sicuro.

5. Passo 5: ripristinare il database

   Questo passo porta i dati nel sistema aggiornato, completando la transizione e rendendo il database pronto per l'uso sulla nuova versione di PostgreSQL.

• Utilizzare valori -j superiori in base alla CPU disponibile
• Usare -Z0 durante il dump per ottenere prestazioni più rapide
• Garantisci una capacità di I/O su disco sufficiente
• Monitorare l'avanzamento del ripristino utilizzando log descrittivi

Dopo aver completato il ripristino, eseguire i task riportati di seguito.

• Verifica conteggi righe

  Questo task consente di verificare che la migrazione di tutti i dati sia riuscita e che non vi siano discrepanze tra i database di origine e di destinazione.

• Controllare la connettività dell'applicazione

  Questa attività garantisce che le applicazioni possano connettersi e interagire con il database aggiornato come previsto.

• Convalida ruoli e autorizzazioni

  Questo task consente di confermare che gli utenti e i ruoli dispongono dell'accesso e dei privilegi appropriati nel nuovo ambiente.

• Eseguire il comando seguente per ogni database

  VACUUM ANALYZE <database_name>;

  Questo comando consente di aggiornare le statistiche interne utilizzate dal pianificatore query, consentendo a OCI PostgreSQL di generare piani di esecuzione più efficienti in base ai dati correnti. Può anche aiutare a ottimizzare le prestazioni complessive dopo il ripristino, in particolare per database o carichi di lavoro più grandi con query complesse.

• Se entrambi i sistemi di database si trovano all'interno della stessa VCN, la connettività è disponibile automaticamente.
• Se i database si trovano in VCN diverse all'interno della stessa area, configurare il Local Peering Gateway (LPG) per stabilire la comunicazione.
• Se i database si trovano in vCN diverse all'interno di un'area diversa, configurare Dynamic Route Gateway (DRG) per stabilire la comunicazione.

Eseguire i passi riportati di seguito su entrambi i database origine (versione precedente) e destinazione (versione successiva).

1. Connettersi alla console di Oracle Cloud e andare al sistema di database PostgreSQL OCI.
2. Modificare la configurazione accedendo al file di configurazione.
3. Selezionare Copia configurazione e aggiornare i parametri richiesti. In Variabili utente (lettura/scrittura), eseguire le operazioni riportate di seguito.
   • wal_level = logical
   • track_commit_timestamp = 1
4. Abilita estensione: in Configura estensioni selezionare pglogical e creare la configurazione.
5. Passare al sistema di database, selezionare Modifica in Configurazione e applicare la configurazione creata in precedenza al sistema di database.

   Lo stato del sistema di database è inizialmente Aggiornamento. Attendere che diventi Attivo prima di continuare.

   Questa configurazione prepara entrambi gli ambienti per la replica logica abilitando le impostazioni e le estensioni necessarie, consentendo a pglogical di acquisire e sincronizzare le modifiche in modo affidabile tra i database di origine e di destinazione durante il processo di aggiornamento.

6. Dopo che il sistema di database è attivo, connettersi al database e verificare le estensioni abilitate utilizzando la query seguente.

   SHOW oci.admin_enabled_extensions;

7. Creare l'estensione pglogical utilizzando il comando seguente:

   CREATE EXTENSION pglogical;

Eseguire il login come utente amministratore (l'utente specificato durante la creazione del database PostgreSQL OCI) e concedere i privilegi necessari per abilitare la replica logica.

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 è l'utente di esempio creato durante il provisioning del sistema di database.

Eseguire il login come utente amministratore (l'utente specificato durante la creazione del database PostgreSQL OCI) e concedere i privilegi necessari per abilitare la replica logica.

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 è l'utente di esempio creato durante l'impostazione del database.

Prima di procedere, assicurarsi che:

• Tutti gli schemi e gli oggetti necessari esistono nella destinazione

  Gli elementi includono schemi, tabelle, indici, estensioni e qualsiasi oggetto di database richiesto. Avere queste operazioni in atto aiuta a garantire che le operazioni di replica o ripristino possano continuare senza errori da dipendenze mancanti. L'esistenza può essere confermata confrontando le liste di schemi (ad esempio, utilizzando \dn e \dt in psql) e convalidando che le estensioni necessarie siano installate sia nell'origine che nella destinazione.

• La struttura del database corrisponde all'origine

  Il database di destinazione dovrebbe allinearsi strettamente con l'origine in termini di definizioni di schema, nomi di oggetti e struttura generale. Questa coerenza aiuta a supportare una migrazione dei dati fluida e riduce la probabilità di conflitti o incongruenze durante la sincronizzazione. Verificare esaminando le definizioni di schema (ad esempio utilizzando pg_dump --schema-only) o confrontando le strutture di tabella e i conteggi degli oggetti tra i sistemi di origine e di destinazione.

1. Creare il nodo sottoscrittore nel database di destinazione:

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

   • node_name: definire il nome del sottoscrittore nel database di destinazione.
   • host: immettere il nome dominio completamente qualificato (FQDN) del database di destinazione.
   • port_number: immettere la porta su cui è in esecuzione il database di destinazione.
   • database_name: fornire il nome del database in cui verrà creata la sottoscrizione
2. Creare la sottoscrizione per avviare i processi di sincronizzazione e replica in background:

   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: fornire il nome della sottoscrizione.
   • host: fornire il nome FQDN del database di origine.
   • port_number: fornire la porta su cui è in esecuzione il database di destinazione.
   • database_name: fornire il nome del database d'origine.

1. Controllare lo stato della sottoscrizione (destinazione): eseguire l'istruzione seguente per controllare lo stato della sottoscrizione nel database di destinazione.

   SELECT * FROM pglogical.show_subscription_status();

2. Controllare lo stato della replica (origine): eseguire l'istruzione seguente per controllare lo stato della replica nel database di origine.

   SELECT * FROM pg_stat_replication;

Se entrambi i controlli indicano uno stato attivo senza ritardi o modifiche in sospeso, questo risultato suggerisce che la replica è completa e che il database di destinazione è completamente sincronizzato con l'origine.

Per ulteriori informazioni su pglogical, inclusi passi e spiegazioni dettagliate, vedere Sincronizzazione tra più aree del database OCI con PostgreSQL mediante l'estensione pglogical