Aggiornamento a una nuova versione principale
Scegli un percorso di aggiornamento:
- Aggiornamento della versione principale in loco(IPMVU): aggiorna l'installazione esistente mantenendo le stringhe di connessione.
- Aggiornamento di una replica in sola lettura: replicare i dati in un'istanza separata, quindi promuoverla e aggiornarla.
- Ripristino da backup: creare una distribuzione su una versione di destinazione supportata a partire da un backup esistente.
Per gli ultimi due percorsi, la nuova distribuzione non riceve le modifiche che giungono alla fonte dopo la promozione o dopo il backup. Prova e verifica prima la nuova versione. Prima di effettuare il passaggio definitivo, interrompere le operazioni di scrittura sulla fonte. A questo punto, promuovi la replica o esegui il backup, quindi modifica le impostazioni di connessione dell'applicazione in modo che puntino alla nuova distribuzione.
Trova nel catalogo le versioni disponibili per le nuove implementazioni, tramite ibmcloud cdb deployables-show,
oppure tramite l'API /deployables.
Negli esempi relativi alle API, sostituire {region} con la regione della distribuzione, {id} con il nome della risorsa cloud (CRN) della distribuzione codificato in formato URL e <IAM_TOKEN> con il
proprio token di accesso IAM ( Identity and Access Management ).
Requisiti per l'aggiornamento
Compatibilità delle applicazioni
Verificate il percorso di aggiornamento scelto su un ambiente di staging rappresentativo prima di passare alla produzione. Per una prova dell'IPMVU, ripristinare un backup recente alla versione di origine dell' PostgreSQL. Un cluster è composto da due o tre nodi: il nodo primario e uno o due nodi ad alta disponibilità (HA). Adatta la distribuzione ripristinata allo stesso numero di membri dell'ambiente di produzione, poiché la fase di conversione richiede più tempo se il numero di membri HA è maggiore. Assicurati che la distribuzione ripristinata disponga di un backup completo, quindi esegui l'aggiornamento alla versione desiderata. Verificare le richieste delle applicazioni, i processi in background, i driver, le estensioni e i pool di connessioni. Registra le prestazioni e la durata degli errori di sola lettura e degli errori di connessione riscontrati dalle tue applicazioni, per poterli confrontare in seguito.
Esamina le note di rilascio di ogni versione principale successiva alla tua versione di partenza, fino alla versione di destinazione inclusa. Esamina anche le modifiche ai privilegi dei ruoli.
L'aggiornamento non conserva i timestamp dei commit. Dopo l'aggiornamento, il comando pg_xact_commit_timestamp() restituisce NULL per ogni transazione che è stata confermata prima dell'aggiornamento.
Se le vostre applicazioni leggono i timestamp di commit, copiate i valori necessari in una colonna della tabella prima di eseguire l'aggiornamento.
Estensioni e altri oggetti
Prima di procedere all'aggiornamento, completare le operazioni preliminari indicate nelle sezioni seguenti. Per un IPMVU, preparare l'implementazione da aggiornare. Per la replica in sola lettura e i percorsi di ripristino, preparare la distribuzione di origine prima di creare la replica o eseguire il backup. Non è possibile modificare una replica in sola lettura e il ripristino aggiorna i dati nell'ambito della stessa operazione. Prevedere eventuali dipendenze delle applicazioni dagli oggetti che si intendono rimuovere.
Estensioni
pg_repack
pg_repack non impedisce l'aggiornamento. Non è necessario eliminarlo o ricrearlo né prima né dopo l'aggiornamento.
old_snapshot
Il old_snapshot modulo non è disponibile in PostgreSQL e 17 e successive. Quando si esegue l'aggiornamento da PostgreSQL 16
o versioni precedenti a PostgreSQL 17 o versioni successive, IPMVU rimuove old_snapshot da ciascun database prima che abbia inizio la modalità di sola lettura. Se un oggetto dipende da old_snapshot, l'aggiornamento
non va a buon fine. La rimozione non viene annullata se l'aggiornamento fallisce in seguito.
Se in un database è installato " old_snapshot ", contattare l'assistenza per identificare gli oggetti dipendenti prima di eseguire l'aggiornamento. Per gli altri percorsi di aggiornamento, contattare l'assistenza
per concordarne la rimozione.
anon
Se è installata la versione 2 di " anon ", eseguire questi passaggi in ogni database in cui è installata. Eseguili come proprietario delle tabelle con nome mascherato, ad esempio admin. Per un IPMVU,
la versione 2 di “ anon ” fa sì che l’aggiornamento fallisca durante la fase di conversione, mentre il database non è disponibile, e ogni nuovo tentativo fallisce allo stesso modo. La versione 3 di “ anon ”
non richiede questi passaggi. La query di autoverifica n. 10 mostra la versione installata all'indirizzo extversion.
Prima di rimuovere le regole di mascheramento, bloccare l'accesso al database per i ruoli mascherati, che devono poter visualizzare solo i dati mascherati. Mantieni bloccato il loro accesso fino a quando non avrai ripristinato e verificato le regole di mascheramento e le etichette dei ruoli dopo l'aggiornamento.
-
Prendi nota delle regole di mascheramento e dei ruoli mascherati in modo da poterli ripristinare dopo l'aggiornamento.
SELECT objtype, objname, label FROM pg_catalog.pg_seclabels WHERE provider = 'anon'; -
Rimuovi tutte le regole di mascheramento.
SELECT anon.remove_masks_for_all_columns(); -
Rimuovere l'etichetta mascherata da ciascun ruolo elencato al punto 1. PostgreSQL e 16 e versioni successive, questa operazione richiede l'opzione "
ADMIN" (Consenti a tutti gli utenti di eseguire operazioni di modifica) associata al ruolo. Per ulteriori informazioni, consultare la sezione " Problemi relativi ai privilegi dei ruoli durante gli aggiornamenti di versione ".SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL; -
Eliminare l'estensione
anoncon l'opzione cascata. L'opzione "cascata" elimina anche gli oggetti che dipendono daanon, come le viste di mascheramento e le funzioni. Prendi nota delle loro definizioni in modo da poterle ricreare dopo l'aggiornamento.DROP EXTENSION anon CASCADE; -
Dopo l'aggiornamento, riattivare l'opzione "
anon", riapplicare le regole di mascheramento e le etichette dei ruoli registrate e verificare il mascheramento prima di ripristinare l'accesso per i ruoli mascherati.
PostGIS
Se utilizzi PostGIS,, esegui l'aggiornamento in ogni database che lo utilizza prima di procedere all'aggiornamento PostgreSQL:
SELECT postgis_extensions_upgrade();
Verifica la versione dell'estensione:
SELECT postgis_full_version();
earthdistance
Un IPMVU genera un errore durante la fase di conversione se un indice o una colonna generata memorizzata utilizza una funzione della versione earthdistance 1.1, come ad esempio ll_to_earth(). Ciò vale anche quando
l'oggetto lo utilizza tramite una funzione SQL definita dall'utente. PostgreSQL I punti 14 e 15 riportano solo la versione 1.1. Verificare tramite la query di autocontrollo n. 13 in ciascun
database, quindi gestire ogni oggetto elencato:
-
Il 16 o il 17 di " PostgreSQL ", aggiorna l'estensione prima di eseguire l'aggiornamento:
ALTER EXTENSION earthdistance UPDATE; -
In PostgreSQL 14 o 15, se
used_functionè una delle tue funzioni, aggiungi l'impostazionesearch_path:ALTER FUNCTION <used_function> SET search_path = ibm_extension, pg_catalog; -
In PostgreSQL 14 o 15, se
used_functionè una funzione diearthdistance, eliminare l'indice indicato prima di eseguire l'aggiornamento. Per mantenere i valori di una colonna generata elencata, convertirla in una colonna normale utilizzandoALTER TABLE <table_name> ALTER COLUMN <column_name> DROP EXPRESSION;. Dopo l'aggiornamento, esegui il comando ` `ALTER EXTENSION earthdistance UPDATE;, quindi ricrea ciò che hai rimosso. Se la versione di destinazione è l' PostgreSQL e 15, l'aggiornamento non ha alcun effetto e gli oggetti ricreati bloccheranno il prossimo aggiornamento allo stesso modo. Per evitare che ciò accada, esegui l'aggiornamento a PostgreSQL 16 o una versione successiva.
pgRouting
Se la propria distribuzione utilizza “ PostgreSQL ” 16 o 17 e si esegue l’aggiornamento a “ PostgreSQL ” 18, controllare ogni database in cui è installato “ pgRouting ”. PostgreSQL Le 18 distribuzioni non includono la libreria
pgRouting 3.5. Un IPMVU per PostgreSQL 18 non supera i controlli di compatibilità, prima che abbia inizio la modalità di sola lettura, quando una qualsiasi funzione utilizza quella libreria. Non aspettatevi discussioni:
SELECT DISTINCT p.probin
FROM pg_catalog.pg_proc AS p
WHERE p.probin = '$libdir/libpgrouting-3.5';
Se la query restituisce una riga, aggiorna pgRouting all'ultima versione fornita dalla tua distribuzione prima di eseguire l'aggiornamento, quindi esegui nuovamente la query:
ALTER EXTENSION pgrouting UPDATE;
pgRouting La versione 4.0 elimina diverse funzioni, quali pgr_createTopology, pgr_analyzeGraph, e pgr_nodeNetwork, e ne modifica altre. Testate le vostre applicazioni con la versione
4.0, iniziando da pgRouting un ambiente di staging. Se sono necessarie le funzioni rimosse, contattare l'assistenza prima di eseguire l'aggiornamento a PostgreSQL 18. A partire da PostgreSQL 16, è possibile eseguire l'aggiornamento
anche a PostgreSQL 17, che include la libreria 3.5.
Funzioni SQL negli indici, nelle chiavi di partizione e nelle colonne generate
Durante la fase di conversione, un IPMVU ricrea la definizione di ogni indice, chiave di partizione e colonna generata in modo memorizzato con un percorso di ricerca vuoto. Questo passaggio fallisce se uno di questi oggetti utilizza una
funzione di tipo “ LANGUAGE sql ” con un corpo di tipo stringa che identifica un oggetto esterno a pg_catalog senza il relativo schema, direttamente o tramite un vincolo di verifica del dominio. Le statistiche
estese hanno lo stesso effetto su una tabella che contiene una chiave esterna. In un indice, fallisce anche una chiamata che fa riferimento allo schema “ ibm_extension ”, dove sono installate le estensioni. L'errore si verifica
mentre il database non è disponibile e ogni nuovo tentativo fallisce allo stesso modo.
Eseguire la query di autocontrollo n. 12 in ciascun database. Per ciascuna funzione elencata, aggiungere un’impostazione “ search_path ” che indichi tutti gli schemi utilizzati nel
corpo della funzione stessa. In alternativa, sostituire il corpo della stringa con un corpo conforme allo standard SQL. Esegui queste istruzioni come proprietario della funzione. Ad esempio:
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);
Non modificare i risultati e gli altri attributi di ciascuna funzione, poiché gli indici e le colonne generate memorizzano tali risultati e le tabelle partizionate indirizzano le righe in base a essi. Con l'impostazione " search_path ", PostgreSQL non espande più la funzione nelle query che la chiamano, pertanto tali query potrebbero risultare più lente. Un'entità dello standard SQL non protegge le funzioni che richiamano il corpo della stringa, quindi correggi
anche quelle funzioni. Esegui nuovamente la query finché non restituisce più righe. Se nell'elenco è presente una funzione di cui non disponi, contatta l'assistenza prima di eseguire l'aggiornamento.
Se si esegue l'aggiornamento da PostgreSQL 16 o versioni precedenti a PostgreSQL 17 o versioni successive, eseguire anche la query di autocontrollo 17. PostgreSQL 17 e successivamente eseguire
i comandi di manutenzione con un percorso di ricerca limitato. Una funzione in qualsiasi linguaggio utilizzata da un indice, da una vista materializzata o da statistiche estese richiede quindi una propria impostazione “ search_path ”. In caso contrario, dopo l'aggiornamento, le operazioni ANALYZE, REINDEX, CLUSTER, VACUUM FULL e REFRESH MATERIALIZED VIEW non andranno a buon fine per gli oggetti interessati.
Imposta il percorso di ricerca di ciascuna funzione elencata che identifica gli oggetti senza indicarne lo schema, come nell'esempio precedente. Per ulteriori informazioni, consultare le note sulla migrazione di PostgreSQL 17.
Oggetti che utilizzano nomi di sistema rimossi
Ogni versione principale elimina o rinomina alcune colonne dei cataloghi di sistema, alcune funzioni e alcuni parametri di configurazione. Ad esempio, l' PostgreSQL e 17 ha rimosso le colonne dei checkpoint da pg_stat_bgwriter,
mentre l' PostgreSQL e 16 ha rinominato il parametro force_parallel_mode in debug_parallel_query. I controlli preliminari non individuano gli oggetti che utilizzano questi nomi:
- Se una vista, una vista materializzata o un aggregato utilizza un nome rimosso, l'IPMVU genera un errore durante la fase di conversione. Una funzione con un corpo conforme allo standard SQL e una funzione, un ruolo o un'impostazione del database relativa a un parametro rimosso producono lo stesso effetto.
- Altre funzioni e procedure, operazioni di “
pg_cron” e query di applicazione che utilizzano un nome rimosso generano un errore al primo esecuzione sulla nuova versione. Ciò può verificarsi prima che riprendano le operazioni di scrittura.
Eseguire la query di autocontrollo n. 14 in ciascun database. Modifica o elimina ogni oggetto elencato la cui versione removed_in sia pari o inferiore alla versione di destinazione.
Verificare le impostazioni relative ai ruoli e al database utilizzando la query di autoverifica n. 7. Testa la tua applicazione e le query di monitoraggio su un'implementazione di staging della versione di destinazione.
Slot di replica logica
IPMVU non supera i controlli preliminari finché esiste uno slot di replica logico, compresi gli slot inattivi e quelli utilizzati da wal2json. Non è possibile recuperare uno slot eliminato e un nuovo slot non include le modifiche
conservate dallo slot precedente. Prima di eseguire l'aggiornamento:
-
Registra il nome di ogni slot, il plug-in e il database utilizzando la query di autocontrollo 2.
-
Sospendere la scrittura dei dati in origine fino a quando non si ripristinano i consumatori dopo l'aggiornamento, oppure pianificare la risincronizzazione dei dati a valle.
-
Consentire ai consumatori di elaborare le modifiche in sospeso, per poi bloccarle. Mantenerli in pausa, con la riconnessione automatica disattivata, finché l'attività non risulta come " Completata".
-
Elimina ogni slot utilizzando il
ibmcloud cdb postgresql replication-slot-deletecomando o l'API " Elimina uno slot di replica logica ". L'utente "admin" non può eliminare gli slot di replica tramite SQL.ibmcloud cdb postgresql replication-slot-delete <NAME|CRN> <SLOT_NAME> -
Dopo l'aggiornamento, ricreare gli slot come descritto nella sezione " Configurazione di
wal2json".
wal2json È un plug-in di decodifica logica, non un'estensione creata con CREATE EXTENSION.
Abbonamenti logici
Un abbonamento logico riceve le modifiche da un editore. Il suo slot di replica si trova sul publisher, quindi la query relativa agli slot non lo riporta.
Se la propria distribuzione utilizza una versione di PostgreSQL 16 o precedente, IPMVU non supera i controlli preliminari fintanto che esiste una sottoscrizione logica, comprese quelle disabilitate. Gli aggiornamenti da queste versioni non
mantengono lo stato di sincronizzazione dell'abbonamento. Prima di procedere all'aggiornamento, concorda con il titolare dell'editore le modalità di rimozione e ricreazione di ciascun abbonamento, nonché le modalità di risincronizzazione
dei dati. Quindi, elimina gli abbonamenti utilizzando le funzioni relative agli abbonati. La funzione delete_subscription elimina inoltre lo slot della sottoscrizione sul publisher e restituisce un errore se il publisher è irraggiungibile o se lo slot non esiste più. In tal caso, esegui disable_subscription e poi subscription_slot_none prima di delete_subscription. A questo punto, chiedi al proprietario del publisher di eliminare lo slot, poiché continua a conservare i log delle transazioni sul publisher.
Se la propria distribuzione utilizza la versione 17 o successive dell' PostgreSQL, gli abbonamenti possono essere mantenuti, ma devono soddisfare i requisiti di aggiornamento della replica logica previsti dalla versione di destinazione. L'aggiornamento supporta al massimo 10 abbonamenti. Se il numero è maggiore, fallisce i controlli di compatibilità prima che
abbia inizio la modalità di sola lettura. Disattiva gli abbonamenti tramite disable_subscription prima di eseguire l'aggiornamento e riattivali tramite enable_subscription una volta completato l'aggiornamento.
UNLOGGED tabelle e sequenze
PostgreSQL non registra nel log delle transazioni le modifiche apportate alle tabelle e alle sequenze dell' UNLOGGED. Non le replica agli altri membri e le ripristina dopo un failover o un ripristino. Nessuno dei percorsi di
aggiornamento mantiene i propri contenuti:
- Un IPMVU li reimposta quando riavvia PostgreSQL sulla nuova versione e nuovamente quando cambia il ruolo primario nella fase di completamento. Anche un aggiornamento non riuscito può azzerarli.
- Una replica in sola lettura promossa e un backup ripristinato partono con le tabelle
UNLOGGEDvuote e le sequenzeUNLOGGEDazzerate.
Dopo l'aggiornamento, le tabelle UNLOGGED risultano vuote e le sequenze UNLOGGED vengono azzerate. Finché l'attività non risulta come " Completata", anche eventuali modifiche apportate
a questi oggetti potrebbero andare perse. Prima di eseguire l'aggiornamento, utilizzare la query di autoverifica n. 11 per identificare questi oggetti in ciascun database e pianificare come
gestirli singolarmente.
- Per conservare il contenuto di una tabella, convertirla con
ALTER TABLE <table_name> SET LOGGED;. Il comandoSET LOGGEDconverte anche gli indici della tabella e le sequenze ad essa associate. Convertire una tabella di riferimento prima di convertire qualsiasi tabella che faccia riferimento ad essa tramite chiavi esterne. In alternativa, esporta i contenuti e ricaricali dopo che l'attività risulta come " Completata". - Se una sequenza genera valori per una tabella registrata, convertirla utilizzando
ALTER SEQUENCE <sequence_name> SET LOGGED;. In caso contrario, interrompi le applicazioni che lo utilizzano finché l'attività non risulta come " Completata". Quindi, impostalo su un valore superiore a quello massimo attualmente in uso con la funzionesetval.
SET LOGGED riscrive la tabella e blocca le operazioni di lettura e scrittura fino al completamento dell'operazione. Inoltre, genera una quantità di dati del log delle transazioni approssimativamente pari allo spazio occupato
dalla tabella e dai suoi indici. Convertire le tabelle di grandi dimensioni con largo anticipo rispetto all'invio dell'aggiornamento e utilizzare la query di autocontrollo n. 5 per verificare che i log delle transazioni siano stati archiviati.
Dopo l'aggiornamento, è possibile riconvertire una tabella utilizzando il comando ALTER TABLE <table_name> SET UNLOGGED;``.
Nel caso di un IPMVU, una tabella “ UNLOGGED ”, anche se vuota, fa sì che il servizio ricostruisca tutti i membri HA, prolungando così il tempo durante il quale le operazioni di scrittura rimangono bloccate. Per ulteriori informazioni,
consultare la sezione " Disponibilità durante un aggiornamento ". Per evitare questa ricostruzione, convertire tutte le tabelle di tipo “ UNLOGGED ” oppure eliminare
quelle che non servono più. Il comando “ TRUNCATE ” non evita la ricostruzione. Le sequenze di tipo “ UNLOGGED ” non causano una ricostruzione. Il 16 e il 17 di " PostgreSQL ", l'operazione " SET LOGGED " è di per sé un'operazione di massa che può comunque causare una ricostruzione, quindi è bene pianificarla di conseguenza.
Aggiornamento alla versione principale senza reinstallazione
Una volta completata la preparazione, utilizzare l'interfaccia utente, l'API, la CLI o la procedura Terraform descritta di seguito.
In un IPMVU, il servizio esegue l’aggiornamento del nodo primario in loco e aggiorna ciascun membro HA a partire dai propri file di dati esistenti. Quando tutti i membri dell'HA possono riutilizzare i propri file di dati, le operazioni di scrittura vengono bloccate solo per un breve periodo. La durata dipende principalmente dal numero di oggetti del database e dal livello di attività del database, piuttosto che dalla quantità di dati memorizzati.
In alcune circostanze, il servizio provvede invece a copiare l'intero database sui membri HA, il che comporta un blocco delle operazioni di scrittura molto più prolungato. Altre condizioni causano il fallimento dell'aggiornamento dopo il blocco delle operazioni di scrittura. I controlli preliminari non rilevano queste condizioni, quindi è necessario risolverle prima di inviare l'aggiornamento. Per l'elenco, consultare la sezione “Condizioni che i controlli preliminari non rilevano ”.
Non è possibile annullare un IPMVU dopo averlo inviato, né è possibile ridurre il livello di distribuzione già in atto. Il servizio non esegue un backup dei dati prima dell'aggiornamento, quindi è necessario creare e verificare prima un backup su richiesta.
Disponibilità durante un aggiornamento
Un IPMVU si svolge nelle seguenti fasi. Le operazioni di scrittura vengono interrotte all'inizio della fase di sola lettura e riprendono quando il servizio disattiva la modalità di sola lettura. Anche le operazioni di lettura non sono disponibili durante la fase di conversione.
| Fase | Cosa succede | Letture | Scritture |
|---|---|---|---|
| Controlli | Il servizio attende il completamento delle modifiche di distribuzione in sospeso ed esegue i controlli preliminari. Verifica la compatibilità dell'aggiornamento sul nodo primario e sui nodi HA e sospende il failover automatico. | Disponibile | Disponibile |
| Sola lettura | Il servizio imposta le nuove transazioni come di sola lettura in tutti i database e chiude tutte le sessioni dei client. Attende quindi che i membri HA e l'archiviazione del log delle transazioni si allineino. | Disponibile | Bloccato |
| Conversione | Il servizio interrompe l' PostgreSQL e su tutti i membri ed esegue l'aggiornamento del nodo primario. Ove possibile, esegue l'aggiornamento di ciascun membro HA a partire dai file di dati esistenti di quel membro. | Non disponibile | Non disponibile |
| Riavvia | Il primario aggiornato si avvia in modalità di sola lettura e i membri HA si avviano. Il servizio ricrea qualsiasi membro che non sia in grado di riutilizzare i propri file di dati dal primario aggiornato. | Disponibile | Bloccato |
| Redige curriculum | Il servizio disattiva la modalità di sola lettura e chiude nuovamente tutte le sessioni dei client. | Disponibile | Disponibile |
| Completamento | Il servizio attende che tutti i membri dell'HA si siano allineati. Successivamente, il servizio riavvia i membri uno alla volta per completare il passaggio alla nuova versione. Prima di riavviare il nodo primario, il servizio trasferisce il ruolo di nodo primario a un altro membro, il che comporta la chiusura delle sessioni dei client. Il servizio provvede quindi a rimuovere i file di aggiornamento, a mettere in coda il backup post-aggiornamento e a contrassegnare le attività come "Completate". | Disponibile, tranne durante il passaggio | Disponibile, tranne durante il passaggio |
Il processo riprende dopo che almeno un membro dell'HA ha recuperato il ritardo e tutti gli altri membri dell'HA hanno recuperato il ritardo o sono in fase di ricostruzione. Il servizio ripristina un nodo HA che non è in grado di riutilizzare i propri file di dati copiandovi l'intero database. Se è necessario ricostruire tutti i membri dell'HA, le operazioni di scrittura rimangono bloccate fino al completamento della prima ricostruzione. Nel caso di un database di grandi dimensioni, l'operazione può richiedere ore. Un'implementazione con due membri dati, che è la configurazione predefinita, ha un solo membro HA. Di conseguenza, qualsiasi operazione di ricostruzione blocca le operazioni di scrittura. I membri dell'HA non possono riutilizzare i propri file di dati nelle seguenti situazioni:
- Ogni database contiene una tabella "
UNLOGGED", anche se vuota. Il servizio provvede quindi a ricostruire tutti i membri HA. Verificare tramite la query di autocontrollo n. 11 e consultare le tabelle e le sequenzeUNLOGGED. - L'ambiente è basato su PostgreSQL e 16 o 17 e le tabelle si sono ingrossate a causa di operazioni in blocco o di numerosi inserimenti o aggiornamenti simultanei. Le operazioni in blocco includono i comandi
COPY,pg_restore,CREATE TABLE AS,CREATE MATERIALIZED VIEW,REFRESH MATERIALIZED VIEWeALTER TABLE, che riscrivono una tabella, come ad esempioSET LOGGED. Non è possibile verificarlo in anticipo, quindi è bene prevedere una ricostruzione.
Il servizio può inoltre ripristinare i membri HA per altri motivi che non è possibile verificare in anticipo. Una simulazione di un'implementazione di staging ripristinata da un backup potrebbe non mostrare tale ricostruzione.
Un membro HA in fase di ricostruzione conserva i propri file di dati precedenti fino al completamento dell'operazione. Di conseguenza, richiede uno spazio libero su disco almeno pari allo spazio occupato dai propri dati. Prima di inviare l'aggiornamento, assicurati che ogni elemento dei dati occupi una quantità di spazio su disco nettamente inferiore alla metà di quello disponibile. Verifica questo valore utilizzando la metrica relativa allo spazio su disco utilizzato. Sebbene il controllo preliminare dello spazio su disco consenta un utilizzo del disco fino al 90%, la ricostruzione di un nodo HA richiede una quantità di spazio libero notevolmente maggiore. In caso contrario, la ricostruzione potrebbe esaurire lo spazio su disco e fallire ripetutamente. Le operazioni di scrittura possono quindi rimanere bloccate per ore prima che l'attività fallisca. Il ridimensionamento automatico e manuale del disco viene sospeso fino al completamento dell'aggiornamento; pertanto, è necessario ridimensionare il disco prima di avviare l'aggiornamento. Una ricostruzione prolungata può anche causare il fallimento dell'operazione dopo la ripresa delle operazioni di scrittura. In entrambi i casi, l'implementazione utilizza la versione di destinazione fino a quando il supporto tecnico non completa l'aggiornamento. Prevedete una ricostruzione nella vostra finestra di manutenzione.
Scrive il resume prima che l'operazione sia completata. Per verificare se le operazioni di scrittura sono riprese, eseguire il comando SHOW default_transaction_read_only; in una nuova sessione. Restituisce "
off " una volta riprese le operazioni di scrittura. Le sessioni client terminano all'inizio della modalità di sola lettura, quando l' PostgreSQL e si interrompe per la conversione, quando riprendono le operazioni di scrittura,
durante il passaggio alla fase di completamento e quando il servizio ripristina l'accesso in scrittura dopo un errore.
Fino a quando l'attività non risulta come " Completata", evitare operazioni di scrittura in blocco prolungate, come caricamenti di grandi quantità di dati o processi batch. La fase di completamento attende che ogni membro dell'HA abbia riprocessato tutte le modifiche. In presenza di un carico di scrittura intenso e continuo, questa attesa può andare in timeout e l'operazione fallisce una volta riprese le operazioni di scrittura. Il rischio è maggiore finché un membro HA è ancora in fase di ricostruzione. L'operazione di implementazione esegue quindi la versione di destinazione senza un backup post-aggiornamento, e il supporto tecnico deve completare l'aggiornamento.
Per verificare se il carico di scrittura consente ai membri HA di recuperare il ritardo, esegui la seguente query all'ora prevista per l'aggiornamento. Ripetilo ogni secondo per alcuni minuti, ad esempio con il comando " psql " \watch 1. Il servizio richiede che tutti i membri dell'HA mostrino " 0 " in " replay_lag_bytes " contemporaneamente. Se ciò non dovesse mai verificarsi, ridurre il carico
di scrittura prima di avviare l'aggiornamento.
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;
L'aggiornamento non aggiorna le statistiche dell'ottimizzatore, pertanto le query potrebbero continuare a utilizzare piani di esecuzione lenti finché non si esegue il comando ANALYZE``. Gli aggiornamenti a PostgreSQL e 15, 16
o 17 non comportano il trasferimento delle statistiche. L'aggiornamento a PostgreSQL 18 trasferisce la maggior parte delle statistiche, ma non le statistiche estese create con CREATE STATISTICS, né quelle raccolte da estensioni
quali PostGIS. Il processo " autovacuum " analizza una tabella solo dopo un numero sufficiente di operazioni di scrittura e non analizza mai le tabelle partizionate. Non attendere il completamento dell'operazione.
Non appena SHOW default_transaction_read_only; restituisce off, aggiornare le statistiche come descritto nella sezione “Dopo l’aggiornamento ”.
La modalità di sola lettura imposta un valore predefinito per le nuove transazioni. Non blocca il database. Una sessione che imposta default_transaction_read_only su off`` oppure che avvia esplicitamente
una transazione in lettura-scrittura può comunque eseguire operazioni di scrittura. Lo stesso vale per un ruolo il cui percorso default_transaction_read_only è off. Anche i comandi di manutenzione come VACUUM,
ANALYZE, REINDEX e CLUSTER continuano a funzionare. La modalità di sola lettura non interrompe un processo di " pg_cron " già in esecuzione né un abbonamento attivo su "
PostgreSQL 17". Tali operazioni di scrittura possono causare il fallimento dell'aggiornamento. Prima di inviare l'aggiornamento, interrompi i processi che ignorano la modalità di sola lettura. Sospendere i processi pianificati che scrivono
o eseguono comandi di manutenzione, come i processi “ pg_cron ”, e attendere il completamento dei processi in esecuzione. Ripristinarli come descritto nella sezione “Dopo l’aggiornamento ”.
Le operazioni di lettura possono anche scrivere nei log delle transazioni durante la modalità di sola lettura, ad esempio la prima volta che le query leggono le righe dopo un caricamento in blocco o un aggiornamento di grandi dimensioni. Questa
attività ritarda il completamento dell'operazione di sincronizzazione che le fasi "solo lettura" e "riavvio" attendono, pertanto le operazioni di scrittura rimangono bloccate più a lungo e l'aggiornamento potrebbe non
andare a buon fine. Prima di eseguire l'aggiornamento, esegui il comando VACUUM sulle tabelle che hai caricato di recente o modificato in modo significativo.
Quando il servizio chiude una sessione, un client che si connette direttamente all'istanza riceve lo SQLSTATE 57P01 (admin_shutdown). Un'operazione di scrittura in una transazione di sola lettura fallisce con lo SQLSTATE
25006 (read_only_sql_transaction). Durante la fase di conversione, una nuova connessione può fallire a causa di un errore di autenticazione, ad esempio lo SQLSTATE 28P01, anche se le credenziali sono
rimaste invariate. Prova nuovamente a collegarti dopo la conversione. Se questi errori persistono dopo che l'attività risulta " Non riuscita ", contattare l'assistenza. Tramite un gestore del pool di connessioni,
le applicazioni possono rilevare altri errori di connessione.
I client che accettano solo sessioni in lettura-scrittura non possono connettersi quando è attiva la modalità di sola lettura, pertanto anche le operazioni di lettura non sono disponibili per loro fino alla ripresa delle operazioni di scrittura.
Ciò vale per i client libpq che impostano target_session_attrs=read-write e per i client JDBC che impostano targetServerType=primary o master. Per garantire la disponibilità delle operazioni
di lettura, utilizzare target_session_attrs=any oppure primary con libpq 14 o versioni successive. Per " JDBC ", usa " targetServerType=any".
Le applicazioni devono gestire gli errori di connessione e gli errori di lettura, riconnettersi e riprovare a eseguire le transazioni interrotte solo quando è sicuro farlo. Il pooling delle connessioni non elimina questi requisiti. L'accesso all'applicazione non costituisce prova del completamento dell'operazione di aggiornamento.
Backup e ripristino
Il servizio non esegue un backup dei dati prima dell'aggiornamento. Creare e verificare un backup on-demand recente prima di eseguire IPMVU. Per tornare alla versione di origine dopo un aggiornamento, ripristinare un backup o un punto di ripristino precedente all'aggiornamento in una nuova distribuzione che esegua la versione di origine. Imposta esplicitamente la versione, poiché un ripristino a un punto nel tempo senza specificare una versione crea una distribuzione che esegue la versione corrente. Questa opzione richiede che la versione di origine sia ancora disponibile per le nuove distribuzioni. Tenere conto delle modifiche apportate da quel momento in poi.
Una volta completato con successo l'aggiornamento, il servizio inserisce in coda un backup della distribuzione aggiornata. Il backup viene eseguito separatamente al termine dell'aggiornamento e potrebbe non avviarsi immediatamente. Questo primo backup sulla nuova versione copia l'intero database, quindi, nel caso di un database di grandi dimensioni, l'operazione potrebbe richiedere diverse ore. Verifica lo stato nella sezione " Backup e ripristino ". Se l'operazione non va a buon fine, esegui un backup su richiesta e, se i problemi persistono, contatta l'assistenza. Un errore durante il backup non comporta il rollback dell'aggiornamento.
Il ripristino a un punto nel tempo (PITR) non consente di riprodurre le transazioni effettuate durante l'aggiornamento alla versione principale. È possibile eseguire il ripristino a un punto nel tempo precedente l'avvio dell'operazione di aggiornamento oppure successivo al completamento del primo backup della distribuzione aggiornata. Non sono supportati i ripristini a punti di ripristino compresi tra l'aggiornamento e il completamento del backup successivo all'aggiornamento. Il servizio rifiuta alcuni di questi punti di ripristino, mentre il ripristino da altri potrebbe essere accettato ma fallire durante il processo di ripristino. Questo periodo non supportato comprende il tempo successivo alla ripresa delle operazioni di scrittura. Fino al completamento del backup successivo all'aggiornamento, anche il ripristino all'ultimo punto di ripristino disponibile potrebbe non andare a buon fine, anche se il servizio accetta la richiesta di ripristino.
Per mantenere la copertura PITR per le modifiche successive all'aggiornamento, sospendere le operazioni di scrittura delle applicazioni fino al completamento del backup successivo all'aggiornamento. Mettile in pausa nelle tue applicazioni.
Quando le operazioni di scrittura riprendono, l'aggiornamento reimposta l'impostazione " default_transaction_read_only " su ogni database; pertanto, un'impostazione di sola lettura a livello di database non mantiene
sospese le operazioni di scrittura.
Un aggiornamento non riuscito non inserisce il backup nella coda. Il servizio PITR potrebbe non essere disponibile per l'assegnazione dei punti nel periodo compreso tra l'inizio del tentativo e il successivo backup completato. Dopo un aggiornamento
non riuscito, se SHOW server_version; riporta la versione di origine e l'ambiente di distribuzione accetta operazioni di scrittura, eseguire un backup su richiesta. In caso contrario, contatta l'assistenza prima di eseguire
un backup o apportare altre modifiche.
I backup e i punti di ripristino precedenti all'aggiornamento appartengono alla versione precedente e rimangono soggetti ai limiti di conservazione. Per ulteriori informazioni, consultare PITR.
Le opzioni di skip-backup non sono supportate per PostgreSQL: skip_backup nell'API, --skip-backup nella CLI e version_upgrade_skip_backup in Terraform. Le richieste che ne consentono l'esecuzione falliscono.
L'API e la CLI restituiscono un errore e i piani di Terraform falliscono.
Prima di iniziare
Applicare questi requisiti sia all'ambiente di staging che a quello di produzione:
-
Completare la preparazione della domanda, dell'estensione e della replica, nonché la preparazione del backup.
-
Risolvere i problemi che i controlli preliminari non rilevano ed eseguire le query di autocontrollo.
-
Assicurarsi che ogni membro dei dati utilizzi una quantità di spazio su disco nettamente inferiore alla metà di quello disponibile, in modo che durante la ricostruzione dei membri HA non si verifichi un esaurimento dello spazio. Per ulteriori informazioni, consultare la sezione " Disponibilità durante un aggiornamento ".
-
Assicurarsi che l'implementazione disponga di almeno un backup completato. Fino a quel momento, la console disabilita il pulsante " Aggiorna versione principale " e l'API respinge la richiesta.
-
IPMVU non è disponibile in un'implementazione con replica in sola lettura. Per aggiornare una replica, promuovila tramite un aggiornamento di versione.
-
Eseguire il promote o l'eliminazione di ogni replica in sola lettura della distribuzione, comprese le repliche presenti in altre regioni, e attendere il completamento di ciascuna operazione. Una replica eliminata rimane associata alla distribuzione fino a quando non viene eliminata definitivamente. L'aggiornamento non supera i controlli preliminari finché una replica è associata alla distribuzione. Prevedere la possibilità che le applicazioni leggano da queste repliche. Per ulteriori informazioni, consultare la sezione " Repliche di sola lettura" e "IPMVU ".
-
Esegui un aggiornamento alla volta. Il servizio rifiuta una nuova richiesta di aggiornamento se un'altra operazione di aggiornamento è in coda o in esecuzione.
-
Se la configurazione "
synchronous_commit" della distribuzione è impostata su "on", modificala in "local" prima di inviare l'aggiornamento. Ripristina l'impostazione precedente dopo che l'attività risulta " Completata ". Conon, un aggiornamento non riuscito può rendere tutti i database in sola lettura o bloccare i commit fino a quando il supporto tecnico non ripristina l'implementazione. L'impostazione della distribuzione è "on" se la seguente query restituisce "on" con l'origineconfiguration file:SELECT setting, source FROM pg_catalog.pg_settings WHERE name = 'synchronous_commit'; -
Scegli una destinazione tra le funzionalità della tua distribuzione. È possibile eseguire l'aggiornamento direttamente a qualsiasi versione successiva che figuri come transizione di aggiornamento, senza passare per le versioni intermedie. Una versione che è possibile configurare non è necessariamente una destinazione per l'aggiornamento in loco:
ibmcloud cdb deployment-capability-show <NAME|CRN> versionsNell'output, utilizzare il valore "
to_version" di una voce " Upgrade Transition ".
Controlli preliminari e preparazione
Il servizio esegue i seguenti controlli prima dell'avvio della modalità di sola lettura. Se un controllo non va a buon fine, l'attività viene contrassegnata come “Failed” e la distribuzione rimane alla versione corrente
senza bloccare le operazioni di scrittura. Se in un database qualsiasi l'impostazione " default_transaction_read_only " è impostata su " on", un controllo non riuscito reimposta questa impostazione
su tutti i database e chiude tutte le sessioni dei client. L'attività non indica quale controllo abbia dato esito negativo, quindi verifica ogni voce prima di inviare l'aggiornamento.
| Verifica | Si verifica quando | Azione utente |
|---|---|---|
| Stato dell'implementazione | Tutti i membri del data center sono in esecuzione e ogni membro HA sta ricevendo i dati in streaming dal primario. | Attendere il completamento del ridimensionamento, della manutenzione e della ricostruzione dei membri HA. Verificare tramite la query di autocontrollo 1. Altre attività non falliscono questo controllo, ma ritardano l'avvio dell'aggiornamento.
Controlla le attività recenti oppure visualizza l'elenco delle attività con ibmcloud cdb deployment-tasks-list. Se questo controllo
continua a dare esito negativo, contatta l'assistenza. |
| Spazio disco | Ogni elemento dei dati utilizza al massimo il 90% dello spazio su disco assegnatogli. | Ridimensionare il disco o eliminare i dati che non servono più. Anche gli slot di replica logica non utilizzati possono conservare i log delle transazioni. Questo controllo consente di arrivare fino al 90%, ma per una ricostruzione dei membri HA è necessario che ciascun membro dati utilizzi ben meno della metà dello spazio disponibile sul proprio disco. Vedi la sezione " Disponibilità durante un aggiornamento ". |
| CPU, memoria e I/O su disco | Per ciascun nodo, la media di carico su 1 minuto dell'host non supera il 90% del numero di CPU, e l'utilizzo della memoria dell'host non supera il 90%. Anche l'utilizzo dell'I/O su disco non supera il 90%. | Esegui l'aggiornamento durante un periodo di scarsa attività oppure invia nuovamente la richiesta di aggiornamento in un secondo momento. Il servizio misura il carico e l'utilizzo della memoria dell'intero host, compresi gli altri carichi di lavoro presenti su di esso, e rileva l'I/O del disco per alcuni secondi. La media di carico tiene conto anche dei processi in attesa di operazioni di I/O su disco. I suoi valori possono quindi differire dalle metriche di monitoraggio e il ridimensionamento dell'implementazione potrebbe non comportarne una riduzione. Se questo controllo continua a dare esito negativo, contatta l'assistenza. |
| Archiviazione del log delle transazioni | L'archiviazione non presenta errori e non ci sono più di 4 GB di log delle transazioni in attesa di archiviazione. | Ridurre la velocità di scrittura fino a quando l'arretrato non viene smaltito. Verificare tramite la query di autocontrollo n. 5. Il controllo fallisce anche se un membro HA presenta log di transazione in sospeso, ad esempio subito dopo un failover. Se questo controllo continua a dare esito negativo, contatta l'assistenza. |
| Replica logica | Non esiste alcuno slot di replica logico. PostgreSQL e 16 e precedenti non prevedono alcuna sottoscrizione logica, comprese quelle disabilitate. | Rimuovere le fessure. PostgreSQL e 16 e precedenti: rimuovere gli abbonamenti. In " PostgreSQL " 17, disattivarle. Verificare con le domande di autovalutazione n. 2 e n. 3. |
| Repliche in sola lettura e client di replica | L'implementazione non ha alcuna replica di sola lettura associata e nessun client di replica, ad eccezione dei membri HA, si connette ad essa. Le repliche vengono conteggiate in ogni regione e stato, comprese quelle in fase di provisioning o disconnesse. | Elenca le repliche associate nella console oppure con ibmcloud cdb deployment-read-replicas. Promuovi o elimina ciascuno di essi e attendi che ogni
operazione venga completata. Una replica eliminata continua a essere conteggiata finché non viene eliminata definitivamente, anche se non compare più nell'elenco. Vedi “Repliche di sola lettura” e “IPMVU ”. Disconnetti gli altri client di replica. La query di autocontrollo 1 mostra solo i client connessi. |
| Operazioni predisposte | Non esiste alcuna transazione preparata. | Fare in modo che l'applicazione proprietaria o il gestore delle transazioni risolva le transazioni preparate e impedisca l'avvio di nuove transazioni fino al completamento dell'aggiornamento. Non effettuarle né annullarle solo per superare il controllo. Verificare tramite la query di autocontrollo n. 4. |
| Esportazione dello schema | Lo schema di ciascun database viene esportato senza errori. Un'operazione di esportazione che va in timeout o esaurisce lo spazio di blocco non fallisce questo controllo. | Eseguire una simulazione dell'aggiornamento su un ambiente di staging ripristinato da un backup recente. Questo controllo non verifica se la versione di destinazione sia in grado di ricreare lo schema, pertanto occorre risolvere anche le condizioni che i controlli preliminari non rilevano. Se questo controllo continua a dare esito negativo, contatta l'assistenza. |
| Compatibilità con gli aggiornamenti | PostgreSQL I controlli di compatibilità dell'aggiornamento hanno esito positivo sul server primario e su ogni membro dell'HA. | Completare la preparazione dell'estensione, compreso il controllo " pgRouting ". Il 17 di " PostgreSQL ", mantieni al massimo 10 abbonamenti.
Verificare con le domande di autovalutazione n. 6, 8, 9 e 10. |
Condizioni che i controlli preliminari non rilevano
I controlli preliminari non rilevano le seguenti condizioni. Alcuni di essi causano il fallimento dell'aggiornamento dopo che le operazioni di scrittura sono state bloccate. Se la causa risiede nello schema, ad esempio in una funzione o nel nome di un database, ogni nuovo tentativo fallirà allo stesso modo finché non si risolverà il problema. Altre condizioni fanno sì che il servizio copi l'intero database sui membri HA, il che mantiene le operazioni di scrittura bloccate per molto più tempo, oppure causano il fallimento dell'aggiornamento dopo la ripresa delle operazioni di scrittura. Un errore nella fase di conversione o di riavvio può inoltre causare l'arresto dei membri HA fino a quando il supporto tecnico non li riavvia. Risolvi o pianifica ogni problema prima di inviare l'aggiornamento.
| Condizione | Effetto | Cosa fare |
|---|---|---|
Un database contiene una tabella denominata " UNLOGGED ". |
Ogni membro dell'HA viene ricostruito e i contenuti dell' UNLOGGED e vengono azzerati. |
Verificare tramite la query di autocontrollo n. 11. Vedi le tabelle e le sequenze di UNLOGGED. |
| L'ambiente è basato su PostgreSQL e 16 o 17 e le tabelle si sono ingrossate a causa di operazioni in blocco o di numerosi inserimenti o aggiornamenti simultanei. | I membri dell'HA vengono ricostituiti. | Pianificare la finestra di manutenzione e lo spazio su disco necessario per la ricostruzione. Vedi la sezione " Disponibilità durante un aggiornamento ". |
| Un membro dei dati occupa circa la metà dello spazio su disco a sua disposizione, o anche di più, quando i membri HA vengono ricostruiti. | La ricostruzione ha esaurito lo spazio disponibile. Le operazioni di scrittura possono rimanere bloccate per ore prima che l'attività fallisca. | Prima di eseguire l'aggiornamento, ridimensiona il disco in modo che ogni elemento dei dati occupi ben meno del 50% dello spazio disponibile sul disco. |
Un indice, una chiave di partizione, una colonna generata in modo memorizzato o le statistiche estese utilizzano una funzione “ LANGUAGE sql ” con un corpo di tipo stringa che indica oggetti esterni a pg_catalog senza il relativo schema. In un indice, specificare il nome dello schema “ ibm_extension ” ha lo stesso effetto. |
La conversione non va a buon fine. | Verificare tramite la query di autocontrollo n. 12. Vedi le funzioni SQL negli indici, nelle chiavi di partizione e nelle colonne generate. |
Un indice o una colonna generata in modo dinamico utilizza la versione earthdistance 1.1. |
La conversione non va a buon fine. | Verificare tramite la query di autocontrollo n. 13. Vedi earthdistance. |
| Una vista, un aggregato o una funzione con un corpo conforme allo standard SQL utilizza un nome di sistema che è stato rimosso nella versione di destinazione. Oppure una funzione, un ruolo o un’impostazione del database utilizza un parametro rimosso. | La conversione non va a buon fine. | Verificare con le domande di autovalutazione n. 7 e n. 14. Vedi gli oggetti che utilizzano nomi di sistema rimossi. |
anon È installata la versione 2. |
La conversione non va a buon fine. | Completa la preparazione all’esame “ anon ”. |
Il nome di un database contiene un apostrofo ('), una barra rovesciata (``), un segno di uguale (=), un carattere di nuova riga o un ritorno a capo. |
L'aggiornamento non va a buon fine; in alcuni casi ciò avviene dopo che le operazioni di scrittura sono state bloccate. | Verificare tramite la query di autocontrollo n. 15. Rinomina il database e aggiorna le stringhe di connessione. |
| I database contengono molte migliaia di tabelle e sequenze oppure, nelle versioni 14 e 15 di PostgreSQL, viste. | La conversione esaurisce lo spazio di blocco e non va a buon fine. | Verificare tramite la query di autocontrollo n. 16 e, se la query indica che è necessario, aumentare il valore di “ max_locks_per_transaction ”. |
| L'implementazione contiene un numero molto elevato di database, tabelle o oggetti di grandi dimensioni. | La conversione ha superato il limite di tempo. L'operazione fallisce oppure rimane in corso mentre il database non è disponibile. | Conta i tavoli e gli oggetti di grandi dimensioni utilizzando la query di autocontrollo n. 16. Esercitati su un ambiente di staging ripristinato da un backup recente dell'ambiente di produzione. Se la prova non va a buon fine, contatta l'assistenza. |
| L'attività di scrittura è elevata all'avvio dell'aggiornamento oppure vi sono molti log delle transazioni in attesa di archiviazione. | Una volta attivata la modalità di sola lettura, i membri HA e l’archiviazione del log delle transazioni hanno a disposizione solo pochi minuti per mettersi al passo. Un backlog che supera il controllo preliminare può richiedere più tempo per essere archiviato, con conseguente fallimento dell'aggiornamento. | Mantenere basso il carico dal momento in cui ha inizio l'aggiornamento fino alla ripresa delle operazioni di scrittura ed eseguire il comando VACUUM sulle tabelle caricate di recente prima dell'aggiornamento.
Verificare il ritardo di replica utilizzando la query riportata nella sezione “Disponibilità durante un aggiornamento ” e verificare l’archiviazione utilizzando la query di autocontrollo
n. 5. |
Le operazioni di scrittura continuano anche dopo l'attivazione della modalità di sola lettura, ad esempio a causa di sovrascritture in modalità di sola lettura, comandi di manutenzione, esecuzione di processi pg_cron o
sottoscrizioni abilitate su PostgreSQL 17. |
È possibile che i membri dell'HA e il processo di archiviazione non riescano a stare al passo in tempo, causando il fallimento dell'aggiornamento. | Blocca questi scrittori prima di inviare l'aggiornamento, come descritto nella sezione " Disponibilità durante un aggiornamento ". |
Un client prepara una transazione dopo i controlli preliminari. Il metodo PREPARE TRANSACTION continua a funzionare in modalità di sola lettura. |
L'aggiornamento non va a buon fine mentre le operazioni di scrittura sono bloccate. Un'operazione preparata poco prima dell'arresto di PostgreSQL può causare il fallimento della conversione. | Bloccare i client che utilizzano il commit in due fasi finché l'attività non risulta come " Completata". Verificare tramite la query di autocontrollo n. 4. |
| Durante l'aggiornamento si connette un client di replica. | Lo slot che viene creato non viene mantenuto e l'aggiornamento potrebbe fallire o bloccarsi mentre il database non è disponibile. | Mantenere i client di replica disconnessi finché l'attività non risulta come " Completata". Verificare con le query di autocontrollo 1 e 2. |
| Dopo la ripresa delle operazioni di scrittura, viene eseguito un carico in blocco continuo. | L'operazione fallisce dopo la ripresa delle operazioni di scrittura e la distribuzione continua a utilizzare la versione di destinazione fino a quando il supporto tecnico non completa l'aggiornamento. | Evita di caricare in blocco finché l'attività non risulta come " Completata". |
L'impostazione " synchronous_commit " della distribuzione è on. |
Un aggiornamento non riuscito può rendere tutti i database in sola lettura fino a quando il supporto tecnico non ripristina l'implementazione. | Modificalo in local, come descritto nella sezione " Prima di iniziare". |
Si esegue l'aggiornamento da PostgreSQL 16 o versioni precedenti alla 17 o successive e un indice, una vista materializzata o delle statistiche estese utilizzano una funzione senza l'impostazione " search_path ". |
Dopo l'aggiornamento, ANALYZE, REINDEX, CLUSTER, VACUUM FULL e REFRESH MATERIALIZED VIEW potrebbero non funzionare correttamente per questi oggetti. |
Verificare tramite la query di autocontrollo n. 17. Vedi le funzioni SQL negli indici, nelle chiavi di partizione e nelle colonne generate. |
Non modificare schemi, estensioni, database, slot di replica logica o sottoscrizioni tra l'invio della richiesta di aggiornamento e il completamento dell'operazione.
Verificare personalmente lo stato di preparazione
Prima di inviare la richiesta di aggiornamento, eseguire le seguenti query come utente “ admin ” con l’ psql. Lavorano all'indirizzo PostgreSQL, dal 14 al 18. Le query da 1 a 7 e la query 15 riguardano l'intera
implementazione, quindi è sufficiente eseguirle una sola volta in un database qualsiasi. Esegui le altre query in ciascun database.
-
Connessioni di replica. Ci sarà una riga per ciascun membro HA, ovvero il numero di membri dati meno uno, ciascuna con lo stato
streaming. Qualsiasi altra riga è una replica in sola lettura o un altro client di replica. Una riga denominata “pg_basebackup” indica che il servizio sta copiando il database su un membro HA o su una replica in sola lettura. Attendi che la copia sia terminata, quindi esegui nuovamente la query.SELECT application_name, client_addr, state FROM pg_catalog.pg_stat_replication ORDER BY application_name; -
Slot di replica logica. Non aspettatevi litigi.
SELECT slot_name, plugin, database, active FROM pg_catalog.pg_replication_slots WHERE slot_type = 'logical'; -
Abbonamenti logici. PostgreSQL e 16 e precedenti non restituiscono alcuna riga. Il 17 di " PostgreSQL ", ci si aspetta di trovare "
f" nella colonna "subenabled" di ogni riga.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; -
Operazioni predisposte. Non aspettatevi litigi.
SELECT gid, owner, database, prepared FROM pg_catalog.pg_prepared_xacts; -
Archiviazione del log delle transazioni. Ci si aspetta che
last_failed_timesia vuoto o precedente alast_archived_time, e chewaiting_filessia pari a 0 o vicino a 0. Un backlog che supera il controllo preliminare può comunque risultare troppo grande per essere archiviato una volta avviata la modalità di sola lettura.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'; -
Impostazioni di connessione al database. Non aspettatevi litigi. Elimina il database elencato il cui URL
datconnlimitè-2, poiché non è valido. Per qualsiasi altro database presente nell'elenco, autorizza le connessioni oppure eliminalo. Se la query riporta "template0", contattare l'assistenza.SELECT datname, datallowconn, datconnlimit FROM pg_catalog.pg_database WHERE (datname <> 'template0' AND (NOT datallowconn OR datconnlimit = -2)) OR (datname = 'template0' AND datallowconn); -
Impostazioni relative ai ruoli e al database. Assicurati che ogni parametro presente in
setconfigsia presente anche nella versione di destinazione. Reimpostare un parametro che la versione di destinazione ha rimosso o rinominato e configurare il parametro sostitutivo dopo l'aggiornamento. Ciò vale anche per i parametri definiti dalle estensioni che contengono un punto nel proprio nome. Assicurarsi che nessun ruolo imposti il parametrodefault_transaction_read_onlysu un valore falso, come ad esempiooff,false,noo0. Prendere nota di ogni database in cui è impostato il parametrodefault_transaction_read_only``, poiché l'aggiornamento reimposta tale impostazione. La query di autocontrollo n. 14 verifica le impostazioni delle funzioni.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; -
Tipi di dati delle colonne che PostgreSQL non è in grado di aggiornare. Non aspettatevi litigi. La query elenca anche le colonne dei tipi compositi di sistema, nonché dei domini, degli array, dei tipi compositi e degli intervalli basati su tali tipi. La colonna "
base_type" indica il tipo che impedisce l'aggiornamento. Il blocco di tipo "aclitem" impedisce solo gli aggiornamenti da PostgreSQL 14 o 15 alla versione 16 o successive.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; -
Colonne ereditate prive di un vincolo “
NOT NULL” presente nella tabella padre. Non aspettatevi litigi. Per fissare una colonna indicata, il proprietario della tabella esegue il comandoALTER 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; -
Estensioni installate. Completare la preparazione dell'estensione. Quindi, verificare che tutte le estensioni rimanenti siano disponibili nella versione di destinazione, ad esempio in un ambiente di staging di tale versione.
SELECT extname, extversion FROM pg_catalog.pg_extension ORDER BY extname; -
UNLOGGEDtabelle e sequenze. I loro contenuti non vengono mantenuti dopo l'aggiornamento e una tabella presente nell'elenco costringe il servizio a ricostruire ogni membro HA. Prima di eseguire l'aggiornamento, consultare la sezione " Tabelle e sequenze diUNLOGGED".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'); -
Funzioni SQL che possono causare il fallimento della conversione. Non aspettatevi litigi. La query elenca le funzioni
LANGUAGE sqlcon un corpo di tipo stringa utilizzate da un indice, da un predicato di indice parziale, da una chiave di partizione, da una colonna generata in modo memorizzato o da statistiche estese. Segue le chiamate tramite operatori, i vincoli di verifica dei domini e le funzioni con un corpo conforme allo standard SQL. Per ciascuna delle funzioni elencate, consultare la sezione " Funzioni SQL negli indici, nelle chiavi di partizione e nelle colonne generate".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; -
Indici e colonne generate memorizzate che utilizzano la versione
earthdistance1.1, direttamente o tramite funzioni con un corpo conforme allo standard SQL. Non aspettatevi litigi. Per ogni oggetto elencato, consultareearthdistance.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; -
Viste, viste materializzate, aggregati e funzioni che utilizzano nomi dei cataloghi di sistema o parametri di configurazione che sono stati rimossi in una versione successiva di PostgreSQL. La colonna “
removed_in” mostra la prima versione senza il nome. Non ci saranno righe con una versione “removed_in” pari o inferiore alla versione di destinazione. Un nome può corrispondere a del testo che non è un riferimento del catalogo, pertanto è necessario controllare ogni oggetto elencato. Vedi gli oggetti che utilizzano nomi di sistema rimossi.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; -
Nomi di database che l'aggiornamento non può utilizzare. Non aspettatevi litigi. Per correggere un database presente nell'elenco, il suo proprietario deve connettersi a un altro database ed eseguire
ALTER DATABASE "<database_name>" RENAME TO <new_name>;mentre non ci sono sessioni connesse al database che si sta rinominando. Il proprietario deve inoltre disporre dell'attributo "CREATEDB". A questo punto, aggiorna tutte le applicazioni che si collegano al database.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; -
Le relazioni bloccate dall'aggiornamento, gli oggetti di grandi dimensioni e la capacità di blocco della distribuzione. Somma i valori di "
locked_relations" relativi ai quattro database con i valori più alti. Il 14 e il 15 di " PostgreSQL ", il comandolocked_relationsinclude le viste e le viste materializzate, poiché l'aggiornamento le blocca anch'esse. Se il totale superalock_capacity, aumentaremax_locks_per_transactionfino a quandolock_capacitynon supera il totale. La modifica comporta il riavvio del database, quindi è necessario effettuarla prima di inviare l'aggiornamento. Anche la presenza di molte tabelle o di oggetti di grandi dimensioni allunga i tempi di conversione, quindi è consigliabile eseguire una prova dell'aggiornamento utilizzando lo schema e i dati effettivi.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; -
Funzioni prive dell'impostazione "
search_path" utilizzate dagli indici, dalle viste materializzate e dalle statistiche estese. La query segue le chiamate agli operatori, ai vincoli di verifica del dominio e alle funzioni con un corpo conforme allo standard SQL. Eseguire questa query se si esegue l'aggiornamento da PostgreSQL 16 o versioni precedenti a PostgreSQL 17 o versioni successive. Una funzione elencata il cui corpo fa riferimento a oggetti esterni apg_catalogsenza indicarne lo schema causa il fallimento dei comandi di manutenzione dopo l'aggiornamento. Una funzione non subisce alcuna modifica solo se il suo corpo, così come ogni funzione da essa richiamata, identifica ogni oggetto esterno apg_catalogcon il proprio schema. Per ciascuna delle altre funzioni elencate, il relativo proprietario aggiunge un’impostazione “search_path”, come descritto nella sezione “Funzioni SQL negli indici, nelle chiavi di partizione e nelle colonne generate ”.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;
Il superamento di questi controlli non garantisce che l'aggiornamento vada a buon fine né che le applicazioni siano compatibili con la versione di destinazione. Solo una prova in un ambiente di staging esegue l'intera conversione.
Pianificazione della finestra di aggiornamento
Sfrutta la prova generale per stimare una finestra temporale per la manutenzione. Il tempo necessario per la conversione dipende principalmente dal numero di database e di oggetti. Il tempo necessario per il ripristino di un nodo HA dipende dalle dimensioni del database. Il carico di lavoro e il volume del log delle transazioni influiscono sui controlli e sul processo di recupero. Considerare il tempo necessario per l'intera operazione di aggiornamento, non solo il tempo durante il quale le operazioni di scrittura vengono bloccate.
L'opzione "Avvio entro" definisce l'ora limite entro la quale può iniziare un aggiornamento in coda. L'impostazione predefinita è di 5 minuti dopo la richiesta, ed è possibile impostarla fino a 24 ore in anticipo. L'esecuzione di operazioni, come un backup, e le richieste precedentemente messe in coda ritardano l'avvio. Se l'aggiornamento non viene avviato prima della scadenza, non viene eseguito e lo stato dell'attività risulta " Scaduto". La scadenza non interrompe un aggiornamento già avviato. Ad esempio, una richiesta in coda scade alle 22:30 UTC. Un'attività che inizia alle 22:25 UTC può protrarsi oltre tale orario.
Mentre l'aggiornamento è in corso, le altre richieste di distribuzione vengono messe in attesa fino al suo completamento. Tra queste figurano la ridimensionamento manuale e automatico, le modifiche alla configurazione, le modifiche relative agli utenti e alle password, le modifiche agli indirizzi IP consentiti e i backup. Non eliminare la distribuzione mentre l'attività di aggiornamento è in coda o in esecuzione.
Non creare repliche di sola lettura finché l'operazione non è stata completata. Il servizio non blocca tali richieste. Se ne crei una, l'aggiornamento potrebbe non superare i controlli preliminari oppure la nuova replica potrebbe non riuscire a replicare i dati dalla distribuzione aggiornata. Eliminare tale replica e crearne una nuova al termine dell'operazione.
Aggiornamento nell'interfaccia utente
- Creare e verificare un backup su richiesta. L'aggiornamento non ne richiede uno.
- Nella pagina Panoramica della distribuzione, fare clic su " Aggiorna versione principale ".
- Nella fase "Guida ", rileggi le istruzioni, seleziona "Ho letto le istruzioni e sono pronto a procedere con l'aggiornamento ", quindi fai clic su " Avanti". Per sapere quando le operazioni di lettura e scrittura non sono disponibili, consultare la sezione " Disponibilità durante un aggiornamento ".
- In " Aggiorna alla versione ", seleziona la versione desiderata. Se sono disponibili più obiettivi, l'elenco seleziona per impostazione predefinita quello più recente. La nota sulle repliche di lettura in questa fase non è più aggiornata. L'aggiornamento non supera i controlli preliminari finché alla distribuzione è associata una replica in sola lettura; pertanto, prima di procedere con l'aggiornamento, è necessario promuovere o eliminare tutte le repliche.
- In " Tempo di scadenza per l'avvio dell'aggiornamento ", selezionare per quanto tempo la richiesta può rimanere in attesa prima di essere avviata. Il valore predefinito è 5 minuti.
- Fai clic su Upgrade. Mentre la richiesta è in attesa o in esecuzione, la riga "Versione" nella pagina Panoramica mostra "Aggiornamento in coda " o "Aggiornamento in corso ".
- Controlla l'attività nella sezione " Attività recenti ". Non appena riprenderanno le operazioni di scrittura, aggiornare le statistiche come descritto nella sezione “Dopo l’aggiornamento ”. Quando l'attività risulta come " Completata", completa i passaggi rimanenti in quella sezione. Se viene visualizzato il messaggio " Failed", consultare la sezione " Risoluzione dei problemi". Se viene visualizzato "Scaduto ", l'aggiornamento non è stato avviato ed è possibile inviarlo nuovamente indicando una data di scadenza successiva.
Aggiornamento tramite l'API
Invia una richiesta di tipo “ PATCH ” all’endpoint /deployments/{id}/version. Impostare version sulla versione principale desiderata e impostare la data di scadenza iniziale utilizzando
il parametro di query 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"}'
Sostituire <EXPIRATION_TIME> con un'ora UTC nel formato ISO 8601, ad esempio 2026-11-03T22:30:00Z, compresa tra 5 minuti e 24 ore dopo la richiesta. Se si omette l' expiration_datetime, la richiesta
scade se non viene avviata entro 5 minuti.
Una richiesta andata a buon fine restituisce un’attività. Una richiesta accettata non equivale a un aggiornamento completato. Utilizza l'ID dell'attività con la funzione " Ottieni informazioni su un'attività " per monitorare l'aggiornamento. Per visualizzare l'elenco dei target disponibili, utilizzare la funzione " Scopri informazioni sulle funzionalità" da una distribuzione dotata della funzionalità " versions ". Per tutti i parametri, consultare la documentazione di riferimento dell'API.
Aggiornamento tramite la CLI
Utilizzare la versione 0.20.0 o successive del plug-in CLI " Cloud Databases ". Imposta la scadenza iniziale utilizzando --expire-in o --expire-at, da 5 minuti a 24 ore dopo la richiesta. Il valore predefinito
è 5 minuti.
ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION> --expire-in 1h --nowait
Senza l'opzione " --nowait", il comando rimane in attesa fino al completamento o all'errore dell'operazione. Non restituisce alcun risultato se l'aggiornamento scade prima di iniziare, quindi negli script è consigliabile
utilizzare --nowait . Con --nowait``, il comando termina dopo che il servizio ha accettato la richiesta. Monitorare l'attività con deployment-tasks-list:
ibmcloud cdb deployment-tasks-list <NAME|CRN>
Per tutti i parametri, eseguire il comando ibmcloud cdb deployment-version-upgrade --help``.
Aggiornamento tramite Terraform
Utilizza il provider Terraform " IBM Cloud® " versione 1.79.2 o successive. Impostare " version " su una destinazione disponibile, rivedere il piano e applicarlo. Il piano fallisce se la destinazione non è
disponibile per un aggiornamento in loco.
Impostare il timeout di aggiornamento della risorsa in modo che sia sufficientemente lungo da coprire l'intero processo di aggiornamento e che sia pari ad almeno 5 minuti. Il provider utilizza questo timeout, che può arrivare fino a 24 ore,
anche come data di inizio della scadenza. Un aggiornamento in coda può quindi avviarsi in qualsiasi momento fino allo scadere del timeout. Applicare la modifica quando non sono in esecuzione né in coda operazioni di backup o di altro tipo,
in modo che l'aggiornamento abbia inizio immediatamente. Se il tempo di applicazione scade dopo l'avvio dell'aggiornamento, quest'ultimo prosegue comunque. Se al termine del timeout l'aggiornamento è ancora in coda, scade e non viene eseguito.
Attendere il completamento dell'operazione prima di eseguire nuovamente terraform plan o terraform apply.
Se l'operazione di aggiornamento non va a buon fine, completare la procedura di risoluzione dei problemi prima di eseguire nuovamente " terraform apply ". Terraform esegue
nuovamente l'aggiornamento ogni volta che l'implementazione continua a riportare la versione di origine.
Dopo un aggiornamento effettuato al di fuori di Terraform, imposta version sulla nuova versione oppure rimuovi version dalla configurazione. Gli aggiornamenti al di fuori di Terraform
includono quelli relativi all'interfaccia utente, alla CLI o all'API, nonché gli aggiornamenti forzati. Finché non si aggiorna la configurazione, ogni operazione terraform plan e terraform apply che include la distribuzione fallisce, impedendo di apportare modifiche alle altre risorse presenti nella stessa configurazione. L'errore è simile a quello descritto in Version 14 is not a valid upgrade version o No available upgrade versions for version 18.
L'argomento version_upgrade_skip_backup non è supportato per PostgreSQL. Per ulteriori informazioni, consultare la guida alle risorse del database.
Dopo l'aggiornamento
Non appena riprenderanno le operazioni di scrittura, assicurati che le statistiche dell'ottimizzatore siano complete. Non attendere il completamento dell'operazione. Le operazioni di scrittura sono riprese quando SHOW default_transaction_read_only; restituisce off in una nuova sessione. In ogni database, la seguente query elenca le tabelle e le viste materializzate prive di statistiche. Eseguire il comando ANALYZE <table_name>; per ciascuna
relazione elencata. Se l'utente non dispone dei permessi necessari per analizzare una relazione, eseguire il comando come proprietario della relazione. L'analisi di una tabella partizionata comporta anche l'analisi delle sue partizioni.
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');
PostgreSQL e 17 e successive, l'operazione ANALYZE può fallire con un errore del tipo function ... does not exist. In tal caso, correggi la funzione indicata nella query di autocontrollo n. 17 ed esegui nuovamente
il comando ANALYZE . Un’operazione di " ANALYZE " a livello di database che si interrompe a causa di un errore non analizza le tabelle rimanenti. Il 18 d PostgreSQL, analizzare anche ogni
tabella che contenga oggetti statistici, come elencati dal comando psql ( \dX), e ogni tabella che contenga colonne PostGIS, poiché l'aggiornamento non trasferisce tali statistiche.
Quando l'attività risulta " Completata ":
-
Verificare che la versione della distribuzione visualizzata nella console o nell'API corrisponda alla versione di destinazione e che
SHOW server_version;restituisca tale versione. Eseguire la query di autoverifica 1 e verificare che tutti i membri HA stiano trasmettendo dati in streaming. Verifica inoltre che le operazioni di scrittura siano riprese in tutti i database: la seguente query non restituisce alcuna riga. Se manca un membro dell'HA, se rimane una riga denominata "pg_basebackup" oppure se la query riporta un database, contattare l'assistenza.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=%'); -
Aggiornare le estensioni. L'aggiornamento mantiene ogni estensione alla versione in cui è stata installata. In ogni database, elenca le estensioni per cui è disponibile una versione più recente e aggiorna ciascuna di esse:
SELECT name, installed_version, default_version FROM pg_catalog.pg_available_extensions WHERE installed_version <> default_version;ALTER EXTENSION <extension_name> UPDATE;Se si è effettuato l'aggiornamento da PostgreSQL 14, 15 o 16 a PostgreSQL 17 o versioni successive, l'aggiornamento di
pg_stat_statementscomporta la ridenominazione delle colonneblk_read_timeeblk_write_timeinshared_blk_read_timeeshared_blk_write_time. Aggiornare le query che leggono queste colonne. -
Ripristinare le estensioni e la mascheratura come descritto nella fase di preparazione. Ricarica le tabelle di
UNLOGGEDdal contenuto che hai esportato. Impostare ogni sequenza “UNLOGGED” su valori superiori a quelli attualmente in uso, ad esempio con “SELECT setval('<sequence_name>', (SELECT max(<column_name>) FROM <table_name>));”. Ricreare gli slot di replica logica, le sottoscrizioni e le repliche in sola lettura che sono stati rimossi e riattivare le sottoscrizioni che sono state disattivate. Ristabilire la connessione dei client e risincronizzare i dati prima di riprendere l'esecuzione delle applicazioni dipendenti. -
Se hai impostato "
default_transaction_read_only" per un database, reimpostalo. L'aggiornamento ripristina questa impostazione su ogni database, in modo che tali database tornino ad accettare operazioni di scrittura. -
Verificare che il backup successivo all'aggiornamento sia stato completato. Copia l'intero database, quindi l'operazione potrebbe richiedere diverse ore. Se è necessario eseguire un ripristino a un punto specifico nel tempo per le modifiche apportate dopo l'aggiornamento, sospendere le operazioni di scrittura dell'applicazione fino a quel momento.
-
Se hai effettuato l'aggiornamento da PostgreSQL 14 o 15 a PostgreSQL 16 o versioni successive, esegui la query relativa ai ruoli descritta nella sezione " Problemi relativi ai privilegi dei ruoli durante gli aggiornamenti di versione ". Assegna i ruoli elencati prima di riprendere i processi che gestiscono i ruoli.
-
Se Terraform gestisce la distribuzione e l'aggiornamento è stato effettuato al di fuori di Terraform, impostare
versionsulla nuova versione oppure rimuoverlo, come descritto nella sezione " Aggiornamento tramite Terraform ". -
Riprendi le operazioni di scrittura dell'applicazione e i processi pianificati che avevi messo in pausa. Ripristina le impostazioni che hai modificato in occasione dell'aggiornamento, come ad esempio
synchronous_commit. -
Rigenerare gli oggetti che dipendono dai dati Unicode, poiché le versioni più recenti di PostgreSQL utilizzano dati Unicode più recenti:
- A meno che non si sia effettuato l'aggiornamento da PostgreSQL 16 a PostgreSQL 17, verificare gli indici, le viste materializzate, i vincoli di controllo e le chiavi di partizione le cui espressioni utilizzano
normalize()ois_normalized(). Il problema riguarda solo il testo che contiene caratteri introdotti nelle versioni successive di Unicode. - Se hai effettuato l'aggiornamento da PostgreSQL 17 a PostgreSQL 18, controlla anche gli oggetti che utilizzano
unicode_assigned(). Verifica anche gli oggetti che applicano espressioni regolari,ILIKE,lower(),upper()oinitcap()al testo nella locale predefinitaC.UTF-8. I sistemi di ordinamento "pg_c_utf8" e i database che utilizzano il provider di impostazioni locali "builtin" con "C.UTF-8" utilizzano questa impostazione locale. - Se è stato effettuato l'aggiornamento a PostgreSQL 18 e un database utilizza il provider di impostazioni locali
icuobuiltin, ricostruire gli indici di ricerca full-text e quelli dipg_trgm.
Eseguire il comando
REINDEX INDEX <index_name>;per ogni indice interessato eREFRESH MATERIALIZED VIEW <view_name>;per ogni vista materializzata interessata. Assicurarsi che le righe continuino a soddisfare i vincoli di controllo interessati e si trovino nelle partizioni corrette. - A meno che non si sia effettuato l'aggiornamento da PostgreSQL 16 a PostgreSQL 17, verificare gli indici, le viste materializzate, i vincoli di controllo e le chiavi di partizione le cui espressioni utilizzano
-
Confronta il comportamento e le prestazioni dell'applicazione con i risultati ottenuti in ambiente di staging.
Risoluzione dei problemi
Se il servizio rifiuta una richiesta, l'errore viene visualizzato immediatamente. L'interfaccia utente di solito mostra il messaggio " Aggiornamento non riuscito " con la relativa motivazione, l'API restituisce il messaggio di errore e la CLI visualizza l'errore con un suggerimento. Correggi la richiesta e inviala nuovamente.
Se l'attività risulta come " Scaduta ", l'aggiornamento non è stato avviato e la distribuzione rimane invariata. Invia nuovamente la richiesta di aggiornamento quando non ci sono altre operazioni in esecuzione o in coda, oppure imposta una scadenza di avvio successiva.
Un'attività che in seguito risulta come “Fallita” non identifica il controllo o la fase in cui si è verificato l'errore, e l'interfaccia utente non ne mostra la causa. A seconda della fase in cui si è verificato l'errore, l'implementazione può trovarsi in uno dei seguenti stati:
- Versione sorgente: l'implementazione esegue la versione sorgente e accetta operazioni di scrittura. Se il controllo preliminare fallisce, la distribuzione rimane in questo stato e il servizio ripristina l'accesso in scrittura
dopo la maggior parte degli errori verificatisi durante la modalità di sola lettura. Anche un tentativo fallito può avere effetti duraturi. Può rimuovere
old_snapshot, svuotare le tabelleUNLOGGED, reimpostare le sequenzeUNLOGGEDe creare una lacuna nella copertura PITR. Può inoltre ripristinare le impostazioni di "default_transaction_read_only" a livello di database, in modo che tali database accettino nuovamente le operazioni di scrittura. Se si imposta il parametrodefault_transaction_read_onlysuonper qualsiasi database, un tentativo fallito comporta la chiusura di tutte le sessioni client, anche nel caso in cui un controllo preliminare non vada a buon fine. - Informazioni sulla versione di destinazione: l'implementazione esegue la versione di destinazione, ma l'aggiornamento rimane incompleto finché il supporto tecnico non lo porta a termine. La console e l'API possono ancora visualizzare la versione sorgente. Fino ad allora, i membri dell'HA potrebbero non essere operativi e il backup e l'archiviazione del log delle transazioni potrebbero non andare a buon fine. Se la query di autoverifica 1 o 5 rileva un problema, sospendere le operazioni di scrittura dell'applicazione fino a quando il supporto tecnico non avrà completato l'aggiornamento.
- Compromesso: l'implementazione rimane in sola lettura o non disponibile, oppure funziona senza i propri membri HA, fino a quando il supporto non la ripristina. Un errore nella fase di conversione o di riavvio può causare l'arresto dei membri HA fino a quando il supporto tecnico non li riavvia, anche dopo la ripresa delle operazioni di scrittura.
Per identificare lo stato, effettuare l'accesso come admin ed eseguire SHOW server_version;. In ogni database che utilizzi, esegui il comando SHOW default_transaction_read_only;``. Eseguire la query di autocontrollo n. 1 per verificare che tutti i membri HA stiano trasmettendo dati. Se admin non riesce a connettersi dopo che l'operazione è fallita, ad esempio a causa di un errore di autenticazione, contattare l'assistenza. L'aggiornamento non
modifica le tue credenziali.
Se l'implementazione accetta operazioni di scrittura, esegue la versione di origine e tutti i membri HA stanno trasmettendo dati in streaming, verificare i controlli preliminari ed eseguire le query di autoverifica. Risolvi tutti i problemi non risolti, esegui un backup su richiesta, quindi invia nuovamente la richiesta di aggiornamento. In tutti gli altri casi, oppure se anche il tentativo successivo fallisce, contatta l'assistenza prima di riprovare o di apportare altre modifiche. Includi:
- Il CRN dell'implementazione e l'ID dell'attività non riuscita. Prendi nota dell'ID dell'attività quando questa fallisce, poiché gli elenchi delle attività mostrano solo quelle più recenti.
- Le versioni di PostgreSQL della sorgente e della destinazione richiesta, nonché l'output di
SHOW server_version;. - L'ora approssimativa del guasto e il fuso orario.
- Se le applicazioni sono in grado di connettersi, leggere e scrivere.
- I risultati delle query di autocontrollo.
- Il CRN di ciascuna replica in sola lettura correlata, comprese eventuali repliche promosse o eliminate di recente.
Se la richiesta non va a buon fine a causa di un errore interno, contatta l'assistenza. Nell'interfaccia utente, questo errore viene visualizzato come " Aggiornamento non riuscito " con il messaggio " Impossibile creare l'attività di aggiornamento in loco ". L'interfaccia utente visualizza questo messaggio anche per altre richieste respinte, quando non è in grado di mostrare il motivo effettivo. Per conoscere il motivo, invia la richiesta tramite CLI o API. Contatta l'assistenza anche
se l'operazione rimane in corso molto più a lungo rispetto a quanto avvenuto durante la prova. A seguito di un errore, l'attività può rimanere in corso (stato " running " nella CLI e nell'API) mentre il servizio tenta
il ripristino.
Rimuovere solo gli oggetti indicati nelle fasi di preparazione e nelle domande di autoverifica. Non far cadere altri oggetti per superare un controllo. Contatta invece l'assistenza.
Aggiornamento da una replica di sola lettura
Creare una replica in sola lettura dalla distribuzione di origine e attendere che la replica si sincronizzi. Quindi, promuovere e aggiornare la replica
utilizzando l'endpoint /remotes/promotion. Impostare " version " su un obiettivo presente nell'elenco delle funzionalità
della replica:
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
}
}'
Imposta " skip_initial_backup " su " true " solo se desideri saltare il backup iniziale creato dalla promozione. Questa impostazione può ridurre la durata dell'operazione di promozione, ma il ripristino
della distribuzione promossa richiede poi il corretto completamento di un backup pianificato o su richiesta.
Se un'operazione di promozione con aggiornamento della versione non va a buon fine, il servizio disattiva la distribuzione promossa. Contatta il supporto. Prima di fare affidamento su una promozione con aggiornamento della versione, provatela su una replica di un ambiente di staging.
Aggiornamento tramite ripristino da backup
Ripristinare un backup in un'installazione che utilizza una versione di destinazione supportata. Se si ripristina un backup utilizzando la CLI o l'API senza specificare i parametri di allocazione delle risorse, la nuova distribuzione utilizzerà le allocazioni delle risorse che la distribuzione di origine aveva al momento della creazione del backup. Nell'interfaccia utente, la pagina di ripristino mostra inizialmente le allocazioni attuali della distribuzione di origine, che è possibile modificare.
Ripristino di un backup nell'interfaccia utente
Nella sezione " Backup e ripristino " della dashboard di distribuzione, fare clic su "Ripristina backup " per il backup che si desidera utilizzare. Nella pagina che si apre, selezionare una versione di destinazione supportata nel campo " Versione del database " e configurare le opzioni per la nuova distribuzione. Quindi, fare clic su " Ripristina backup ".
Ripristino di un backup tramite l'interfaccia a riga di comando (CLI)
Creare la distribuzione specificando la versione di destinazione e l'ID del backup nell'argomento 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"
Ripristino di un backup tramite l'API
Utilizza l'API del controller delle risorse per ripristinare un backup in una nuova distribuzione che esegue la versione di destinazione. Specificare il nome della distribuzione, la posizione, il gruppo di risorse, il piano, l'ID del backup e la versione di destinazione:
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"
}
}'
Aggiornamento forzato
Dopo la data di fine supporto, tutte le installazioni attive di Databases for PostgreSQL che utilizzano la versione obsoleta verranno automaticamente aggiornate alla versione successiva supportata.
Un aggiornamento forzato è un IPMVU, pertanto è necessario completare la preparazione per l'IPMVU prima della data di fine vita.
Eseguite l'aggiornamento prima della data di fine vita per evitare i seguenti rischi:
- Non sono previsti SLA per questo tipo di aggiornamento forzato.
- Potresti subire una perdita di dati.
- Il tuo servizio potrebbe subire un'interruzione prolungata.
- L'applicazione potrebbe smettere di funzionare se non è compatibile con la nuova versione.
- Non è possibile controllare la tempistica dell'aggiornamento per la propria installazione.
- Non è previsto un processo di rollback per questo aggiornamento forzato.
- Se Terraform gestisce la distribuzione e imposta
version, ogni ` `terraform plan` ` fallisce dopo l'aggiornamento forzato finché non si aggiorna ` `version.
Per le date di fine supporto, consultare la pagina relativa alla politica sulle versioni.
Problemi relativi ai privilegi dei ruoli durante gli aggiornamenti di versione
In PostgreSQL 16 e versioni successive, un ruolo con l'attributo " CREATEROLE ", come ad esempio admin, richiede che un altro ruolo disponga dell'attributo " ADMIN OPTION " per poterlo
gestire. La gestione di un ruolo comprende la modifica della password o degli attributi, la sua eliminazione e l'assegnazione dei membri. L'aggiornamento da PostgreSQL 14 o 15 alla versione 16 o successive non rende disponibile questa opzione
in admin per i ruoli esistenti prima dell'aggiornamento. I processi che gestiscono queste funzioni come " admin", ad esempio la rotazione delle password, non vanno quindi a buon fine. Per ulteriori informazioni,
consultare le note di rilascio di PostgreSQL 16, gli attributi dei ruoli e le autorizzazioni dei ruoli.
Ad esempio, la modifica della password non va a buon fine e viene visualizzato il seguente messaggio:
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.
Prima di eseguire l'aggiornamento, esegui la seguente query come admin. Elenca i ruoli che admin non è in grado di gestire dopo l'aggiornamento, ad eccezione degli utenti creati tramite l'interfaccia utente, la CLI
o l'API. PostgreSQL e 16 e successive, nemmeno admin può modificare tali utenti; è quindi necessario gestirli tramite l'interfaccia utente, la CLI o 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;
Per continuare a gestire un ruolo quotato, assegnarlo a admin prima di eseguire l'aggiornamento:
GRANT <role_name> TO admin WITH ADMIN OPTION;
Questa concessione non va a buon fine per un ruolo il cui valore " member_of_admin " è " t", poiché tale ruolo fa parte di " admin". Dopo l'aggiornamento, admin non è in grado di gestire tale ruolo.
Dopo aver effettuato l'aggiornamento a PostgreSQL 16 o versioni successive, eseguire nuovamente la query. Per ogni ruolo elencato il cui valore di “ member_of_admin ” sia “ f ”, eseguire la seguente procedura mentre
si è connessi a ibmclouddb o a qualsiasi database eccetto postgres. Non includere altri ruoli, poiché il mancato ottenimento di una sovvenzione comporta l'annullamento dell'intero bando. È possibile eseguire l'helper
in tutta sicurezza più di una volta:
SELECT grant_admin_option_to_roles('role1', 'role2', 'role3');
Entrambe le concessioni rendono inoltre admin membro del ruolo, in modo che admin possa usufruire dei privilegi associati al ruolo.