Estensioni e oggetti di replica logica da esaminare

Prima di procedere all'aggiornamento, verificare i seguenti punti:

Estensioni

• pg_repack
• old_snapshot
• wal2json
• anon
• PostGIS

Slot di replica

• Logical replication slots

Dipendenze delle applicazioni Se si rimuovono estensioni o oggetti di replica da cui dipendono le applicazioni, verificare i flussi di dati e il comportamento delle applicazioni prima di procedere con l'aggiornamento. Considera inoltre le possibili interruzioni nella logica della tua applicazione che dipende da specifiche funzionalità di PostgreSQL.

pg_repack

Eliminare la directory pg_repack prima dell'aggiornamento e ricrearla dopo l'aggiornamento. pg_repack utilizza un'estensione specifica per la versione e componenti client/server che devono corrispondere alla versione principale di PostgreSQL.

DROP EXTENSION pg_repack;

Ricrea l'estensione dopo l'aggiornamento solo se il tuo carico di lavoro la richiede ancora.

CREATE EXTENSION pg_repack;

old_snapshot

Prima dell'aggiornamento, eliminare il file " old_snapshot ". Non ricrearlo dopo l'aggiornamento a PostgreSQL 18, poiché non è più supportato.

DROP EXTENSION old_snapshot;

wal2json slot di replica

Se si utilizza " wal2json " per la decodifica logica, è necessario eliminare tutti gli slot di replica associati prima dell'aggiornamento. L'utilità pg_upgrade vieta categoricamente l'aggiornamento alla versione principale finché sono presenti slot di replica e, in tal caso, genererà un errore critico e interromperà l'aggiornamento.

Prima dell'aggiornamento:

1. Assicurarsi che tutti i dati WAL in sospeso siano stati elaborati.
2. Chiudi l'applicazione che utilizza lo slot di replica.
3. Eliminare gli slot di replica:

SELECT pg_drop_replication_slot('your_slot_name');

Dopo l'aggiornamento, è possibile ricreare gli slot di replica secondo necessità. Si noti che wal2json non viene installato tramite CREATE EXTENSION, ma viene configurato tramite i parametri del database (wal_level, max_replication_slots, max_wal_senders) e le autorizzazioni delle tabelle, che non impediscono gli aggiornamenti.

anon

Rimuovi l'estensione " anon " prima dell'aggiornamento e riattivala dopo l'aggiornamento, se ne hai ancora bisogno. Prima di disattivare anon sono necessari ulteriori passaggi.

Se è installata l'estensione " anon ", seguire i passaggi riportati di seguito ed eseguire i comandi come utente amministratore prima di procedere all'aggiornamento.

1. Rimuovi tutte le regole di mascheramento (se attive).

   SELECT anon.remove_masks_for_all_columns();
   

2. Disattivare i ruoli mascherati (l'aggiornamento potrebbe non andare a buon fine se alcuni ruoli sono contrassegnati come mascherati).

   SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
   

3. Rimuovi l'estensione anon con l'opzione cascade.

   DROP EXTENSION anon CASCADE;
   

4. Se l'estensione " anon " è installata in più database all'interno di un'istanza, seguire i passaggi indicati per ciascun database.

5. Una volta completato l'aggiornamento, riattivare l'estensione " anon " e riapplicare le regole di mascheramento secondo necessità.

Si raccomanda vivamente di verificare i dati sia prima che dopo l'eliminazione dell'estensione, al fine di garantire la coerenza del mascheramento prima di eseguire l'aggiornamento.

PostGIS

Se utilizzi PostGIS,, esegui prima l'aggiornamento di PostGIS prima di aggiornare PostgreSQL.

SELECT postgis_extensions_upgrade();

Utilizza la seguente query per verificare la correttezza dell'aggiornamento dell'estensione PostGIS.

SELECT postgis_full_version();

Logical replication slots

Prima dell'aggiornamento, eliminare tutti gli slot di replica logica e ricrearli dopo l'aggiornamento. Gli slot logici sono legati allo stato del server di origine e devono essere ricreati da zero sull'istanza aggiornata.

SELECT pg_drop_replication_slot('<slot_name>');

Slot di replica logica

Prima dell'aggiornamento, eliminare tutti gli slot di replica logica e ricrearli al termine dell'aggiornamento. Gli slot di replica logica sono legati allo stato del server di origine e devono essere ricreati sull'istanza aggiornata.

SELECT pg_drop_replication_slot('<slot_name>');

Prima di iniziare

Prima di avviare l'aggiornamento, verificare quanto segue:

• Verifica che gli aggiornamenti di versione siano supportati per la tua distribuzione utilizzando l'interfaccia utente, l'API, la CLI o Terraform.

  Esempio (CLI):

  ibmcloud cdb capability-show versions postgresql
  

• Verificare i requisiti di pre-controllo. L'aggiornamento viene eseguito sulla distribuzione di origine e viene bloccato se vengono rilevati dei rischi. Assicurarsi che:

  • L'implementazione è corretta
  • È disponibile almeno il 10% di spazio libero su disco
  • L'utilizzo dell'I/O è inferiore al 90%
  • Le dimensioni dello schema e il numero di oggetti rientrano nei limiti consentiti
  • La pulizia delle estensioni e degli slot di replica logica richiesta è stata completata

• Consulta il documento " https://www.postgresql.org/docs/release/ " per verificare eventuali modifiche alla compatibilità che potrebbero influire sulle tue applicazioni.

• Il ripristino a una versione precedente non è supportato.

• Un aggiornamento in loco non può essere annullato una volta avviato.

• Assicurati che sia disponibile un backup recente prima di procedere all'aggiornamento.

Gen2 inizia con “ PostgreSQL ” 18. I percorsi di aggiornamento alle versioni più recenti vengono aggiunti man mano che vengono supportati. Per le versioni precedenti (14–17), consultare la pagina /docs/databases-for-postgresql?topic=databases-for-postgresql-upgrading.

Una volta completato l'aggiornamento, la tua distribuzione utilizzerà una nuova versione principale di PostgreSQL. I backup e i punti PITR precedenti all'aggiornamento appartengono alla cronologia della versione precedente e non possono essere ripristinati nella versione aggiornata.

Per mantenere le funzionalità di ripristino e PITR nella nuova versione, eseguire un backup subito dopo l'aggiornamento. Questo backup costituisce il punto di riferimento per le future operazioni di ripristino.

Se l'aggiornamento non va a buon fine, è comunque possibile utilizzare i backup effettuati prima dell'aggiornamento con la funzione PITR per ripristinare la versione precedente in una nuova distribuzione.

Risoluzione dei problemi

Se dovessero verificarsi problemi dopo un aggiornamento andato a buon fine e fosse necessario tornare alla versione precedente, contattare l'assistenza di IBM Cloud® per ricevere assistenza. Si raccomanda di evitare di eseguire operazioni PITR o ripristini senza una guida adeguata, poiché ciò potrebbe complicare il processo di ripristino.

Gli aggiornamenti vengono eseguiti solo dopo che tutti i controlli preliminari sono stati superati. Se l'aggiornamento risulta bloccato, verificare quanto segue:

• Stato di integrità del cluster (lo stato di Patroni è stabile)
• Spazio libero su disco sufficiente
• Utilizzo accettabile delle operazioni di I/O su disco
• Limiti relativi alle dimensioni dello schema e al numero di oggetti

Schemi di grandi dimensioni e un numero elevato di oggetti possono allungare la durata dell'aggiornamento.

Se i tentativi di aggiornamento continuano a fallire, apri un ticket di assistenza tramite https://cloud.ibm.com/login?redirect=%2Funifiedsupport%2Fsupportcenter.

Esecuzione a secco della promozione e dell'aggiornamento

Per valutare gli effetti degli aggiornamenti di versione principali, eseguire una simulazione. Una simulazione riproduce la promozione e l'aggiornamento, con i risultati registrati nei log del database. Accedi ai log del tuo database e visualizzali tramite l'integrazione "Analisi dei log ". Ciò garantisce che la versione attualmente in uso, con le relative estensioni, possa essere aggiornata correttamente alla versione desiderata.

La simulazione deve essere eseguita con skip_initial_backup impostato su false`` e con version definito.

Il comando è il seguente:

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