Wenn Sie Probleme diagnostizieren und beheben möchten, die während eines direkten Upgrades der Hauptversion Ihres AlloyDB for PostgreSQL-Clusters auftreten, ermitteln Sie die fehlgeschlagene Upgradephase in der Vorgangsantwort und beheben Sie alle Verstöße gegen die Vorabprüfung. Eine detaillierte Anleitung zum Upgrade finden Sie unter Direktes Upgrade der Datenbank-Hauptversion durchführen. Spezifische Fehlermeldungen und Problemumgehungen finden Sie unter Fehler beim direkten Upgrade der Datenbank-Hauptversion.
AlloyDB validiert Ihre Anfrage synchron und gibt eine Fehlermeldung zurück, wenn eine der folgenden Bedingungen zutrifft:
- Die Anfrage ist ungültig. Beispiel: Wenn die angegebene Zielhauptversion nicht unterstützt wird oder kleiner oder gleich der aktuellen Hauptversion ist.
- Die Clusterressourcen befinden sich in einem Zustand, in dem das Upgrade der Hauptversion nicht ausgelöst werden kann. Beispielsweise, wenn der Cluster oder eine der zugehörigen Instanzen nicht den Status
READYhat.
Wenn die Anfrage gültig ist, kann das Upgrade aus folgenden Gründen fehlschlagen:
- Prüfungen vor dem Upgrade, die in verschiedenen Phasen durchgeführt werden, können fehlschlagen, was darauf hindeutet, dass Verstöße erkannt wurden. Sie müssen diese Verstöße beheben, bevor Sie das Upgrade neu starten.
- Interne Fehler bedeuten, dass Sie das Upgrade wiederholen müssen. Wenn die Wiederholungsversuche fehlschlagen, wenden Sie sich an Cloud Customer Care.
Fehler bei der Prüfung vor dem Upgrade von AlloyDB
Fehler bei der Prüfung vor dem Upgrade können in jeder der folgenden Phasen auftreten:
- AlloyDB-Vorabprüfungen (
ALLOYDB_PRECHECK) pg_upgradePrüfung (PG_UPGRADE_CHECK)- Upgrades des primären Clusters (
PRIMARY_INSTANCE_UPGRADE)
Fehler bei der Prüfung vor dem Upgrade sind Probleme, die AlloyDB während der Validierungsphase vor dem Upgrade erkennt und die dazu führen können, dass das direkte Upgrade der Hauptversion fehlschlägt. AlloyDB prüft beispielsweise auf Inkompatibilitäten von Erweiterungen zwischen der aktuellen und der Zielhauptversion.
Fehlermeldungen werden in der Antwort des Upgradevorgangs in logs_url ausgegeben. Sie können diese Logs aufrufen, indem Sie in der Google Cloud Console den Log-Explorer aufrufen. Weitere Informationen finden Sie unter Upgrade-Logs ansehen.
Informationen zu den Fehlern und den entsprechenden Fehlermeldungen, die in den Logs angezeigt werden können, finden Sie unter Fehler beim direkten Upgrade der Datenbank-Hauptversion.
Im Folgenden finden Sie ein Beispiel für die Zusammenfassung, die in den Logs durch die AlloyDB-Vorabprüfungen generiert wird:
Total number of databases checked for custom checks: 3 Total number of databases containing pg_largeobject: 0 Total number of databases containing event triggers permissions issue: 0 Total number of databases containing extensions compatibility violation: 1 Total number of databases containing search path violations: 0
Fehler bei pg_upgrade-Prüfungen
PG_UPGRADE_CHECK prüft mit dem Standarddienstprogramm pg_upgrade auf Verstöße. Diese Upgrade-Prüfung umfasst Dateninkonsistenzen, die sich aus verschiedenen Faktoren ergeben, einschließlich Unterschiede bei versionsspezifischen Datenstrukturen, Änderungen bei der Codierung und Sortierung, Änderungen an Datentypen und Anpassungen am Systemkatalog.
Mehrere Dateien, z. B. tables_with_oids.txt und tables_using_reg.txt, die während pg_upgrade generiert werden, werden in die Logdatei postgres_upgrade exportiert. Sie können diese Dateien mit dem Label labels.FILE_NAME filtern.
Folgende Dateinamen enthalten möglicherweise Fehler, die behoben werden sollten:
| Dateiname | Beschreibung |
|---|---|
|
Diese Datei enthält Tabellen, die mit Objekt-IDs (OIDs) aufgeführt sind. Löschen Sie die Tabellen oder ändern Sie sie so, dass sie keine OIDs verwenden. |
|
Diese Datei enthält Tabellen, die mit vom System definierten zusammengesetzten Typen aufgelistet werden. Löschen Sie die Tabellen oder ändern Sie sie so, dass sie diese zusammengesetzten Typen nicht verwenden. |
|
Diese Datei enthält Tabellen, die mit dem Datentyp UNKNOWN aufgelistet werden. Löschen Sie die Tabellen oder ändern Sie sie so, dass sie diesen Datentyp nicht verwenden. |
|
Diese Datei enthält Tabellen, die mit dem Datentyp SQL_IDENTIFIER aufgelistet werden. Löschen Sie die Tabellen oder ändern Sie sie so, dass sie diesen Datentyp nicht verwenden. |
|
Diese Datei enthält Tabellen, die mit dem Datentyp REG* aufgelistet werden, z. B. REGCOLLATION oder REGNAMESPACE. Löschen Sie die Tabellen oder ändern Sie sie so, dass sie diesen Datentyp nicht verwenden. |
|
Diese Datei enthält Tabellen, die mit postfix-Operatoren (rechts-unär) aufgelistet sind. Löschen Sie die Tabellen oder ändern Sie sie so, dass sie diese Operatoren nicht verwenden. |
pg_upgrade-Fehler
Die Struktur von PG_UPGRADE-Logs ähnelt der Struktur von PG_UPGRADE_CHECK-Logs.
Das folgende Beispiel zeigt ein Protokoll mit dem Label labels.FILE_NAME=pg_upgrade_dump*.log::
pg_upgrade_dump: error: query failed: ERROR: out of shared memory HINT: You might need to increase max_locks_per_transaction.
Nächste Schritte
- Fehler beim direkten Upgrade der Datenbank-Hauptversion
- Direktes Upgrade der Datenbank-Hauptversion durchführen