Per risolvere le violazioni dei controlli pre-upgrade, le incompatibilità delle estensioni e gli errori relativi ai limiti delle risorse quando esegui un upgrade della versione principale in loco in AlloyDB per PostgreSQL, applica le correzioni consigliate per i messaggi di errore restituiti dall'operazione di upgrade. Per i passaggi generali di risoluzione dei problemi relativi all'upgrade, consulta Risolvi i problemi relativi a un upgrade della versione principale in loco.
Errori comuni di upgrade della versione principale
Le sezioni seguenti descrivono i messaggi di errore che possono verificarsi durante un upgrade della versione principale e come risolverli.
Errore: Database: database_name. extension_violation: DEPRECATED, action_required: DELETE_EXTENSION
Descrizione: AlloyDB rileva l'estensione deprecata. L'errore indica quali estensioni hanno causato un errore:
database_name. extension_violation: DEPRECATED_EXTENSION, action_required: DELETE_EXTENSION."+" Query format to delete the extensions: `DROP EXTENSION {extension_name}; Violation list: [extensions]
Correzione consigliata: elimina l'estensione. Il formato della query per eliminare un'estensione è DROP EXTENSION {extension_name};.
Errore: Database: database_name. extension_violation: INVALID_EXTENSION_VERSION, action_required: UPGRADE_EXTENSION
Descrizione: AlloyDB rileva una versione dell'estensione non valida.
Correzione consigliata: esegui l'upgrade dell'estensione. Il formato della query per eseguire l'upgrade di un'estensione è ALTER EXTENSION {extension_name} UPDATE TO {target_version};.
Errore: Database: database_name contiene pg_largeobject
Descrizione: AlloyDB rileva pg_largeobject.
Correzione consigliata: rimuovi pg_largeobject prima di eseguire l'upgrade del cluster AlloyDB.
ERROR: out of shared memory
Descrizione: se l'istanza non dispone di memoria condivisa sufficiente, potresti visualizzare questo messaggio di errore. Questo errore è più probabile se hai più di 10.000 tabelle.
Correzione consigliata: prima di avviare un upgrade, imposta il valore del flag max_locks_per_transaction su un valore pari a circa il doppio del numero di tabelle nell'istanza. L'istanza viene riavviata quando modifichi il valore di questo flag.
ERRORE: connessioni insufficienti
Descrizione: se la capacità di connessione dell'istanza è insufficiente, potresti visualizzare questo messaggio di errore.
Correzione consigliata: ti consigliamo di aumentare il valore del flag max_connections in base al numero di database nell'istanza. Quando modifichi il valore di questo flag, l'istanza viene riavviata.
I controlli pre-upgrade non vanno a buon fine
Descrizione: quando esegui l'upgrade del cluster AlloyDB, l'upgrade potrebbe non riuscire a causa dei controlli pre-upgrade. I dettagli sulle violazioni sono
nella risposta dell'API sotto forma di logs_url. Viene visualizzata la pagina della console Google Cloud in cui sono presenti i log.
Correzione consigliata: in base al messaggio di errore, consulta gli altri errori elencati in precedenza in questo documento per risolvere il problema specifico.
Passaggi successivi
- Risolvi i problemi relativi a un upgrade della versione principale in loco.
- Scopri come eseguire l'upgrade della versione principale del database in loco.