Upgrade auf eine neue übergeordnete Version durchführen
Wählen Sie einen Upgrade-Pfad:
- In-Place-Upgrade auf eine höhere Hauptversion(IPMVU): Aktualisieren Sie die bestehende Bereitstellung und behalten Sie deren Verbindungszeichenfolgen bei.
- Eine schreibgeschützte Replik aktualisieren: Replizieren Sie Daten in eine separate Bereitstellung, und führen Sie anschließend die Hochstufung und Aktualisierung durch.
- Aus einer Sicherung wiederherstellen: Erstellen Sie anhand einer vorhandenen Sicherung eine Bereitstellung auf einer unterstützten Zielversion.
Bei den letzten beiden Pfaden erhält die neue Bereitstellung keine Änderungen, die nach der Promotion oder nach der Sicherung bei der Quelle eintreffen. Testen und validieren Sie die neue Version zunächst. Stellen Sie vor der endgültigen Umstellung alle Schreibvorgänge an die Quelle ein. Führen Sie anschließend die Replikation durch oder erstellen Sie ein Backup und stellen Sie die Verbindungsdaten Ihrer Anwendung auf die neue Bereitstellung um.
Finden Sie die für neue Bereitstellungen verfügbaren Versionen im Katalogibmcloud cdb deployables-show,
mit oder über die API /deployables.
Ersetzen Sie in den API-Beispielen {region} durch die Region der Bereitstellung, {id} durch den URL-kodierten Cloud Resource Name (CRN) der Bereitstellung und <IAM_TOKEN> durch Ihr IAM-Zugriffstoken
( Identity and Access Management ).
Anforderungen für das Upgrade
Anwendungskompatibilität
Testen Sie den von Ihnen gewählten Upgrade-Pfad vor der Produktionsumstellung in einer repräsentativen Staging-Umgebung. Für eine IPMVU-Probe sollten Sie ein aktuelles Backup auf die ursprüngliche PostgreSQL-Version zurücksetzen. Eine Bereitstellung umfasst zwei oder drei Datenknoten: den Primärknoten und einen oder zwei Hochverfügbarkeitsknoten (HA-Knoten). Skalieren Sie die wiederhergestellte Bereitstellung auf die gleiche Anzahl von Mitgliedern wie in der Produktionsumgebung, da die Konvertierungsphase bei einer größeren Anzahl von HA-Mitgliedern länger dauert. Stellen Sie sicher, dass für die wiederhergestellte Bereitstellung ein vollständiges Backup vorliegt, und führen Sie anschließend das Upgrade auf die gewünschte Zielversion durch. Überprüfen Sie Anwendungsabfragen, Hintergrundjobs, Treiber, Erweiterungen und Verbindungspools. Erfassen Sie die Leistung sowie die Dauer von Lesefehlern und Verbindungsfehlern Ihrer Anwendungen, um diese später vergleichen zu können.
Sehen Sie sich die Versionshinweise für jede Hauptversion nach Ihrer Ausgangsversion bis einschließlich Ihrer Zielversion an. Bitte überprüfen Sie auch die Änderungen an den Rollenberechtigungen.
Bei dem Upgrade werden die Zeitstempel der Commits nicht beibehalten. Nach dem Upgrade werden für NULL jede Transaktion, die vor dem Upgrade abgeschlossen wurde, pg_xact_commit_timestamp() Rückgaben ausgegeben. Wenn
Ihre Anwendungen Commit-Zeitstempel auslesen, kopieren Sie die benötigten Werte vor dem Upgrade in eine Tabellenspalte.
Erweiterungen und andere Objekte
Führen Sie vor dem Upgrade die entsprechenden Vorbereitungen in den folgenden Abschnitten durch. Bereiten Sie für eine IPMVU die Bereitstellung vor, die Sie aktualisieren möchten. Bereiten Sie für die schreibgeschützten Replikate und Wiederherstellungspfade die Quellbereitstellung vor, bevor Sie das Replikat erstellen oder die Sicherung durchführen. Eine schreibgeschützte Replik kann nicht geändert werden, und bei einer Wiederherstellung werden die Daten im Rahmen desselben Vorgangs aktualisiert. Planen Sie eventuelle Anwendungsabhängigkeiten von Objekten ein, die Sie entfernen.
Erweiterungen
pg_repack
pg_repack verhindert kein Upgrade. Sie müssen es weder vor noch nach dem Upgrade löschen oder neu erstellen.
old_snapshot
Das old_snapshot Modul ist in PostgreSQL, Version 17 und höher, nicht verfügbar. Wenn Sie ein Upgrade von PostgreSQL 16 oder
früher auf PostgreSQL 17 oder später durchführen, entfernt IPMVU old_snapshot aus jeder Datenbank, bevor der schreibgeschützte Modus beginnt. Wenn ein Objekt von abhängt old_snapshot, schlägt das Upgrade fehl.
Die Entfernung wird nicht rückgängig gemacht, falls das Upgrade später fehlschlägt.
Falls in einer Datenbank installiert old_snapshot ist, wenden Sie sich vor dem Upgrade an den Support, um abhängige Objekte zu identifizieren. Für die anderen Upgrade-Pfade wenden Sie sich bitte an den Support, um die Entfernung
zu veranlassen.
anon
Wenn Version anon 2 installiert ist, führen Sie diese Schritte in jeder Datenbank durch, in der sie installiert ist. Führen Sie sie als Eigentümer der maskierten Tabellen aus, z. B. admin. Bei einer IPMVU führt
anon Version 2 dazu, dass das Upgrade während der Konvertierungsphase fehlschlägt, während die Datenbank nicht verfügbar ist, und jeder erneute Versuch schlägt auf dieselbe Weise fehl. Bei Version anon 3 sind
diese Schritte nicht erforderlich. Die Selbsttestabfrage 10 zeigt die installierte Version in extversion. an.
Bevor Sie die Maskierungsregeln entfernen, sperren Sie den Datenbankzugriff für die maskierten Rollen, die ausschließlich maskierte Daten einsehen dürfen. Sperren Sie den Zugriff so lange, bis Sie die Maskierungsregeln und Rollenbezeichnungen nach dem Upgrade wiederhergestellt und überprüft haben.
-
Notieren Sie sich die Maskierungsregeln und die maskierten Rollen, damit Sie diese nach dem Upgrade wiederherstellen können.
SELECT objtype, objname, label FROM pg_catalog.pg_seclabels WHERE provider = 'anon'; -
Alle Maskierungsregeln entfernen.
SELECT anon.remove_masks_for_all_columns(); -
Entfernen Sie die maskierte Bezeichnung aus jeder in Schritt 1 aufgeführten Rolle. Ab PostgreSQL 16 erfordert diese Aktion die Option
ADMINfür die Rolle. Weitere Informationen finden Sie unter Probleme mit Rollenberechtigungen bei Versions-Upgrades.SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL; -
Lassen Sie die Erweiterung
anonmit der Option "Kaskade" weg. Die Option cascade entfernt auch Objekte, die von abhängenanon, wie beispielsweise Maskierungsansichten und Funktionen. Notieren Sie deren Definitionen, damit Sie sie nach dem Upgrade wiederherstellen können.DROP EXTENSION anon CASCADE; -
Aktivieren Sie nach dem Upgrade die Funktion erneut
anon, wenden Sie die gespeicherten Maskierungsregeln und Rollenbezeichnungen erneut an und überprüfen Sie die Maskierung, bevor Sie den Zugriff für die maskierten Rollen wiederherstellen.
PostGIS
Wenn Sie PostGIS, verwenden, aktualisieren Sie es in jeder Datenbank, die es nutzt, bevor Sie PostgreSQL: aktualisieren:
SELECT postgis_extensions_upgrade();
Überprüfen Sie die Version der Erweiterung:
SELECT postgis_full_version();
earthdistance
Ein IPMVU schlägt während der Konvertierungsphase fehl, wenn ein Index oder eine gespeicherte generierte Spalte eine Funktion der Version earthdistance 1.1 verwendet, wie z. B. ll_to_earth(). Dies gilt auch, wenn
das Objekt diese über eine eigene SQL-Funktion nutzt. PostgreSQL 14 und 15 bieten nur Version 1.1 an. Führen Sie in jeder Datenbank die Selbstprüfungsabfrage 13 durch und bearbeiten Sie anschließend
jedes aufgeführte Objekt:
-
Unter PostgreSQL, Version 16 oder 17, aktualisieren Sie die Erweiterung, bevor Sie das Upgrade durchführen:
ALTER EXTENSION earthdistance UPDATE; -
Wenn es sich
used_functionbei einer Ihrer eigenen Funktionen in PostgreSQL 14 oder 15 um handelt, fügen Sie ihr die Einstellungsearch_pathhinzu:ALTER FUNCTION <used_function> SET search_path = ibm_extension, pg_catalog; -
Wenn es sich
used_functionbei einer Funktionearthdistancein PostgreSQL, Version 14 oder 15, um eine handelt, löschen Sie den aufgeführten Index, bevor Sie das Upgrade durchführen. Um die Werte einer generierten Spalte beizubehalten, wandeln Sie diese mit in eine reguläre Spalte umALTER TABLE <table_name> ALTER COLUMN <column_name> DROP EXPRESSION;. Führen Sie nach dem Upgrade den Befehl ausALTER EXTENSION earthdistance UPDATE;und erstellen Sie anschließend die entfernten Elemente neu. Wenn Ihre Zielversion PostgreSQL 15 ist, hat das Update keine Auswirkungen, und die Objekte, die Sie neu erstellen, blockieren Ihr nächstes Upgrade auf dieselbe Weise. Um dies zu vermeiden, führen Sie ein Upgrade auf PostgreSQL 16 oder höher durch.
pgRouting
Wenn Ihre Bereitstellung PostgreSQL 16 oder 17 ausführt und Sie ein Upgrade auf PostgreSQL 18 durchführen, überprüfen Sie jede Datenbank, auf der installiert ist pgRouting. Bei PostgreSQL-18-Bereitstellungen ist die Bibliothek
pgRouting 3.5 nicht enthalten. Ein IPMVU-Aufruf an PostgreSQL 18 scheitert an den Kompatibilitätsprüfungen, noch bevor der schreibgeschützte Modus beginnt, solange eine Funktion diese Bibliothek nutzt. Keine Zeilen erwarten:
SELECT DISTINCT p.probin
FROM pg_catalog.pg_proc AS p
WHERE p.probin = '$libdir/libpgrouting-3.5';
Wenn die Abfrage eine Zeile zurückgibt, aktualisieren Sie auf pgRouting die neueste Version, die Ihre Bereitstellung vor dem Upgrade bereitstellt, und führen Sie die Abfrage anschließend erneut aus:
ALTER EXTENSION pgrouting UPDATE;
pgRouting In Version 4.0 wurden mehrere Funktionen wie pgr_createTopology, pgr_analyzeGraph, und entfernt pgr_nodeNetwork und andere geändert. Testen Sie Ihre Anwendungen zunächst mit
Version 4.0 in pgRouting einer Staging-Umgebung. Falls die entfernten Funktionen benötigt werden, wenden Sie sich bitte an den Support, bevor Sie ein Upgrade auf PostgreSQL 18 durchführen. Ab PostgreSQL 16 können Sie auch
ein Upgrade auf PostgreSQL 17 durchführen, das die 3.5-Bibliothek enthält.
SQL-Funktionen in Indizes, Partitionsschlüsseln und generierten Spalten
Während der Konvertierungsphase erstellt eine IPMVU die Definition jedes Indexes, jedes Partitionsschlüssels und jeder gespeicherten generierten Spalte mit einem leeren Suchpfad neu. Dieser Schritt schlägt fehl, wenn eines dieser Objekte
eine Funktion LANGUAGE sql mit einem String-Körper verwendet, der ein Objekt außerhalb pg_catalog ohne dessen Schema benennt – entweder direkt oder über eine Domänenprüfungsbeschränkung. Erweiterte Statistiken
haben denselben Effekt auf eine Tabelle, die einen Fremdschlüssel enthält. In einem Index schlägt auch ein Aufruf fehl, der das Schema ibm_extension angibt, in dem Erweiterungen installiert sind. Der Fehler tritt auf, während
die Datenbank nicht verfügbar ist, und jeder erneute Versuch schlägt auf dieselbe Weise fehl.
Führen Sie in jeder Datenbank die Selbstprüfungsabfrage 12 aus. Fügen Sie für jede aufgeführte Funktion eine Einstellung search_path hinzu, die alle Schemata auflistet, die ihr Hauptteil
verwendet. Alternativ können Sie den String-Text durch einen SQL-Standardtext ersetzen. Führen Sie diese Anweisungen als Eigentümer der Funktion aus. Zum Beispiel:
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);
Behalten Sie die Ergebnisse und sonstigen Attribute jeder Funktion unverändert bei, da Indizes und generierte Spalten deren Ergebnisse speichern und partitionierte Tabellen die Zeilen anhand dieser Ergebnisse weiterleiten. Bei einer bestimmten
Einstellung search_path erweitert PostgreSQL die Funktion nicht mehr in die Abfragen, die sie aufrufen, sodass diese Abfragen langsamer sein können. Ein SQL-Standard-Body schützt die von ihm aufgerufenen String-Body-Funktionen
nicht; korrigieren Sie daher auch diese Funktionen. Führen Sie die Abfrage so lange erneut aus, bis keine Zeilen mehr zurückgegeben werden. Wenn darin eine Funktion aufgeführt ist, über die Sie nicht verfügen, wenden Sie sich vor dem Upgrade
an den Support.
Wenn Sie ein Upgrade von PostgreSQL 16 oder früher auf PostgreSQL 17 oder später durchführen, führen Sie zusätzlich die Selbstprüfungsabfrage 17 aus. PostgreSQL, Version 17 und höher, führen
Wartungsbefehle mit einem eingeschränkten Suchpfad aus. Eine Funktion in einer beliebigen Sprache, die von einem Index, einer materialisierten Ansicht oder erweiterten Statistiken verwendet wird, benötigt dann eine eigene search_path Einstellung. Andernfalls schlagen REFRESH MATERIALIZED VIEW nach dem Upgrade, ANALYZE, REINDEX, CLUSTER``VACUUM FULL, und für die betroffenen Objekte fehl. Legen Sie den Suchpfad für
jede der aufgeführten Funktionen fest, die Objekte ohne deren Schema benennen, wie im vorherigen Beispiel. Weitere Informationen finden Sie in den Migrationshinweisen zu PostgreSQL 17.
Objekte, die entfernte Systemnamen verwenden
Mit jeder Hauptversion werden einige Spalten des Systemkatalogs, Funktionen und Konfigurationsparameter entfernt oder umbenannt. Beispielsweise wurden in PostgreSQL 17 die Checkpoint-Spalten aus entfernt pg_stat_bgwriter, und
in PostgreSQL 16 wurde der Parameter force_parallel_mode in umbenannt debug_parallel_query. Die Vorabprüfungen erkennen keine Objekte, die diese Namen verwenden:
- Wenn eine Ansicht, eine materialisierte Ansicht oder ein Aggregat einen entfernten Namen verwendet, schlägt ein IPMVU während der Konvertierungsphase fehl. Eine Funktion mit einem SQL-Standardkörper und eine Funktion, Rolle oder Datenbankeinstellung eines entfernten Parameters haben denselben Effekt.
- Andere Funktionen und Prozeduren, Jobs
pg_cronsowie Anwendungsabfragen, die einen entfernten Namen verwenden, schlagen fehl, wenn sie zum ersten Mal in der neuen Version ausgeführt werden. Dies kann geschehen, bevor die Schreibvorgänge wieder aufgenommen werden.
Führen Sie in jeder Datenbank die Selbstprüfungsabfrage 14 aus. Ändern oder entfernen Sie jedes aufgeführte Objekt, dessen removed_in Version Ihrer Zielversion entspricht oder darunter
liegt. Überprüfen Sie die Rollen- und Datenbankeinstellungen mit der Selbstprüfungsabfrage 7. Testen Sie Ihre Anwendungs- und Überwachungsabfragen in einer Staging-Umgebung der Zielversion.
Logische Replikationsslots
IPMVU scheitert an seinen Vorabprüfungen, solange logische Replikationsslots vorhanden sind, einschließlich inaktiver Slots und Slots, die genutzt wal2json werden. Ein gelöschter Slot kann nicht wiederhergestellt werden, und
ein neuer Slot enthält nicht die Änderungen, die im alten Slot gespeichert waren. Bevor Sie das Upgrade durchführen:
-
Erfassen Sie den Namen, das Plug-in und die Datenbank jedes Slots mit der Selbstprüfungsabfrage 2.
-
Halten Sie das Schreiben in die Quelle an, bis Sie die Verbraucher nach dem Upgrade wiederhergestellt haben oder die Nachsynchronisierung der nachgelagerten Daten planen.
-
Lassen Sie die Nutzer anstehende Änderungen bearbeiten und anschließend abbrechen. Lassen Sie sie angehalten, wobei die automatische Wiederverbindung deaktiviert ist, bis der Vorgang den Status Abgeschlossen anzeigt.
-
Löschen Sie jeden Slot mit dem Befehl
ibmcloud cdb postgresql replication-slot-deleteoder der API Delete a logical replication slot. Der Benutzeradminkann Replikationsslots nicht mit SQL löschen.ibmcloud cdb postgresql replication-slot-delete <NAME|CRN> <SLOT_NAME> -
Erstellen Sie nach dem Upgrade die Slots neu, wie in beschrieben Konfigurieren
wal2json.
wal2json ist ein Plug-in zur logischen Dekodierung, keine Erweiterung, die Sie mit erstellen CREATE EXTENSION.
Logische Abonnements
Ein logisches Abonnement empfängt Änderungen von einem Herausgeber. Sein Replikations-Slot befindet sich auf dem Publisher, daher wird er bei der Slot-Abfrage nicht aufgeführt.
Wenn Ihre Bereitstellung mit PostgreSQL 16 oder einer früheren Version läuft, schlägt die Vorabprüfung von IPMVU fehl, solange logische Abonnements vorhanden sind, einschließlich deaktivierter Abonnements. Bei Upgrades von diesen Versionen
bleibt der Synchronisationsstatus eines Abonnements nicht erhalten. Bevor Sie das Upgrade durchführen, vereinbaren Sie mit dem Eigentümer des Herausgebers, wie die einzelnen Abonnements entfernt und neu angelegt werden und wie die Daten
neu synchronisiert werden sollen. Löschen Sie anschließend die Abonnements mithilfe der Abonnentenfunktionen. Die Funktion
delete_subscription gibt zudem den Slot des Abonnements an den Publisher zurück und schlägt fehl, wenn der Publisher nicht erreichbar ist oder der Slot nicht mehr existiert. Führen Sie in diesem Fall zuerst und disable_subscription dann subscription_slot_none vor aus delete_subscription. Bitten Sie anschließend den Eigentümer des Publishers, den Slot zu löschen, da dadurch weiterhin Transaktionsprotokolle auf dem Publisher gespeichert werden.
Wenn Ihre Bereitstellung mit PostgreSQL 17 oder höher läuft, können Abonnements bestehen bleiben, müssen jedoch die Anforderungen für das Upgrade der logischen Replikation der Zielversion erfüllen. Das Upgrade unterstützt maximal 10 Abonnements. Bei einer größeren Anzahl scheitert es an den Kompatibilitätsprüfungen, noch bevor der schreibgeschützte Modus beginnt. Deaktivieren Sie
die Abonnements vor disable_subscription dem Upgrade mit und aktivieren Sie sie enable_subscription nach Abschluss des Upgrades mit.
UNLOGGED Tabellen und Abläufe
PostgreSQL schreibt Änderungen an Tabellen UNLOGGED und Sequenzen nicht in das Transaktionsprotokoll. Es repliziert sie nicht an andere Mitglieder und setzt sie nach einem Failover oder einer Wiederherstellung zurück. Bei keinem
der Upgrade-Pfade bleiben die Inhalte erhalten:
- Eine IPMVU setzt diese zurück, wenn sie PostgreSQL mit der neuen Version neu startet, und erneut, wenn sie in der Abschlussphase die Primärrolle wechselt. Ein fehlgeschlagenes Upgrade kann diese ebenfalls zurücksetzen.
- Eine hochgestufte schreibgeschützte Replik und ein wiederhergestelltes Backup beginnen mit leeren
UNLOGGEDTabellen und zurückgesetztenUNLOGGEDSequenzen.
Nach dem Upgrade sind die Tabellen UNLOGGED leer und die Sequenzen UNLOGGED werden zurückgesetzt. Solange die Aufgabe nicht als Abgeschlossen angezeigt wird, können alle Änderungen, die Sie an diesen
Objekten vornehmen, ebenfalls verloren gehen. Verwenden Sie vor dem Upgrade die Selbstprüfungsabfrage 11, um diese Objekte in jeder Datenbank zu identifizieren und zu planen, wie mit jedem
einzelnen verfahren werden soll.
- Um den Inhalt einer Tabelle beizubehalten, konvertieren Sie sie mit
ALTER TABLE <table_name> SET LOGGED;. konvertiert auchSET LOGGEDdie Indizes der Tabelle und die zugehörigen Sequenzen. Konvertieren Sie eine referenzierte Tabelle, bevor Sie Tabellen konvertieren, die über Fremdschlüssel auf diese verweisen. Alternativ können Sie die Inhalte exportieren und neu laden, sobald die Aufgabe den Status Abgeschlossen anzeigt. - Wenn eine Sequenz Werte für eine protokollierte Tabelle generiert, konvertieren Sie diese mit
ALTER SEQUENCE <sequence_name> SET LOGGED;. Andernfalls beenden Sie die Anwendungen, die diese Funktion nutzen, bis der Vorgang den Status Abgeschlossen anzeigt. Stellen Sie den Wert anschließend mithilfe der Funktionsetvalauf einen Wert ein, der über dem höchsten verwendeten Wert liegt.
SET LOGGED schreibt die Tabelle neu und sperrt Lese- und Schreibvorgänge, bis der Vorgang abgeschlossen ist. Außerdem erzeugt sie ungefähr so viele Transaktionsprotokolldaten, wie die Tabelle und ihre Indizes Speicherplatz beanspruchen.
Konvertieren Sie umfangreiche Tabellen rechtzeitig vor der Durchführung des Upgrades und verwenden Sie die Selbstprüfungsabfrage 5, um zu überprüfen, ob die Transaktionsprotokolle archiviert wurden. Nach dem Upgrade können Sie eine Tabelle
mit ALTER TABLE <table_name> SET UNLOGGED;. wieder zurückkonvertieren.
Bei einem IPMVU führt eine Tabelle UNLOGGED – selbst wenn sie leer ist – dazu, dass der Dienst jedes HA-Mitglied neu aufbaut, wodurch sich die Dauer der Schreibsperre verlängert. Weitere Informationen finden Sie unter Verfügbarkeit während eines Upgrades.
Um diesen Neuaufbau zu vermeiden, konvertieren Sie alle UNLOGGED Tabellen oder löschen Sie diejenigen, die Sie nicht mehr benötigen. TRUNCATE verhindert den Neuaufbau nicht. Sequenzen UNLOGGED führen
nicht zu einem Neuaufbau. Bei PostgreSQL 16 und 17 ist SET LOGGED an sich bereits eine Massenoperation, die dennoch einen Neuaufbau verursachen kann; planen Sie daher einen solchen ein.
In-Place-Upgrade auf eine neue Hauptversion
Führen Sie zunächst die Vorbereitungen durch und nutzen Sie anschließend die unten aufgeführte Vorgehensweise über die Benutzeroberfläche, die API, die CLI oder Terraform.
In einer IPMVU führt der Dienst das Upgrade des Primärservers vor Ort durch und aktualisiert jedes HA-Mitglied anhand seiner vorhandenen Datendateien. Wenn alle HA-Mitglieder ihre Datendateien wiederverwenden können, werden Schreibvorgänge nur kurzzeitig blockiert. Die Dauer hängt in erster Linie von der Anzahl der Datenbankobjekte und dem Ausmaß der Datenbankaktivität ab und weniger von der Menge der gespeicherten Daten.
Unter bestimmten Umständen kopiert der Dienst stattdessen die gesamte Datenbank auf die HA-Mitglieder, wodurch Schreibvorgänge wesentlich länger blockiert bleiben. Andere Bedingungen führen dazu, dass das Upgrade fehlschlägt, nachdem Schreibvorgänge blockiert wurden. Die Vorabprüfungen erkennen diese Probleme nicht. Beheben Sie sie daher, bevor Sie das Upgrade einreichen. Eine Liste finden Sie unter Bedingungen, die von den Vorabprüfungen nicht erkannt werden.
Sie können eine IPMVU nach dem Absenden nicht mehr stornieren, und Sie können die bestehende Bereitstellung nicht auf eine niedrigere Version zurücksetzen. Der Dienst führt vor dem Upgrade keine Datensicherung durch. Erstellen und überprüfen Sie daher zunächst eine On-Demand-Sicherung.
Verfügbarkeit während eines Upgrades
Eine IPMVU durchläuft die folgenden Phasen. Schreibvorgänge werden unterbrochen, sobald die schreibgeschützte Phase beginnt, und werden fortgesetzt, sobald der Dienst den schreibgeschützten Modus aufhebt. Auch während der Umstellungsphase sind keine Lesezugriffe möglich.
| Phase | Was passiert | Lesevorgänge | Schreibvorgänge |
|---|---|---|---|
| Prüfungen | Der Dienst wartet, bis ausstehende Bereitstellungsänderungen abgeschlossen sind, und führt anschließend die Vorabprüfungen durch. Es überprüft die Upgrade-Kompatibilität auf dem Primärserver und den HA-Mitgliedern und setzt das automatische Failover aus. | Verfügbar | Verfügbar |
| Schreibgeschützt | Der Dienst macht neue Transaktionen in jeder Datenbank schreibgeschützt und beendet alle Client-Sitzungen. Anschließend wartet es darauf, dass die HA-Mitglieder und die Archivierung des Transaktionsprotokolls aufholen. | Verfügbar | Geblockt |
| Konvertierung | Der Dienst beendet PostgreSQL-Instanzen auf allen Knoten und führt ein Upgrade des Primärknotens durch. Soweit möglich, wird jedes HA-Mitglied anhand der vorhandenen Datendateien dieses Mitglieds aktualisiert. | Nicht verfügbar | Nicht verfügbar |
| Erneut starten | Der aktualisierte Primärserver startet im schreibgeschützten Modus, und die HA-Mitglieder werden gestartet. Der Dienst erstellt jedes Mitglied neu, das seine Datendateien vom aktualisierten Primärserver nicht wiederverwenden kann. | Verfügbar | Geblockt |
| Verfasst Lebensläufe | Der Dienst hebt den schreibgeschützten Modus auf und beendet erneut alle Client-Sitzungen. | Verfügbar | Verfügbar |
| Abschluss | Der Dienst wartet, bis alle HA-Mitglieder den Rückstand aufgeholt haben. Anschließend startet der Dienst die Komponenten nacheinander neu, um die Umstellung der Bereitstellung auf die neue Version abzuschließen. Vor dem Neustart des Primärservers überträgt der Dienst die Primärrolle auf ein anderes Mitglied, wodurch Client-Sitzungen beendet werden. Der Dienst entfernt anschließend die Upgrade-Dateien, stellt die Sicherung nach dem Upgrade in die Warteschlange und markiert die Aufgaben als Abgeschlossen. | Verfügbar, außer während der Umstellung | Verfügbar, außer während der Umstellung |
Schreibt den Lebenslauf, nachdem mindestens ein HA-Mitglied den Rückstand aufgeholt hat und jedes zweite HA-Mitglied den Rückstand aufgeholt hat oder gerade wiederhergestellt wird. Der Dienst baut ein HA-Mitglied, das seine Datendateien nicht wiederverwenden kann, neu auf, indem er die gesamte Datenbank darauf kopiert. Wenn jedes HA-Mitglied neu aufgebaut werden muss, bleiben Schreibvorgänge blockiert, bis der erste Neuaufbau abgeschlossen ist. Bei einer großen Datenbank kann dies mehrere Stunden dauern. Eine Bereitstellung mit zwei Datenknoten – dies ist die Standardkonfiguration – verfügt nur über einen HA-Knoten. Infolgedessen blockiert jeder Neuaufbau Schreibvorgänge. HA-Mitglieder können ihre Datendateien in den folgenden Situationen nicht wiederverwenden:
- Jede Datenbank enthält eine Tabelle
UNLOGGED, selbst wenn diese leer ist. Der Dienst baut anschließend jedes HA-Mitglied neu auf. Überprüfen Sie dies mit der Selbsttestabfrage 11 und sehen Sie sich die TabellenUNLOGGEDund Sequenzen an. - Die Bereitstellung läuft unter PostgreSQL 16 oder 17, und die Tabellen sind durch Massenoperationen oder zahlreiche gleichzeitige Einfügungen oder Aktualisierungen gewachsen. Zu den Massenoperationen gehören die Befehle
ALTER TABLECOPY,pg_restore,CREATE TABLE AS,CREATE MATERIALIZED VIEW,REFRESH MATERIALIZED VIEW, und, die eine Tabelle umschreiben, wie beispielsweiseSET LOGGED. Da Sie dies nicht im Voraus überprüfen können, sollten Sie einen Neuaufbau einplanen.
Der Dienst kann HA-Mitglieder auch aus anderen Gründen neu aufbauen, die Sie nicht im Voraus überprüfen können. Bei einem Testlauf auf einer Staging-Umgebung, die Sie aus einem Backup wiederherstellen, wird ein solcher Wiederaufbau möglicherweise nicht angezeigt.
Ein HA-Mitglied, das gerade neu aufgebaut wird, behält seine bisherigen Datendateien bei, bis der Vorgang abgeschlossen ist. Daher benötigt es freien Speicherplatz, der mindestens der Größe des von seinen Daten belegten Speicherplatzes entspricht. Bevor Sie das Upgrade einreichen, stellen Sie sicher, dass jedes Datenelement deutlich weniger als die Hälfte seines verfügbaren Speicherplatzes belegt. Überprüfen Sie diesen Wert anhand der Kennzahl belegter Speicherplatz. Obwohl die Vorabprüfung des Festplattenspeichers eine Auslastung von bis zu 90 % zulässt, benötigt ein HA-Mitglied, das neu aufgebaut wird, deutlich mehr freien Speicherplatz. Andernfalls kann es vorkommen, dass beim Neuaufbau der Speicherplatz auf der Festplatte knapp wird und der Vorgang wiederholt fehlschlägt. Schreibvorgänge können dann stundenlang blockiert bleiben, bevor die Aufgabe fehlschlägt. Die automatische und manuelle Skalierung der Festplatte wird erst nach Abschluss des Upgrades durchgeführt. Skalieren Sie die Festplatte daher, bevor Sie das Upgrade starten. Ein langwieriger Neuaufbau kann ebenfalls dazu führen, dass die Aufgabe nach der Wiederaufnahme der Schreibvorgänge fehlschlägt. In beiden Fällen läuft die Bereitstellung mit der Zielversion, bis der Support das Upgrade abgeschlossen hat. Planen Sie in Ihrem Wartungsfenster Zeit für einen Neustart ein.
Der Lebenslauf wird verfasst, bevor die Aufgabe abgeschlossen ist. Um zu überprüfen, ob der Schreibvorgang wieder aufgenommen wurde, führen Sie in SHOW default_transaction_read_only; einer neuen Sitzung aus. Der Wert wird zurückgegeben,
off sobald die Schreibvorgänge wieder aufgenommen werden. Client-Sitzungen enden, wenn der schreibgeschützte Modus beginnt, wenn PostgreSQL für die Konvertierung angehalten wird, wenn Schreibvorgänge wieder aufgenommen werden,
während der Umschaltung in der Abschlussphase und wenn der Dienst nach einem Ausfall den Schreibzugriff wiederherstellt.
Solange die Aufgabe nicht den Status Abgeschlossen aufweist, sollten Sie anhaltende Massen-Schreibvorgänge wie große Datenladungen oder Batch-Jobs vermeiden. Die Abschlussphase wartet, bis jedes HA-Mitglied alle Änderungen wiederhergestellt hat. Bei einer anhaltend hohen Schreiblast kann es zu einem Timeout dieser Wartezeit kommen, und die Aufgabe schlägt dann fehl, sobald die Schreibvorgänge wieder aufgenommen werden. Das Risiko ist höher, solange ein HA-Mitglied noch neu aufgebaut wird. Bei der Bereitstellung wird dann die Zielversion ohne eine Sicherung nach dem Upgrade ausgeführt, und der Support muss das Upgrade abschließen.
Um zu überprüfen, ob Ihre Schreiblast es den HA-Mitgliedern ermöglicht, den Rückstand aufzuholen, führen Sie zum geplanten Upgrade-Zeitpunkt die folgende Abfrage aus. Wiederholen Sie dies einige Minuten lang jede Sekunde, zum Beispiel mit
dem Befehl psql \watch 1. Der Dienst erfordert, dass alle HA-Mitglieder gleichzeitig replay_lag_bytes 0 in erscheinen. Sollte dies nicht der Fall sein, reduzieren Sie die Schreiblast, bevor
Sie das Upgrade durchführen.
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;
Das Upgrade aktualisiert die Optimierungsstatistiken nicht, sodass Abfragen möglicherweise langsame Ausführungspläne wählen, bis Sie den Befehl ausführen ANALYZE. Bei Upgrades auf PostgreSQL 15, 16 oder 17 werden keine Statistiken
übertragen. Bei Upgrades auf PostgreSQL 18 werden die meisten Statistiken übertragen, jedoch keine erweiterten Statistiken, die Sie mit erstellt haben CREATE STATISTICS, oder Statistiken, die von Erweiterungen wie PostGIS erfasst
werden. Der autovacuum Prozess analysiert eine Tabelle erst, nachdem genügend Schreibvorgänge stattgefunden haben, und analysiert niemals partitionierte Tabellen. Warten Sie nicht, bis die Task abgeschlossen ist. Sobald zurückkehrt
SHOW default_transaction_read_only;``off, aktualisieren Sie die Statistiken wie unter Nach dem Upgrade beschrieben.
Der schreibgeschützte Modus legt eine Standardeinstellung für neue Transaktionen fest. Die Datenbank wird dabei nicht gesperrt. Eine Sitzung off, die default_transaction_read_only auf gesetzt wird oder explizit eine
Lese-Schreib-Transaktion startet, kann weiterhin schreiben. Das gilt auch für eine Rolle, deren eigenes default_transaction_read_only Umfeld … ist off. Wartungsbefehle wie VACUUM, ANALYZE,
REINDEX, und werden ebenfalls CLUSTER weiterhin ausgeführt. Der schreibgeschützte Modus stoppt weder einen bereits laufenden Job pg_cron noch ein aktiviertes Abonnement unter PostgreSQL 17. Solche Schreibvorgänge
können dazu führen, dass das Upgrade fehlschlägt. Bevor Sie das Upgrade ausführen, beenden Sie alle Prozesse, die den schreibgeschützten Modus außer Kraft setzen. Halten Sie geplante Jobs an, die Wartungsbefehle schreiben oder ausführen,
wie z. B. Jobs pg_cron, und warten Sie, bis laufende Jobs abgeschlossen sind. Führen Sie diese Schritte wie unter Nach dem Upgrade beschrieben durch.
Lesevorgänge können auch im schreibgeschützten Modus Transaktionsprotokolle erstellen, beispielsweise wenn Abfragen nach einem Massenladevorgang oder einer umfangreichen Aktualisierung zum ersten Mal Zeilen lesen. Dieser Vorgang verzögert
den Nachholvorgang, auf den die schreibgeschützten und die Neustartphasen warten, sodass Schreibvorgänge länger blockiert bleiben und das Upgrade fehlschlagen kann. Führen Sie vor dem Übermitteln des Upgrades auf VACUUM Tabellen
aus, die Sie kürzlich geladen oder erheblich geändert haben.
Wenn der Dienst eine Sitzung beendet, erhält ein Client, der eine direkte Verbindung zur Bereitstellung herstellt, den SQLSTATE ( 57P01``admin_shutdown ). Ein Schreibvorgang in einer schreibgeschützten Transaktion schlägt mit
dem SQLSTATE 25006 (read_only_sql_transaction) fehl. Während der Konvertierungsphase kann eine neue Verbindung mit einem Authentifizierungsfehler wie beispielsweise dem SQLSTATE fehlschlagen 28P01,
obwohl Ihre Anmeldedaten unverändert sind. Versuchen Sie die Verbindung nach der Konvertierung erneut. Sollten diese Fehler weiterhin auftreten, nachdem die Aufgabe den Status Fehlgeschlagen anzeigt, wenden Sie sich bitte
an den Support. Über einen Verbindungspooler können Anwendungen andere Verbindungsfehler erkennen.
Clients, die nur Lese-Schreib-Sitzungen akzeptieren, können keine Verbindung herstellen, solange der schreibgeschützte Modus aktiviert ist; daher stehen ihnen auch Lesezugriffe nicht zur Verfügung, bis das Schreiben wieder möglich ist. Dies
gilt für Clients libpq, die setzen target_session_attrs=read-write, sowie für JDBC-Clients, die targetServerType=primary oder setzen master. Um die Lesbarkeit zu gewährleisten, verwenden
Sie target_session_attrs=any, oder primary mit 14 libpq oder höher. Verwenden Sie für JDBC targetServerType=any.
Anwendungen müssen Verbindungsfehler und Lesefehler behandeln, die Verbindung erneut herstellen und unterbrochene Transaktionen nur dann wiederholen, wenn dies sicher ist. Das Connection-Pooling hebt diese Anforderungen nicht auf. Der Zugriff auf die Anwendung ist kein Nachweis dafür, dass die Upgrade-Aufgabe abgeschlossen wurde.
Sicherungen und Wiederherstellung
Der Dienst führt vor dem Upgrade keine Datensicherung durch. Erstellen und überprüfen Sie vor dem IPMVU ein aktuelles On-Demand-Backup. Um nach einem Upgrade zur Quellversion zurückzukehren, stellen Sie eine vor dem Upgrade erstellte Sicherung oder einen Wiederherstellungspunkt in einer neuen Bereitstellung wieder her, auf der die Quellversion ausgeführt wird. Legen Sie die Version ausdrücklich fest, da eine zeitpunktbezogene Wiederherstellung ohne Angabe einer Version zu einer Bereitstellung führt, auf der die aktuelle Version ausgeführt wird. Diese Option setzt voraus, dass die Quellversion für neue Bereitstellungen weiterhin verfügbar ist. Berücksichtigen Sie dabei die seitdem vorgenommenen Änderungen.
Nach einem erfolgreichen Upgrade stellt der Dienst eine Sicherungskopie der aktualisierten Bereitstellung bereit. Die Datensicherung wird nach Abschluss der Upgrade-Aufgabe separat ausgeführt und startet möglicherweise nicht sofort. Bei dieser ersten Sicherung in der neuen Version wird die gesamte Datenbank kopiert, sodass dies bei einer großen Datenbank mehrere Stunden dauern kann. Überprüfen Sie den Status unter Backups und Wiederherstellung. Sollte dies fehlschlagen, erstellen Sie ein On-Demand-Backup und wenden Sie sich an den Support, falls die Fehler weiterhin auftreten. Ein Fehler bei der Datensicherung führt nicht zu einer Rücknahme des Upgrades.
Die Point-in-Time-Wiederherstellung (PITR) kann Transaktionen über ein Upgrade auf eine neue Hauptversion hinweg nicht wiederherstellen. Sie können eine Wiederherstellung zu einem Zeitpunkt vor dem Start der Upgrade-Aufgabe oder nach Abschluss der ersten Sicherung der aktualisierten Bereitstellung durchführen. Wiederherstellungen zu Wiederherstellungspunkten, die zwischen dem Upgrade und dem Abschluss der Sicherung nach dem Upgrade liegen, werden nicht unterstützt. Der Dienst lehnt einige dieser Wiederherstellungspunkte ab, während die Wiederherstellung auf andere zwar akzeptiert wird, aber während des Wiederherstellungsprozesses fehlschlägt. Dieser nicht unterstützte Zeitraum umfasst die Zeit nach der Wiederaufnahme der Schreibvorgänge. Bis zum Abschluss der Sicherung nach dem Upgrade kann die Wiederherstellung zum neuesten verfügbaren Wiederherstellungspunkt ebenfalls fehlschlagen, selbst wenn der Dienst die Wiederherstellungsanforderung akzeptiert.
Um die PITR-Abdeckung für Änderungen nach dem Upgrade aufrechtzuerhalten, sollten Sie das Schreiben in Anwendungen so lange aussetzen, bis die Sicherung nach dem Upgrade abgeschlossen ist. Binden Sie diese in Ihre Anwendungen ein. Wenn Schreibvorgänge
wieder aufgenommen werden, wird das Upgrade default_transaction_read_only in jeder Datenbank zurückgesetzt, sodass eine Schreibschutz-Einstellung auf Datenbankebene die Schreibvorgänge nicht weiterhin unterbricht.
Ein fehlgeschlagenes Upgrade führt nicht dazu, dass ein Backup in die Warteschlange gestellt wird. PITR ist möglicherweise für Zeiträume zwischen dem Beginn des Versuchs und der nächsten abgeschlossenen Sicherung nicht verfügbar. Wenn nach
einem fehlgeschlagenen Upgrade die Quellversion gemeldet SHOW server_version; wird und die Bereitstellung Schreibvorgänge akzeptiert, erstellen Sie eine On-Demand-Sicherung. Andernfalls wenden Sie sich bitte an den Support,
bevor Sie eine Sicherung durchführen oder andere Änderungen vornehmen.
Sicherungen und Wiederherstellungspunkte vor dem Upgrade gehören zur früheren Version und unterliegen weiterhin den Aufbewahrungsfristen. Weitere Informationen finden Sie unter PITR.
Die Optionen zum Überspringen von Backups werden für PostgreSQL: skip_backup in der API, --skip-backup in der CLI und version_upgrade_skip_backup in Terraform nicht unterstützt. Anfragen, die zu deren
Scheitern führen. Die API und die CLI geben einen Fehler zurück, und die Terraform-Pläne schlagen fehl.
Vorbereitende Schritte
Wenden Sie diese Anforderungen sowohl auf die Staging- als auch auf die Produktionsumgebung an:
-
Schließen Sie die Vorbereitungen für die Anwendung, die Erweiterung, die Replikation sowie die Datensicherung ab.
-
Beheben Sie die Probleme, die bei den Vorabprüfungen nicht erkannt wurden, und führen Sie die Selbstprüfungsabfragen durch.
-
Stellen Sie sicher, dass jedes Datenelement deutlich weniger als die Hälfte seines verfügbaren Speicherplatzes belegt, damit bei einem Neuaufbau der HA-Elemente nicht der Speicherplatz knapp wird. Weitere Informationen finden Sie unter Verfügbarkeit während eines Upgrades.
-
Stellen Sie sicher, dass für die Bereitstellung mindestens eine vollständige Sicherung vorliegt. Bis dahin deaktiviert die Konsole die Schaltfläche Hauptversion aktualisieren, und die API lehnt die Anfrage ab.
-
IPMVU ist bei einer Bereitstellung als schreibgeschützte Replik nicht verfügbar. Um eine Replik zu aktualisieren, führen Sie ein Versions-Upgrade durch.
-
Führen Sie für jede schreibgeschützte Replik der Bereitstellung eine Promotion oder Löschung durch, einschließlich der Repliken in anderen Regionen, und warten Sie, bis jeder Vorgang abgeschlossen ist. Eine gelöschte Replik bleibt so lange mit der Bereitstellung verknüpft, bis sie endgültig gelöscht wird. Das Upgrade scheitert an den Vorabprüfungen, solange noch eine Replik mit der Bereitstellung verknüpft ist. Planen Sie Anwendungen, die Daten aus diesen Replikaten lesen. Weitere Informationen finden Sie unter Schreibgeschützte Replikate und IPMVU.
-
Führen Sie jeweils nur ein Upgrade durch. Der Dienst lehnt eine neue Upgrade-Anforderung ab, solange sich eine andere Upgrade-Aufgabe in der Warteschlange befindet oder gerade ausgeführt wird.
-
Wenn Sie die Konfiguration
synchronous_commitder Bereitstellung auf gesetzt habenon, ändern Sie diese auf, bevorlocalSie das Upgrade übermitteln. Ändern Sie dies wieder zurück, sobald die Aufgabe als Abgeschlossen angezeigt wird. Bei kann ein fehlgeschlagenes Upgrade dazu führenon, dass alle Datenbanken schreibgeschützt werden oder Commits in der Warteschlange stehen bleiben, bis der Support die Bereitstellung wiederhergestellt hat. Die Konfiguration der Bereitstellung lautet wie folgt,onwenn die folgende Abfrageonmit der Quelle das Ergebnis liefertconfiguration file:SELECT setting, source FROM pg_catalog.pg_settings WHERE name = 'synchronous_commit'; -
Wählen Sie ein Ziel aus den Funktionen Ihrer Bereitstellung aus. Sie können direkt auf jede neuere Version aktualisieren, die als Upgrade-Option angezeigt wird, ohne Zwischenversionen. Eine Version, die Sie bereitstellen können, ist nicht unbedingt ein Ziel für ein In-Place-Upgrade:
ibmcloud cdb deployment-capability-show <NAME|CRN> versionsVerwenden Sie in der Ausgabe den Wert
to_versioneines Eintrags vom Typ Upgrade Transition.
Vorabprüfungen und Vorbereitung
Der Dienst führt vor dem Start des schreibgeschützten Modus die folgenden Prüfungen durch. Wenn eine Überprüfung fehlschlägt, wird für die Aufgabe Fehlgeschlagen angezeigt, und die Bereitstellung bleibt auf der aktuellen
Version, ohne Schreibvorgänge zu blockieren. Wenn bei einer Datenbank auf gesetzt default_transaction_read_only ist on, setzt eine fehlgeschlagene Überprüfung diese Einstellung in allen Datenbanken zurück und
beendet alle Client-Sitzungen. Da in der Aufgabe nicht angegeben ist, welche Prüfung fehlgeschlagen ist, überprüfen Sie bitte jeden Punkt, bevor Sie das Upgrade einreichen.
| Überprüfung | Erfüllt die Anforderungen, wenn | Ihre Aktion |
|---|---|---|
| Zustand der Bereitstellung | Jedes Datenmitglied ist in Betrieb, und jedes HA-Mitglied empfängt Daten vom Primärserver. | Warten Sie, bis die Skalierung, die Wartung und der Wiederaufbau der HA-Knoten abgeschlossen sind. Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 1. Andere Aufgaben führen zwar nicht zu einem Fehlschlag bei dieser Prüfung,
verzögern jedoch den Start des Upgrades. Überprüfen Sie Zuletzt ausgeführte Aufgaben oder listen Sie Aufgaben mit … auf ibmcloud cdb deployment-tasks-list.
Sollte diese Prüfung weiterhin fehlschlagen, wenden Sie sich bitte an den Support. |
| Plattenspeicherplatz | Jedes Datenelement nutzt höchstens 90 % seines zugewiesenen Speicherplatzes. | Erweitern Sie den Speicherplatz oder löschen Sie Daten, die Sie nicht mehr benötigen. Auch ungenutzte logische Replikationsslots können Transaktionsprotokolle speichern. Diese Prüfung lässt bis zu 90 % zu, doch für einen Neuaufbau der HA-Mitglieder muss jedes Datenmitglied deutlich weniger als die Hälfte seines Festplattenspeichers belegen. Siehe Verfügbarkeit während eines Upgrades. |
| CPU, Arbeitsspeicher und Festplatten-E/A | Bei jedem Datenelement beträgt die 1-Minuten-Auslastung des Hosts höchstens 90 % seiner CPU-Anzahl, und die Speicherauslastung des Hosts beträgt höchstens 90 %. Die Festplatten-E/A-Auslastung beträgt ebenfalls höchstens 90 %. | Führen Sie das Upgrade während einer Phase geringer Aktivität durch oder reichen Sie das Upgrade später erneut ein. Der Dienst misst die Auslastung und den Speicherverbrauch des gesamten Hosts, einschließlich anderer darauf ausgeführter Workloads, und erfasst über einen Zeitraum von einigen Sekunden Stichproben der Festplatten-E/A. Die durchschnittliche Auslastung berücksichtigt auch Prozesse, die auf Festplatten-E/A warten. Die Werte können daher von Ihren Überwachungskennzahlen abweichen, und eine Skalierung Ihrer Bereitstellung führt möglicherweise nicht zu einer Senkung dieser Werte. Sollte diese Prüfung weiterhin fehlschlagen, wenden Sie sich bitte an den Support. |
| Archivierung von Transaktionsprotokollen | Die Archivierung schlägt nicht fehl, und es stehen nicht mehr als 4 GB Transaktionsprotokolle zur Archivierung an. | Reduzieren Sie die Schreibrate, bis der Rückstand abgearbeitet ist. Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 5. Die Prüfung schlägt auch fehl, wenn bei einem HA-Mitglied Transaktionsprotokolle ausstehen, beispielsweise kurz nach einem Failover. Sollte diese Prüfung weiterhin fehlschlagen, wenden Sie sich bitte an den Support. |
| Logische Replikation | Es ist kein logischer Replikations-Slot vorhanden. In PostgreSQL, Version 16 und früheren Versionen gibt es keine logischen Abonnements, auch keine deaktivierten. | Slots entfernen. Entfernen Sie in PostgreSQL, Version 16 und früheren Versionen, Abonnements. Deaktivieren Sie diese in PostgreSQL 17. Überprüfen Sie dies anhand der Selbstüberprüfungsfragen 2 und 3. |
| Schreibgeschützte Replikate und Replikations-Clients | Die Bereitstellung verfügt über keine zugehörige schreibgeschützte Replik, und es verbindet sich kein anderer Replikationsclient als die HA-Mitglieder mit ihr. Die Anzahl der Replikate in jeder Region und jedem Status wird berücksichtigt, einschließlich Replikate, die gerade bereitgestellt werden oder nicht verbunden sind. | Listen Sie die zugehörigen Replikate in der Konsole oder mit auf ibmcloud cdb deployment-read-replicas. Führen Sie jeweils eine Promote- oder Delete-Aktion
durch und warten Sie, bis der jeweilige Vorgang abgeschlossen ist. Eine gelöschte Replik wird weiterhin gezählt, bis sie endgültig gelöscht wird, auch wenn sie in der Liste nicht mehr angezeigt wird. Siehe Schreibgeschützte Replikate und IPMVU.
Trennen Sie andere Replikations-Clients. Die Selbsttestabfrage 1 zeigt nur verbundene Clients an. |
| Vorbereitete Transaktionen | Es existiert keine vorbereitete Transaktion. | Lassen Sie den zuständigen Anwendungs- oder Transaktionsmanager vorbereitete Transaktionen abwickeln und verhindern Sie neue Transaktionen, bis das Upgrade abgeschlossen ist. Führen Sie keine Commits oder Rollbacks durch, nur um die Überprüfung zu bestehen. Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 4. |
| Schema-Export | Das Schema jeder Datenbank lässt sich fehlerfrei exportieren. Ein Export, bei dem eine Zeitüberschreitung auftritt oder der Speicherplatz für Sperren erschöpft ist, führt nicht zum Fehlschlagen dieser Prüfung. | Testen Sie das Upgrade in einer Staging-Umgebung, die Sie aus einem aktuellen Backup wiederherstellen. Diese Prüfung testet nicht, ob die Zielversion das Schema neu erstellen kann; beheben Sie daher auch die Probleme, die von den Vorprüfungen nicht erkannt werden. Sollte diese Prüfung weiterhin fehlschlagen, wenden Sie sich bitte an den Support. |
| Kompatibilität bei Upgrades | Die Kompatibilitätsprüfungen für das PostgreSQL-Upgrade werden auf dem Primärserver und jedem HA-Mitglied erfolgreich bestanden. | Schließen Sie die Vorbereitung der Erweiterung ab, einschließlich der Prüfung pgRouting. Bei PostgreSQL 17 sollten höchstens 10 Abonnements bestehen bleiben. Überprüfen Sie dies anhand der Selbsttestfragen 6, 8, 9 und 10. |
Fehler, die bei den Vorabprüfungen nicht erkannt werden
Die Vorabprüfungen erkennen die folgenden Bedingungen nicht. Bei einigen davon schlägt das Upgrade fehl, nachdem Schreibvorgänge blockiert wurden. Liegt die Ursache im Schema, beispielsweise bei einer Funktion oder einem Datenbanknamen, schlägt jeder erneute Versuch auf dieselbe Weise fehl, bis Sie das Problem beheben. Andere Bedingungen führen dazu, dass der Dienst die gesamte Datenbank auf die HA-Mitglieder kopiert, wodurch Schreibvorgänge deutlich länger blockiert bleiben, oder dass das Upgrade nach Wiederaufnahme der Schreibvorgänge fehlschlägt. Ein Fehler in der Konvertierungs- oder Neustartphase kann ebenfalls dazu führen, dass die HA-Mitglieder angehalten bleiben, bis der Support sie neu startet. Beheben Sie alle Probleme oder treffen Sie entsprechende Vorkehrungen, bevor Sie das Upgrade einreichen.
| Bedingung | Auswirkung | Maßnahme |
|---|---|---|
Eine Datenbank enthält eine Tabelle UNLOGGED. |
Jedes HA-Mitglied wird neu erstellt, und die Inhalte UNLOGGED werden zurückgesetzt. |
Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 11. Siehe Tabellen UNLOGGED und Abläufe. |
| Die Bereitstellung läuft unter PostgreSQL 16 oder 17, und die Tabellen sind durch Massenoperationen oder zahlreiche gleichzeitige Einfügungen oder Aktualisierungen gewachsen. | HA-Mitglieder werden neu aufgebaut. | Planen Sie das Wartungsfenster und den Speicherplatz für eine Neuinstallation. Siehe Verfügbarkeit während eines Upgrades. |
| Ein Datenmitglied belegt etwa die Hälfte seines Festplattenspeichers oder mehr, wenn HA-Mitglieder neu aufgebaut werden. | Beim Rebuild geht der Speicherplatz aus. Schreibvorgänge können stundenlang blockiert bleiben, bevor die Aufgabe fehlschlägt. | Bevor Sie das Upgrade einreichen, skalieren Sie den Speicherplatz so lange, bis jedes Datenelement deutlich weniger als 50 % seines verfügbaren Speicherplatzes belegt. |
Ein Index, ein Partitionsschlüssel, eine gespeicherte generierte Spalte oder erweiterte Statistiken verwenden eine Funktion LANGUAGE sql mit einem Zeichenfolgenkörper, der Objekte außerhalb des pg_catalog Schemas benennt. In einem Index hat die Benennung des Schemas ibm_extension denselben Effekt. |
Die Konvertierung schlägt fehl. | Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 12. Siehe SQL-Funktionen in Indizes, Partitionsschlüsseln und generierten Spalten. |
Ein Index oder eine automatisch generierte Spalte verwendet earthdistance Version 1.1. |
Die Konvertierung schlägt fehl. | Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 13. Siehe earthdistance. |
| Eine Ansicht, eine Aggregatfunktion oder eine Funktion mit einem SQL-Standardkörper verwendet einen Systemnamen, der in der Zielversion entfernt wurde. Oder eine Funktion, Rolle oder Datenbankeinstellung verwendet einen entfernten Parameter. | Die Konvertierung schlägt fehl. | Überprüfen Sie dies anhand der Selbstüberprüfungsfragen 7 und 14. Siehe Objekte, die entfernte Systemnamen verwenden. |
anon Version 2 ist installiert. |
Die Konvertierung schlägt fehl. | Schließen Sie die Vorbereitung anon ab. |
Ein Datenbankname enthält ein einfaches Anführungszeichen ('), einen Backslash (``), ein Gleichheitszeichen (=), einen Zeilenumbruch oder einen Wagenrücklauf. |
Das Upgrade schlägt fehl, in einigen Fällen nachdem Schreibvorgänge blockiert wurden. | Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 15. Benennen Sie die Datenbank um und aktualisieren Sie Ihre Verbindungszeichenfolgen. |
| Datenbanken enthalten viele Tausend Tabellen und Sequenzen oder – bei PostgreSQL, Versionen 14 und 15 – Views. | Bei der Konvertierung geht der Speicherplatz für Sperren zur Neige, sodass der Vorgang fehlschlägt. | Überprüfen Sie dies anhand der Selbsttest-Abfrage 16 und erhöhen Sie den Wert, falls max_locks_per_transaction die Abfrage dies erfordert. |
| Die Bereitstellung umfasst sehr viele Datenbanken, Tabellen oder große Objekte. | Die Konvertierung überschreitet das Zeitlimit. Die Aufgabe schlägt fehl oder bleibt im Status In Bearbeitung, solange die Datenbank nicht verfügbar ist. | Zählen Sie die Tabellen und großen Objekte mit der Selbstprüfungsabfrage 16. Üben Sie dies in einer Staging-Umgebung, die Sie aus einem aktuellen Produktions-Backup wiederherstellen. Sollte die Testausführung fehlschlagen, wenden Sie sich bitte an den Support. |
| Die Schreibaktivität ist hoch, wenn das Upgrade beginnt oder viele Transaktionsprotokolle auf ihre Archivierung warten. | Nach Beginn des schreibgeschützten Modus haben die HA-Mitglieder und die Transaktionsprotokollarchivierung nur wenige Minuten Zeit, um den Rückstand aufzuholen. Ein Backlog, das die Vorabprüfung besteht, kann länger zum Archivieren benötigen, wodurch das Upgrade anschließend fehlschlägt. | Halten Sie die Auslastung vom Beginn des Upgrades bis zur Wiederaufnahme der Schreibvorgänge gering und führen Sie die Verarbeitung vor dem Upgrade auf VACUUM kürzlich geladenen Tabellen durch. Überprüfen Sie die Replikationsverzögerung
mithilfe der Abfrage unter Verfügbarkeit während eines Upgrades und überprüfen Sie die Archivierung mithilfe der Selbstprüfungsabfrage 5. |
Schreibvorgänge werden auch nach Beginn des schreibgeschützten Modus fortgesetzt, beispielsweise durch Überschreibungen im schreibgeschützten Modus, Wartungsbefehle, laufende Jobs pg_cron oder aktivierte Abonnements unter
PostgreSQL 17. |
Die HA-Mitglieder und die Archivierung könnten möglicherweise nicht rechtzeitig nachziehen, was dazu führt, dass das Upgrade fehlschlägt. | Halten Sie diese Autoren zurück, bevor Sie das Upgrade einreichen, wie unter Verfügbarkeit während eines Upgrades beschrieben. |
Ein Client bereitet nach den Vorabprüfungen eine Transaktion vor. funktioniert weiterhin PREPARE TRANSACTION im schreibgeschützten Modus. |
Das Upgrade schlägt fehl, während Schreibvorgänge blockiert sind. Eine Transaktion, die kurz vor dem Beenden von PostgreSQL vorbereitet wird, kann dazu führen, dass die Konvertierung fehlschlägt. | Halten Sie Clients, die Two-Phase-Commit verwenden, an, bis der Vorgang den Status Abgeschlossen anzeigt. Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 4. |
| Ein Replikationsclient stellt während des Upgrades eine Verbindung her. | Ein dadurch erstellter Slot wird nicht beibehalten, und das Upgrade kann fehlschlagen oder ins Stocken geraten, während die Datenbank nicht verfügbar ist. | Halten Sie die Replikations-Clients getrennt, bis der Status der Aufgabe Abgeschlossen anzeigt. Überprüfen Sie dies anhand der Selbstüberprüfungsfragen 1 und 2. |
| Nach der Wiederaufnahme der Schreibvorgänge wird ein kontinuierlicher Massenladevorgang ausgeführt. | Die Aufgabe schlägt fehl, nachdem die Schreibvorgänge wieder aufgenommen wurden, und die Bereitstellung läuft mit der Zielversion weiter, bis der Support das Upgrade abgeschlossen hat. | Vermeiden Sie Massenladungen, bis die Aufgabe den Status Abgeschlossen anzeigt. |
Die Einstellung synchronous_commit der Bereitstellung lautet on. |
Ein fehlgeschlagenes Upgrade kann dazu führen, dass alle Datenbanken schreibgeschützt bleiben, bis der Support die Bereitstellung wiederhergestellt hat. | Ändern Sie dies local wie unter „ Bevor Sie beginnen “ beschrieben. |
Sie führen ein Upgrade von PostgreSQL 16 oder früher auf 17 oder höher durch, und ein Index, eine materialisierte Ansicht oder erweiterte Statistiken verwenden eine Funktion ohne eine bestimmte Einstellung search_path. |
Nach dem Upgrade können REFRESH MATERIALIZED VIEW, ANALYZE``REINDEX, CLUSTER, VACUUM FULL, und für diese Objekte fehlschlagen. |
Überprüfen Sie dies anhand der Selbstüberprüfungsfrage 17. Siehe SQL-Funktionen in Indizes, Partitionsschlüsseln und generierten Spalten. |
Ändern Sie zwischen der Einreichung des Upgrades und dem Abschluss der Aufgabe keine Schemata, Erweiterungen, Datenbanken, logischen Replikationsslots oder Abonnements.
Selbstprüfung der Bereitschaft
Führen Sie die folgenden Abfragen als Benutzer admin mit aus, bevor psql Sie das Upgrade übermitteln. Sie funktionieren mit PostgreSQL-Versionen 14 bis 18. Die Abfragen 1 bis 7 sowie Abfrage 15 decken die gesamte
Bereitstellung ab; führen Sie sie daher einmal in einer beliebigen Datenbank aus. Führen Sie die anderen Abfragen in jeder Datenbank aus.
-
Replikationsverbindungen. Es ist mit einer Zeile pro HA-Mitglied zu rechnen, was der Anzahl der Datenmitglieder minus eins entspricht, wobei jedes den Status aufweist
streaming. Jede andere Zeile ist eine schreibgeschützte Replik oder ein weiterer Replikationsclient. Eine Zeile mit dem Namen bedeutetpg_basebackup, dass der Dienst die Datenbank auf ein HA-Mitglied oder eine schreibgeschützte Replik kopiert. Warten Sie, bis der Kopiervorgang abgeschlossen ist, und führen Sie die Abfrage dann erneut aus.SELECT application_name, client_addr, state FROM pg_catalog.pg_stat_replication ORDER BY application_name; -
Logische Replikationsslots. Es sind keine Zeilen zu erwarten.
SELECT slot_name, plugin, database, active FROM pg_catalog.pg_replication_slots WHERE slot_type = 'logical'; -
Logische Abonnements. Bei PostgreSQL, Version 16 und früheren Versionen sind keine Zeilen zu erwarten. Bei PostgreSQL 17 ist in
fder Spaltesubenabledjeder Zeile mit zu rechnen.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; -
Vorbereitete Transaktionen. Es sind keine Zeilen zu erwarten.
SELECT gid, owner, database, prepared FROM pg_catalog.pg_prepared_xacts; -
Archivierung von Transaktionsprotokollen. Es ist zu erwarten,
last_failed_timedass leer ist oder kleiner alslast_archived_timeist undwaiting_filesdass 0 oder nahe 0 ist. Ein Backlog, das die Vorprüfung besteht, kann nach Beginn des schreibgeschützten Modus dennoch zu groß sein, um archiviert zu werden.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'; -
Einstellungen für die Datenbankverbindung. Es sind keine Zeilen zu erwarten. Löschen Sie eine aufgeführte Datenbank, deren ungültig ist
datconnlimit``-2, da sie ungültig ist. Für alle anderen aufgeführten Datenbanken: Verbindungen zulassen oder die Datenbank löschen. Wenn die Abfrage listet enthälttemplate0, wenden Sie sich bitte an den Support.SELECT datname, datallowconn, datconnlimit FROM pg_catalog.pg_database WHERE (datname <> 'template0' AND (NOT datallowconn OR datconnlimit = -2)) OR (datname = 'template0' AND datallowconn); -
Rollen und Datenbankeinstellungen. Stellen Sie sicher, dass jeder Parameter in in der Zielversion vorhanden
setconfigist. Setzen Sie einen Parameter zurück, der in der Zielversion entfernt oder umbenannt wurde, und legen Sie nach dem Upgrade dessen Ersatz fest. Dies gilt auch für durch Erweiterungen definierte Parameter, deren Namen einen Punkt enthalten. Stellen Sie sicher, dass keine Rolle aufdefault_transaction_read_onlyeinen falschen Wert gesetzt ist, wie z. B.off,false,no, oder0. Notieren Sie jede Datenbank, in der diese Einstellung festgelegt istdefault_transaction_read_only, da sie durch das Upgrade zurückgesetzt wird. Die Selbsttestabfrage 14 überprüft die Einstellungen der Funktionen.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; -
Spaltendatentypen, die PostgreSQL nicht aktualisieren kann. Es sind keine Zeilen zu erwarten. Die Abfrage listet außerdem Spalten mit zusammengesetzten Systemtypen sowie Domänen, Arrays, zusammengesetzte Typen und Bereiche auf, die auf diesen Typen basieren. In der
base_typeSpalte wird der Typ angezeigt, der das Upgrade verhindert. Der Typaclitemblockiert ausschließlich Upgrades von PostgreSQL 14 oder 15 auf 16 oder höher.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; -
Geerbte Spalten ohne eine Einschränkung
NOT NULL, die ihre übergeordnete Tabelle aufweist. Es sind keine Zeilen zu erwarten. Um eine aufgeführte Spalte zu korrigieren, führt der Tabellenbesitzer den Befehl ausALTER 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; -
Installierte Erweiterungen. Schließen Sie die Vorbereitung der Erweiterung ab. Stellen Sie anschließend sicher, dass alle verbleibenden Erweiterungen in der Zielversion verfügbar sind, beispielsweise in einer Staging-Umgebung dieser Version.
SELECT extname, extversion FROM pg_catalog.pg_extension ORDER BY extname; -
UNLOGGEDTabellen und Abläufe. Ihre Inhalte gehen bei der Aktualisierung verloren, und eine aufgeführte Tabelle führt dazu, dass der Dienst jedes HA-Mitglied neu aufbaut. Bevor Sie das Upgrade durchführen, sehen Sie sich die TabellenUNLOGGEDund Abläufe an.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'); -
SQL-Funktionen, die dazu führen können, dass die Konvertierung fehlschlägt. Es sind keine Zeilen zu erwarten. Die Abfrage listet Funktionen
LANGUAGE sqlmit einem String-Körper auf, die von einem Index, einem Prädikat für einen Teilindex, einem Partitionsschlüssel, einer gespeicherten generierten Spalte oder erweiterten Statistiken verwendet werden. Es umfasst Abfragen über Operatoren, Domänenprüfungsbeschränkungen und Funktionen mit einem SQL-Standard-Körper. Informationen zu den einzelnen aufgeführten Funktionen finden Sie unter SQL-Funktionen in Indizes, Partitionsschlüsseln und generierten Spalten.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; -
Indizes und gespeicherte generierte Spalten, die Version
earthdistance1.1 verwenden – entweder direkt oder über Funktionen mit einem SQL-Standard-Körper. Es sind keine Zeilen zu erwarten. Informationen zu jedem aufgeführten Objekt finden Sie unterearthdistance.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; -
Ansichten, materialisierte Ansichten, Aggregate und Funktionen, die Namen aus dem Systemkatalog oder Konfigurationsparameter verwenden, die in einer späteren PostgreSQL-Version entfernt wurden. Die Spalte
removed_inzeigt die erste Version ohne den Namen an. Es sind keine Zeilen mit einer Versionremoved_inzu erwarten, die Ihrer Zielversion entspricht oder darunter liegt. Ein Name kann mit Text übereinstimmen, der keine Katalogreferenz ist. Überprüfen Sie daher jedes aufgeführte Objekt. Siehe Objekte, die entfernte Systemnamen verwenden.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; -
Datenbanknamen, die beim Upgrade nicht verwendet werden können. Es sind keine Zeilen zu erwarten. Um eine aufgeführte Datenbank zu korrigieren, muss sich deren Eigentümer mit einer anderen Datenbank verbinden und den Befehl ausführen, während
ALTER DATABASE "<database_name>" RENAME TO <new_name>;keine Sitzungen mit der umzubennenden Datenbank verbunden sind. Der Eigentümer muss außerdem über das AttributCREATEDBverfügen. Aktualisieren Sie anschließend alle Anwendungen, die eine Verbindung zur Datenbank herstellen.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; -
Beziehungen, die durch das Upgrade gesperrt werden, große Objekte und die Sperrkapazität der Bereitstellung. Addieren Sie die Werte der
locked_relationsvier Datenbanken mit den höchsten Werten. Bei PostgreSQL, Version 14 und 15, sind auch Views und materialisierte Viewslocked_relationsenthalten, da diese beim Upgrade ebenfalls gesperrt werden. Wenn die Gesamtsumme überschritten wirdlock_capacity, erhöhen Sie so lange,max_locks_per_transactionbis die Gesamtsummelock_capacityüberschritten wird. Die Änderung führt zu einem Neustart der Datenbank. Führen Sie sie daher durch, bevor Sie das Upgrade ausführen. Viele Tabellen oder große Objekte verlängern zudem die Konvertierung, probieren Sie das Upgrade daher zunächst mit Ihrem tatsächlichen Schema und Ihren Daten aus.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; -
Funktionen ohne eine Einstellung
search_path, die von Indizes, materialisierten Ansichten und erweiterten Statistiken verwendet wird. Die Abfrage folgt den Aufrufen von Operatoren, Domänenprüfungsbeschränkungen und Funktionen mit einem SQL-Standard-Körper. Führen Sie diese Abfrage aus, wenn Sie ein Upgrade von PostgreSQL 16 oder früher auf PostgreSQL 17 oder später durchführen. Eine aufgeführte Funktion, deren Hauptteil Objekte außerhalb des Systems ohnepg_catalogderen Schema benennt, führt dazu, dass Wartungsbefehle nach dem Upgrade fehlschlagen. Eine Funktion bleibt nur dann unbeeinträchtigt, wenn ihr Funktionskörper und jede von ihr aufgerufene Funktion jedes Objekt außerhalbpg_catalogmit seinem Schema benennt. Für jede weitere aufgeführte Funktion fügt deren Eigentümer einesearch_pathEinstellung hinzu, wie unter SQL-Funktionen in Indizes, Partitionsschlüsseln und generierten Spalten beschrieben.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;
Das Bestehen dieser Prüfungen garantiert nicht, dass das Upgrade erfolgreich verläuft oder dass Ihre Anwendungen mit der Zielversion kompatibel sind. Nur bei einer Testdurchführung in einer Staging-Umgebung wird die gesamte Konvertierung durchgeführt.
Planung des Upgrade-Fensters
Nutzen Sie Ihre Staging-Probe, um ein Wartungsfenster abzuschätzen. Die Konvertierungsdauer hängt hauptsächlich von der Anzahl der Datenbanken und Objekte ab. Die Wiederherstellung eines HA-Mitglieds hängt von der Größe der Datenbank ab. Die Arbeitslast und das Volumen der Transaktionsprotokolle wirken sich auf die Überprüfungen und den Nachholvorgang aus. Planen Sie ausreichend Zeit für den gesamten Upgrade-Vorgang ein, nicht nur für die Zeit, in der Schreibvorgänge blockiert sind.
Start expiration legt den spätesten Zeitpunkt fest, zu dem ein in der Warteschlange befindliches Upgrade beginnen kann. Standardmäßig beträgt die Frist 5 Minuten nach der Anfrage, und Sie können sie bis zu 24 Stunden im Voraus festlegen. Laufende Vorgänge, wie z. B. eine Datensicherung, sowie zuvor in die Warteschlange gestellte Anfragen verzögern den Start. Wenn das Upgrade nicht vor Ablauf der Frist gestartet wird, wird es nicht ausgeführt, und der Status der Aufgabe lautet Abgelaufen. Das Ablaufen der Gültigkeitsdauer unterbricht ein bereits begonnenes Upgrade nicht. Beispiel: Eine in der Warteschlange befindliche Anfrage läuft um 22:30 Uhr UTC ab. Eine Aufgabe, die um 22:25 UTC beginnt, kann über diesen Zeitpunkt hinaus andauern.
Während das Upgrade läuft, werden andere Anfragen für die Bereitstellung zurückgestellt, bis es abgeschlossen ist. Dazu gehören die manuelle und automatische Skalierung, Konfigurationsänderungen, Änderungen an Benutzern und Passwörtern, Änderungen an zugelassenen IP-Adressen sowie Backups. Löschen Sie die Bereitstellung nicht, solange die Upgrade-Aufgabe in der Warteschlange steht oder ausgeführt wird.
Erstellen Sie keine schreibgeschützten Replikate, bis die Aufgabe abgeschlossen ist. Der Dienst blockiert solche Anfragen nicht. Wenn Sie eine solche erstellen, kann das Upgrade die Vorabprüfungen nicht bestehen, oder die neue Replik kann nicht aus der aktualisierten Bereitstellung repliziert werden. Löschen Sie eine solche Replik und erstellen Sie nach Abschluss der Aufgabe eine neue.
Upgrade über die Benutzerschnittstelle
- Erstellen und überprüfen Sie ein On-Demand-Backup. Das Upgrade dauert nicht lange.
- Klicken Sie auf der Übersichtsseite der Bereitstellung auf Hauptversion aktualisieren.
- Überprüfen Sie im Schritt Anleitung die Anleitung, wählen Sie Ich habe die Anleitung gelesen und bin bereit, mit dem Upgrade fortzufahren aus, und klicken Sie auf Weiter. Informationen dazu, wann Lese- und Schreibzugriffe nicht verfügbar sind, finden Sie unter Verfügbarkeit während eines Upgrades.
- Wählen Sie unter Auf Version aktualisieren die Zielversion aus. Wenn mehr als ein Ziel verfügbar ist, wählt die Liste standardmäßig das neueste aus. Der Hinweis zu Lese-Replikaten in diesem Schritt ist veraltet. Das Upgrade scheitert an den Vorabprüfungen, solange noch eine schreibgeschützte Replik mit der Bereitstellung verknüpft ist. Erhöhen Sie daher den Status jeder Replik oder löschen Sie sie, bevor Sie das Upgrade durchführen.
- Wählen Sie unter Ablaufzeit für den Start des Upgrades aus, wie lange die Anfrage auf den Start warten darf. Die Standardeinstellung ist 5 Minuten.
- Klicken Sie auf Upgrade durchführen. Während die Anfrage in der Warteschlange steht oder ausgeführt wird, wird in der Zeile Version auf der Übersichtsseite Upgrade in der Warteschlange oder Upgrade wird durchgeführt angezeigt.
- Verfolgen Sie die Aufgabe unter Zuletzt ausgeführte Aufgaben. Sobald die Schreibvorgänge wieder aufgenommen werden, aktualisieren Sie die Statistiken wie unter Nach dem Upgrade beschrieben. Wenn die Aufgabe den Status Abgeschlossen anzeigt, führen Sie die verbleibenden Schritte in diesem Abschnitt aus. Wenn Fehlgeschlagen angezeigt wird, lesen Sie den Abschnitt Fehlerbehebung. Wenn Abgelaufen angezeigt wird, wurde das Upgrade nicht gestartet, und Sie können es mit einem späteren Ablaufdatum erneut einreichen.
Upgrade über die Anwendungsprogrammierschnittstelle
Senden Sie eine Anfrage PATCH an den /deployments/{id}/version Endpunkt. Stellen Sie die Hauptversion auf version den Zielwert ein und legen Sie das Ablaufdatum mit dem expiration_datetime Abfrageparameter fest:
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"}'
Ersetzen Sie durch <EXPIRATION_TIME> eine UTC-Zeit im ISO-8601-Format, z. B. 2026-11-03T22:30:00Z, zwischen 5 Minuten und 24 Stunden nach der Anfrage. Wenn Sie das weglassen expiration_datetime,
läuft die Anfrage ab, wenn sie nicht innerhalb von 5 Minuten gestartet wird.
Eine erfolgreiche Anfrage gibt eine Aufgabe zurück. Eine akzeptierte Anfrage bedeutet noch nicht, dass das Upgrade abgeschlossen ist. Verwenden Sie die Aufgaben-ID mit Informationen zu einer Aufgabe abrufen, um das Upgrade zu überwachen. Um die verfügbaren Ziele aufzulisten, verwenden Sie die Funktion Discover aus einer Bereitstellung mit der entsprechenden
Funktion versions. Alle Parameter finden Sie in der API-Referenz.
Upgrade über die Befehlszeilenschnittstelle
Verwenden Sie Version 0.20.0 oder höher des Cloud Databases-CLI-Plug-ins. Legen Sie die Start-Ablaufzeit mit --expire-in oder fest --expire-at, und zwar zwischen 5 Minuten und 24 Stunden nach der Anfrage. Die Standardeinstellung
ist 5 Minuten.
ibmcloud cdb deployment-version-upgrade <NAME|CRN> <TARGET_VERSION> --expire-in 1h --nowait
Ohne wartet der Befehl --nowait, bis die Aufgabe abgeschlossen ist oder fehlschlägt. Es wird kein Ergebnis zurückgegeben, wenn das Upgrade abläuft, bevor es beginnt; verwenden Sie daher in --nowait Skripten. Bei kehrt
der Befehl zurück --nowait, nachdem der Dienst die Anfrage angenommen hat. Überwachen Sie die Aufgabe mit deployment-tasks-list:
ibmcloud cdb deployment-tasks-list <NAME|CRN>
Führen Sie für alle Parameter den Befehl aus ibmcloud cdb deployment-version-upgrade --help.
Upgrade über Terraform
Verwenden Sie den Terraform-Provider IBM Cloud® in der Version 1.79.2 oder höher. Legen Sie ein verfügbares Ziel version fest, überprüfen Sie den Plan und setzen Sie ihn um. Der Plan schlägt fehl, wenn das Zielsystem für ein In-Place-Upgrade
nicht verfügbar ist.
Stellen Sie das Zeitlimit für die Aktualisierung der Ressource so ein, dass es für das gesamte Upgrade ausreicht und mindestens 5 Minuten beträgt. Der Anbieter nutzt diese Zeitüberschreitung von bis zu 24 Stunden auch als Beginn der Ablaufzeit.
Ein in der Warteschlange stehendes Upgrade kann daher jederzeit starten, bis die Zeitüberschreitung eintritt. Führen Sie die Änderung durch, wenn keine Sicherung oder andere Vorgänge ausgeführt werden oder in der Warteschlange stehen, damit
das Upgrade sofort beginnt. Sollte die Anwendung nach Beginn des Upgrades eine Zeitüberschreitung verzeichnen, wird das Upgrade fortgesetzt. Befindet sich das Upgrade nach Ablauf der Wartezeit noch in der Warteschlange, verfällt es und wird
nicht ausgeführt. Warten Sie, bis die Aufgabe abgeschlossen ist, bevor Sie terraform plan sie erneut terraform apply ausführen.
Sollte die Upgrade-Aufgabe fehlschlagen, führen Sie die Fehlerbehebung durch, bevor Sie den Vorgang erneut terraform apply starten. Terraform führt das Upgrade erneut durch, sobald
bei der Bereitstellung weiterhin die Quellversion gemeldet wird.
Nach einem Upgrade außerhalb von Terraform setzen Sie auf version die neue Version oder entfernen Sie aus version der Konfiguration. Zu den Upgrades außerhalb von Terraform gehören Upgrades in der Benutzeroberfläche,
der Befehlszeilenschnittstelle (CLI) oder der API sowie ein erzwungenes Upgrade. Solange Sie die Konfiguration nicht aktualisieren, schlägt jeder Vorgang terraform plan, der terraform apply die Bereitstellung umfasst, fehl, wodurch Änderungen an anderen Ressourcen in derselben Konfiguration verhindert werden. Der Fehler ähnelt oder Version 14 is not a valid upgrade version No available upgrade versions for version 18.
Das Argument version_upgrade_skip_backup wird von PostgreSQL nicht unterstützt. Weitere Informationen finden Sie in der Datenbank-Ressourcenreferenz.
Nach dem Upgrade
Sobald die Schreibvorgänge wieder aufgenommen werden, stellen Sie sicher, dass die Optimierungsstatistiken vollständig sind. Warten Sie nicht, bis die Task abgeschlossen ist. Das Schreiben wird fortgesetzt, wenn off in einer neuen
Sitzung SHOW default_transaction_read_only; zurückkehrt. In jeder Datenbank listet die folgende Abfrage Ihre Tabellen und materialisierten Ansichten auf, für die keine Statistiken vorliegen. Führen Sie dies für ANALYZE <table_name>; jede aufgeführte Beziehung aus. Wenn Ihr Benutzer keine Berechtigung zum Analysieren einer Relation hat, führen Sie den Befehl als Eigentümer der Relation aus. Bei der Analyse einer partitionierten Tabelle werden auch deren Partitionen analysiert.
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');
Unter PostgreSQL, Version 17 und höher, ANALYZE kann der Vorgang mit einem Fehler wie dem folgenden fehlschlagen function ... does not exist. In diesem Fall korrigieren Sie die Funktion, die in der Selbstprüfungsabfrage
17 aufgeführt ist, und führen Sie den Vorgang erneut ANALYZE aus. Eine datenbankweite Abfrage, die ANALYZE aufgrund eines Fehlers abgebrochen wird, analysiert die verbleibenden Tabellen nicht. Analysieren Sie unter
PostgreSQL 18 außerdem jede Tabelle, die Statistikobjekte enthält (wie vom Befehl psql aufgelistet) \dX, sowie jede Tabelle, die PostGIS-Spalten enthält, da diese Statistiken beim Upgrade nicht übertragen werden.
Sobald die Aufgabe den Status Abgeschlossen aufweist:
-
Stellen Sie sicher, dass die Version der Bereitstellung in der Konsole oder der API der Zielversion entspricht und dass diese
SHOW server_version;zurückgibt. Führen Sie die Selbstprüfungsabfrage 1 durch und stellen Sie sicher, dass jedes HA-Mitglied Daten überträgt. Stellen Sie außerdem sicher, dass der Schreibzugriff in jeder Datenbank wiederhergestellt wurde: Die folgende Abfrage liefert keine Zeilen. Falls ein HA-Mitglied fehlt, eine Zeile mit dem Namen verbleibtpg_basebackupoder die Abfrage eine Datenbank auflistet, wenden Sie sich bitte an den Support.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=%'); -
Erweiterungen aktualisieren. Bei dem Upgrade bleibt jede Erweiterung auf der installierten Version erhalten. Listen Sie in jeder Datenbank die Erweiterungen auf, für die eine neuere Version verfügbar ist, und aktualisieren Sie jede einzelne davon:
SELECT name, installed_version, default_version FROM pg_catalog.pg_available_extensions WHERE installed_version <> default_version;ALTER EXTENSION <extension_name> UPDATE;Wenn Sie ein Upgrade von PostgreSQL 14, 15 oder 16 auf PostgreSQL 17 oder höher durchgeführt haben, werden bei der Aktualisierung die Spalten
blk_write_timeblk_read_timeund inshared_blk_read_timeund umbenanntpg_stat_statements``shared_blk_write_time. Aktualisieren Sie die Abfragen, die diese Spalten auslesen. -
Stellen Sie die Erweiterungen und die Maskierung wie in der Vorbereitung beschrieben wieder her. Laden Sie die Tabellen
UNLOGGEDaus den von Ihnen exportierten Inhalten neu. Stellen Sie jedeUNLOGGEDSequenz über die derzeit verwendeten Werte hinaus ein, zum Beispiel mitSELECT setval('<sequence_name>', (SELECT max(<column_name>) FROM <table_name>));. Erstellen Sie die logischen Replikations-Slots, Abonnements und schreibgeschützten Replikate, die Sie entfernt haben, neu und aktivieren Sie die Abonnements, die Sie deaktiviert haben. Stellen Sie die Verbindung zu den Verbrauchern wieder her und synchronisieren Sie die Daten neu, bevor Sie abhängige Anwendungen wieder starten. -
Wenn Sie
default_transaction_read_onlyfür eine Datenbank festgelegt haben, legen Sie es erneut fest. Durch das Upgrade wird diese Einstellung in jeder Datenbank zurückgesetzt, sodass diese Datenbanken wieder Schreibvorgänge akzeptieren. -
Vergewissern Sie sich, dass die Sicherung nach dem Upgrade abgeschlossen wurde. Da die gesamte Datenbank kopiert wird, kann dies mehrere Stunden dauern. Wenn Sie eine zeitpunktbezogene Wiederherstellung für Änderungen benötigen, die nach dem Upgrade vorgenommen wurden, halten Sie die Schreibvorgänge der Anwendung bis dahin an.
-
Wenn Sie ein Upgrade von PostgreSQL 14 oder 15 auf PostgreSQL 16 oder höher durchgeführt haben, führen Sie die Rollenabfrage unter Probleme mit Rollenberechtigungen bei Versions-Upgrades aus. Weisen Sie die aufgeführten Rollen zu, bevor Sie Jobs fortsetzen, die Rollen verwalten.
-
Wenn Terraform die Bereitstellung verwaltet und Sie das Upgrade außerhalb von Terraform durchgeführt haben, setzen Sie auf
versiondie neue Version oder entfernen Sie es, wie unter Upgrade über Terraform beschrieben. -
Setzen Sie die von Ihnen angehaltenen Anwendungsvorgänge und geplanten Jobs fort. Stellen Sie die Einstellungen wieder her, die Sie für das Upgrade geändert haben, z. B.
synchronous_commit. -
Erstellen Sie Objekte, die von Unicode-Daten abhängen, neu, da neuere PostgreSQL-Versionen neuere Unicode-Daten verwenden:
- Sofern Sie kein Upgrade von PostgreSQL 16 auf PostgreSQL 17 durchgeführt haben, überprüfen Sie Indizes, materialisierte Ansichten, Prüfbedingungen und Partitionsschlüssel, deren Ausdrücke
normalize()oder verwendenis_normalized(). Betroffen ist nur Text, der Zeichen enthält, die erst in einer späteren Unicode-Version eingeführt wurden. - Wenn Sie ein Upgrade von PostgreSQL 17 auf PostgreSQL 18 durchgeführt haben, überprüfen Sie auch Objekte, die. verwenden
unicode_assigned(). Überprüfen Sie außerdem Objekte, die reguläre Ausdrücke,ILIKE,lower(),upper(), oderinitcap()auf Text in der integrierten LokalisierungC.UTF-8anwenden. Diepg_c_utf8Sortierreihenfolge und Datenbanken, die denbuiltinLocale-Anbieter verwenden, nutzenC.UTF-8diese Locale. - Wenn Sie ein Upgrade auf PostgreSQL 18 durchgeführt haben und eine Datenbank den
builtinLocale-Anbietericuoder verwendet, erstellen Sie die Volltextsuche und die Indizespg_trgmneu.
Führen Sie dies
REINDEX INDEX <index_name>;für jeden betroffenen Index undREFRESH MATERIALIZED VIEW <view_name>;für jede betroffene materialisierte Ansicht aus. Stellen Sie sicher, dass die Zeilen weiterhin die betroffenen Prüfbedingungen erfüllen und sich in den richtigen Partitionen befinden. - Sofern Sie kein Upgrade von PostgreSQL 16 auf PostgreSQL 17 durchgeführt haben, überprüfen Sie Indizes, materialisierte Ansichten, Prüfbedingungen und Partitionsschlüssel, deren Ausdrücke
-
Vergleichen Sie das Verhalten und die Leistung der Anwendung mit Ihren Staging-Ergebnissen.
Fehlerbehebung
Wenn der Dienst eine Anfrage ablehnt, wird der Fehler sofort angezeigt. In der Benutzeroberfläche wird in der Regel Upgrade fehlgeschlagen zusammen mit dem Grund angezeigt, die API gibt die Fehlermeldung zurück und die CLI gibt den Fehler zusammen mit einem Hinweis aus. Korrigieren Sie die Anfrage und senden Sie sie erneut ab.
Wenn die Aufgabe den Status Abgelaufen aufweist, wurde das Upgrade nicht gestartet und die Bereitstellung bleibt unverändert. Führen Sie das Upgrade erneut durch, wenn keine anderen Vorgänge ausgeführt werden oder in der Warteschlange stehen, oder legen Sie einen späteren Starttermin fest.
Bei einer Aufgabe, die später den Status Fehlgeschlagen anzeigt, wird weder die fehlgeschlagene Prüfung noch der fehlgeschlagene Schritt angegeben, und die Benutzeroberfläche zeigt die Ursache nicht an. Je nach dem Schritt, bei dem ein Fehler aufgetreten ist, kann sich die Bereitstellung in einem der folgenden Zustände befinden:
- Zur Quellversion: Bei der Bereitstellung wird die Quellversion ausgeführt und Schreibvorgänge werden akzeptiert. Eine fehlgeschlagene Vorabprüfung führt dazu, dass die Bereitstellung in diesem Zustand verbleibt, und der
Dienst stellt den Schreibzugriff nach den meisten Fehlern im schreibgeschützten Modus wieder her. Ein gescheiterter Versuch kann dennoch langfristige Auswirkungen haben. Es kann
UNLOGGEDTabellen entfernenold_snapshot, leere Tabellen löschen,UNLOGGEDSequenzen zurücksetzen und eine Lücke in der PITR-Abdeckung hinterlassen. Außerdem können damitdefault_transaction_read_onlyEinstellungen auf Datenbankebene zurückgesetzt werden, sodass diese Datenbanken wieder Schreibvorgänge akzeptieren. Wenn Sie füroneine beliebige Datenbank den Wert aufdefault_transaction_read_onlysetzen, beendet ein fehlgeschlagener Versuch auch alle Client-Sitzungen, selbst wenn eine Vorabprüfung fehlschlägt. - Zur Zielversion: Die Bereitstellung läuft unter der Zielversion, das Upgrade ist jedoch erst abgeschlossen, wenn der Support es fertiggestellt hat. In der Konsole und der API wird weiterhin die Quellversion angezeigt. Bis dahin laufen die HA-Mitglieder möglicherweise nicht, und Backups sowie die Archivierung von Transaktionsprotokollen können fehlschlagen. Sollte die Selbstüberprüfung 1 oder 5 ein Problem anzeigen, unterbrechen Sie die Schreibvorgänge der Anwendung, bis der Support das Upgrade abgeschlossen hat.
- Fehlerzustand: Die Bereitstellung bleibt schreibgeschützt oder nicht verfügbar bzw. läuft ohne ihre HA-Mitglieder, bis der Support den Fehler behebt. Ein Fehler in der Konvertierungs- oder Neustartphase kann dazu führen, dass die HA-Mitglieder angehalten bleiben, bis der Support sie neu startet – selbst nachdem die Schreibvorgänge wieder aufgenommen wurden.
Um den Status zu ermitteln, melden Sie sich als an und admin führen Sie aus SHOW server_version;. Führen Sie in jeder von Ihnen verwendeten Datenbank den Befehl SHOW default_transaction_read_only;. aus.
Führen Sie die Selbstprüfungsabfrage 1 durch, um sicherzustellen, dass jedes HA-Mitglied Daten überträgt. Wenn nach dem Fehlschlagen der Aufgabe admin keine Verbindung hergestellt
werden kann, beispielsweise aufgrund eines Authentifizierungsfehlers, wenden Sie sich an den Support. Das Upgrade hat keine Auswirkungen auf Ihre Anmeldedaten.
Wenn die Bereitstellung Schreibvorgänge akzeptiert, die Quellversion ausführt und jedes HA-Mitglied Daten streamt, überprüfen Sie die Vorabprüfungen und führen Sie die Selbstprüfungsabfragen durch. Beheben Sie alle noch offenen Probleme, führen Sie eine On-Demand-Sicherung durch und reichen Sie das Upgrade anschließend erneut ein. In allen anderen Fällen oder falls auch der nächste Versuch fehlschlägt, wenden Sie sich bitte an den Support, bevor Sie es erneut versuchen oder andere Änderungen vornehmen. Einbeziehen:
- Die CRN der Bereitstellung und die ID der fehlgeschlagenen Aufgabe. Notieren Sie die Aufgaben-ID, wenn die Aufgabe fehlschlägt, da in den Aufgabenlisten nur die letzten Aufgaben angezeigt werden.
- Die Quell- und die gewünschte Zielversion von PostgreSQL sowie die Ausgabe von
SHOW server_version;. - Die ungefähre Ausfallzeit und die Zeitzone.
- Ob Anwendungen eine Verbindung herstellen, Daten lesen und schreiben können.
- Die Ausgabe der Selbstprüfungsabfragen.
- Die CRN jeder zugehörigen schreibgeschützten Replik, einschließlich aller kürzlich hochgestuften oder gelöschten Repliken.
Sollte die Anfrage aufgrund eines internen Fehlers fehlschlagen, wenden Sie sich bitte an den Support. In der Benutzeroberfläche wird dieser Fehler mit der Meldung Upgrade fehlgeschlagen und dem Hinweis Die In-Place-Upgrade-Aufgabe konnte nicht erstellt werden angezeigt. Die Benutzeroberfläche zeigt diese Meldung auch bei anderen abgelehnten Anfragen an, wenn der tatsächliche Grund nicht angezeigt werden kann. Um den Grund dafür zu erfahren, senden Sie die Anfrage über die CLI oder die API. Wenden
Sie sich außerdem an den Support, wenn die Aufgabe deutlich länger dauert als bei Ihrem Testlauf. Nach einem Ausfall kann die Aufgabe weiterhin als in Bearbeitung angezeigt werden (Status running in der CLI und API), während
der Dienst versucht, den Betrieb wiederherzustellen.
Entfernen Sie nur die Objekte, die in den Vorbereitungsschritten und den Fragen zur Selbstüberprüfung aufgeführt sind. Lassen Sie keine anderen Objekte fallen, um eine Kontrolle zu umgehen. Wenden Sie sich stattdessen an den Support.
Upgrade von einem Nur-Lese-Replikat durchführen
Erstellen Sie eine schreibgeschützte Replik der Quellbereitstellung und warten Sie, bis die Replik synchronisiert ist. Führen Sie anschließend die
Replikation und Aktualisierung mithilfe des /remotes/promotion Endpunkts durch. Legen Sie ein Ziel version fest, das die Replik
in ihren Funktionen auflistet:
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
}
}'
Setzen Sie den Wert true nur dann auf skip_initial_backup, wenn Sie die durch die Promotion erzeugte Erstsicherung überspringen möchten. Diese Einstellung kann den Promotionsvorgang verkürzen, allerdings erfordert die
Wiederherstellung aus der promoteten Bereitstellung anschließend eine erfolgreiche geplante oder bedarfsgesteuerte Sicherung.
Wenn eine Promotion mit einem Versions-Upgrade fehlschlägt, deaktiviert der Dienst die promotete Bereitstellung. Wenden Sie sich an den Support. Testen Sie eine Promotion mit einem Versions-Upgrade zunächst auf einer Replik einer Staging-Umgebung, bevor Sie sich darauf verlassen.
Upgrade durch Wiederherstellung eines Backups
Stellen Sie ein Backup in einer Bereitstellung wieder her, die eine unterstützte Zielversion verwendet. Wenn Sie ein Backup mithilfe der CLI oder der API wiederherstellen und keine Parameter für die Ressourcenzuweisung angeben, verwendet die neue Bereitstellung die Ressourcenzuweisungen, die die Quellbereitstellung zum Zeitpunkt der Erstellung des Backups hatte. In der Benutzeroberfläche beginnt die Seite Wiederherstellen mit den aktuellen Zuweisungen der Quellbereitstellung, die Sie ändern können.
Sicherung über die Benutzerschnittstelle wiederherstellen
Klicken Sie im Bereitstellungs-Dashboard unter Backups und Wiederherstellung auf Backup wiederherstellen für das Backup, das Sie verwenden möchten. Wählen Sie auf der sich öffnenden Seite unter Datenbankversion eine unterstützte Zielversion aus und konfigurieren Sie die Optionen für die neue Bereitstellung. Klicken Sie anschließend auf Sicherung wiederherstellen.
Wiederherstellung eines Backups über die CLI
Erstellen Sie die Bereitstellung mit der Zielversion und der Backup-ID im -p JSON-Argument:
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"
Sicherung über die Anwendungsprogrammierschnittstelle (API) wiederherstellen
Verwenden Sie die Resource-Controller-API, um ein Backup in einer neuen Bereitstellung wiederherzustellen, auf der die Zielversion ausgeführt wird. Geben Sie den Namen der Bereitstellung, den Standort, die Ressourcengruppe, den Tarif, die Backup-ID und die Zielversion an:
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"
}
}'
Erzwungenes Upgrade
Nach Ablauf des End-of-Life-Datums werden alle aktiven Databases for PostgreSQL-Bereitstellungen, auf denen die veraltete Version ausgeführt wird, automatisch auf die nächste unterstützte Version aktualisiert.
Ein erzwungenes Upgrade ist ein IPMVU. Schließen Sie daher die IPMVU-Vorbereitungen vor dem Ende der Lebensdauer ab.
Rüsten Sie vor dem End-of-Life-Datum auf, um die folgenden Risiken zu vermeiden:
- Für diese Art von erzwungenem Upgrade sind keine SLAs vorgesehen.
- Es kann zu Datenverlusten kommen.
- Es kann zu längeren Ausfallzeiten Ihrer Anwendung kommen.
- Ihre Anwendung funktioniert möglicherweise nicht mehr, wenn sie mit der neuen Version nicht kompatibel ist.
- Sie haben keinen Einfluss darauf, wann dieses Upgrade für Ihren Einsatz durchgeführt wird.
- Für dieses erzwungene Upgrade gibt es keinen Rollback-Prozess.
- Wenn Terraform die Bereitstellung verwaltet und festlegt
version, schlägtterraform planjeder Versuch nach dem erzwungenen Upgrade fehl, bis Sie aktualisierenversion.
Die Termine für das Ende des Lebenszyklus finden Sie auf der Seite mit den Versionsrichtlinien.
Probleme mit Rollenberechtigungen bei Versions-Upgrades
In PostgreSQL 16 und höher benötigt eine Rolle mit dem Attribut CREATEROLE, wie z. B. admin, die Berechtigung ADMIN OPTION auf eine andere Rolle, um diese verwalten zu können. Zur Verwaltung einer Rolle
gehören das Ändern ihres Passworts oder ihrer Attribute, das Löschen der Rolle sowie die Vergabe von Mitgliedschaften. Bei einem Upgrade von PostgreSQL 14 oder 15 auf 16 oder höher steht diese admin Option für Rollen, die bereits
vor dem Upgrade existierten, nicht zur Verfügung. Jobs, die diese Rollen verwalten admin, wie z. B. die Passwortrotation, schlagen dann fehl. Weitere Informationen finden Sie in den Versionshinweisen zu PostgreSQL 16, den Rollenattributen und den Rollenberechtigungen.
Beispiel: Eine Passwortänderung schlägt fehl mit:
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.
Führen Sie vor dem Upgrade die folgende Abfrage als admin. aus. Darin sind die Rollen aufgeführt, die nach dem Upgrade nicht admin mehr verwaltet werden können – mit Ausnahme der Benutzer, die Sie über die Benutzeroberfläche,
die CLI oder die API anlegen. Ab PostgreSQL 16 können diese Benutzer ebenfalls nicht admin mehr geändert werden; verwalten Sie sie daher über die Benutzeroberfläche, die Befehlszeilenschnittstelle (CLI) oder die 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;
Um eine aufgeführte Rolle weiterhin verwalten zu können, weisen Sie sie vor admin dem Upgrade zu:
GRANT <role_name> TO admin WITH ADMIN OPTION;
Diese Berechtigung wird für eine Rolle mit dem Wert member_of_admin abgelehnt t, da diese Rolle Mitglied von ist admin. Nach dem Upgrade kann eine solche Rolle nicht admin mehr verwaltet werden.
Führen Sie die Abfrage nach einem Upgrade auf PostgreSQL 16 oder höher erneut aus. Führen Sie für jede aufgeführte Rolle, deren member_of_admin Wert ist f, das folgende Hilfsprogramm aus, während Sie mit oder ibmclouddb einer beliebigen anderen Datenbank außer verbunden sind postgres. Fügen Sie keine weiteren Rollen hinzu, da eine fehlgeschlagene Berechtigungsvergabe den gesamten Aufruf abbricht. Sie können den Helper problemlos mehrmals ausführen:
SELECT grant_admin_option_to_roles('role1', 'role2', 'role3');
Beide Berechtigungen machen zu admin einem Mitglied der Rolle, sodass die Berechtigungen der Rolle nutzen admin kann.