Upgrade auf eine neue übergeordnete Version durchführen

Wählen Sie einen Upgrade-Pfad:

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.

  1. 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';
    
  2. Alle Maskierungsregeln entfernen.

    SELECT anon.remove_masks_for_all_columns();
    
  3. Entfernen Sie die maskierte Bezeichnung aus jeder in Schritt 1 aufgeführten Rolle. Ab PostgreSQL 16 erfordert diese Aktion die Option ADMIN für die Rolle. Weitere Informationen finden Sie unter Probleme mit Rollenberechtigungen bei Versions-Upgrades.

    SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
    
  4. Lassen Sie die Erweiterung anon mit der Option "Kaskade" weg. Die Option cascade entfernt auch Objekte, die von abhängen anon, wie beispielsweise Maskierungsansichten und Funktionen. Notieren Sie deren Definitionen, damit Sie sie nach dem Upgrade wiederherstellen können.

    DROP EXTENSION anon CASCADE;
    
  5. 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_function bei einer Ihrer eigenen Funktionen in PostgreSQL 14 oder 15 um handelt, fügen Sie ihr die Einstellung search_path hinzu:

    ALTER FUNCTION <used_function> SET search_path = ibm_extension, pg_catalog;
    
  • Wenn es sich used_function bei einer Funktion earthdistance in 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 um ALTER TABLE <table_name> ALTER COLUMN <column_name> DROP EXPRESSION;. Führen Sie nach dem Upgrade den Befehl aus ALTER 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_cron sowie 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:

  1. Erfassen Sie den Namen, das Plug-in und die Datenbank jedes Slots mit der Selbstprüfungsabfrage 2.

  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.

  3. 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.

  4. Löschen Sie jeden Slot mit dem Befehl ibmcloud cdb postgresql replication-slot-delete oder der API Delete a logical replication slot. Der Benutzer admin kann Replikationsslots nicht mit SQL löschen.

    ibmcloud cdb postgresql replication-slot-delete <NAME|CRN> <SLOT_NAME>
    
  5. 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 UNLOGGED Tabellen und zurückgesetzten UNLOGGED Sequenzen.

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 auch SET LOGGED die 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 Funktion setval auf 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.

IPMVU-Phasen und Verfügbarkeit
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 Tabellen UNLOGGED und 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 TABLE COPY, pg_restore, CREATE TABLE AS, CREATE MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW, und, die eine Tabelle umschreiben, wie beispielsweise SET 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_commit der Bereitstellung auf gesetzt haben on, ändern Sie diese auf, bevor local Sie das Upgrade übermitteln. Ändern Sie dies wieder zurück, sobald die Aufgabe als Abgeschlossen angezeigt wird. Bei kann ein fehlgeschlagenes Upgrade dazu führen on, 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, on wenn die folgende Abfrage on mit der Quelle das Ergebnis liefert configuration 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> versions
    

    Verwenden Sie in der Ausgabe den Wert to_version eines 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.

IPMVU-Vorabprüfungen
Ü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.

Fehler, die bei den Vorabprüfungen nicht erkannt werden
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.

  1. 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 bedeutet pg_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;
    
  2. Logische Replikationsslots. Es sind keine Zeilen zu erwarten.

    SELECT slot_name, plugin, database, active
    FROM pg_catalog.pg_replication_slots
    WHERE slot_type = 'logical';
    
  3. Logische Abonnements. Bei PostgreSQL, Version 16 und früheren Versionen sind keine Zeilen zu erwarten. Bei PostgreSQL 17 ist in f der Spalte subenabled jeder 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;
    
  4. Vorbereitete Transaktionen. Es sind keine Zeilen zu erwarten.

    SELECT gid, owner, database, prepared
    FROM pg_catalog.pg_prepared_xacts;
    
  5. Archivierung von Transaktionsprotokollen. Es ist zu erwarten, last_failed_time dass leer ist oder kleiner als last_archived_time ist und waiting_files dass 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';
    
  6. 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ält template0, 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);
    
  7. Rollen und Datenbankeinstellungen. Stellen Sie sicher, dass jeder Parameter in in der Zielversion vorhanden setconfig ist. 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 auf default_transaction_read_only einen falschen Wert gesetzt ist, wie z. B. off, false, no, oder 0. Notieren Sie jede Datenbank, in der diese Einstellung festgelegt ist default_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;
    
  8. 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_type Spalte wird der Typ angezeigt, der das Upgrade verhindert. Der Typ aclitem blockiert 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;
    
  9. 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 aus ALTER 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;
    
  10. 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;
    
  11. UNLOGGED Tabellen 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 Tabellen UNLOGGED und 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');
    
  12. SQL-Funktionen, die dazu führen können, dass die Konvertierung fehlschlägt. Es sind keine Zeilen zu erwarten. Die Abfrage listet Funktionen LANGUAGE sql mit 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;
    
  13. Indizes und gespeicherte generierte Spalten, die Version earthdistance 1.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 unter earthdistance.

    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;
    
  14. 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_in zeigt die erste Version ohne den Namen an. Es sind keine Zeilen mit einer Version removed_in zu 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;
    
  15. 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 Attribut CREATEDB verfü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;
    
  16. Beziehungen, die durch das Upgrade gesperrt werden, große Objekte und die Sperrkapazität der Bereitstellung. Addieren Sie die Werte der locked_relations vier Datenbanken mit den höchsten Werten. Bei PostgreSQL, Version 14 und 15, sind auch Views und materialisierte Views locked_relations enthalten, da diese beim Upgrade ebenfalls gesperrt werden. Wenn die Gesamtsumme überschritten wird lock_capacity, erhöhen Sie so lange, max_locks_per_transaction bis die Gesamtsumme lock_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;
    
  17. 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 ohne pg_catalog deren 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ßerhalb pg_catalog mit seinem Schema benennt. Für jede weitere aufgeführte Funktion fügt deren Eigentümer eine search_path Einstellung 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

  1. Erstellen und überprüfen Sie ein On-Demand-Backup. Das Upgrade dauert nicht lange.
  2. Klicken Sie auf der Übersichtsseite der Bereitstellung auf Hauptversion aktualisieren.
  3. Ü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.
  4. 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.
  5. 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.
  6. 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.
  7. 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:

  1. 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 verbleibt pg_basebackup oder 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=%');
    
  2. 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_time blk_read_time und in shared_blk_read_time und umbenannt pg_stat_statements``shared_blk_write_time. Aktualisieren Sie die Abfragen, die diese Spalten auslesen.

  3. Stellen Sie die Erweiterungen und die Maskierung wie in der Vorbereitung beschrieben wieder her. Laden Sie die Tabellen UNLOGGED aus den von Ihnen exportierten Inhalten neu. Stellen Sie jede UNLOGGED Sequenz über die derzeit verwendeten Werte hinaus ein, zum Beispiel mit SELECT 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.

  4. Wenn Sie default_transaction_read_only fü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.

  5. 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.

  6. 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.

  7. Wenn Terraform die Bereitstellung verwaltet und Sie das Upgrade außerhalb von Terraform durchgeführt haben, setzen Sie auf version die neue Version oder entfernen Sie es, wie unter Upgrade über Terraform beschrieben.

  8. 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.

  9. 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 verwenden is_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(), oder initcap() auf Text in der integrierten Lokalisierung C.UTF-8 anwenden. Die pg_c_utf8 Sortierreihenfolge und Datenbanken, die den builtin Locale-Anbieter verwenden, nutzen C.UTF-8 diese Locale.
    • Wenn Sie ein Upgrade auf PostgreSQL 18 durchgeführt haben und eine Datenbank den builtin Locale-Anbieter icu oder verwendet, erstellen Sie die Volltextsuche und die Indizes pg_trgm neu.

    Führen Sie dies REINDEX INDEX <index_name>; für jeden betroffenen Index und REFRESH 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.

  10. 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 UNLOGGED Tabellen entfernen old_snapshot, leere Tabellen löschen, UNLOGGED Sequenzen zurücksetzen und eine Lücke in der PITR-Abdeckung hinterlassen. Außerdem können damit default_transaction_read_only Einstellungen auf Datenbankebene zurückgesetzt werden, sodass diese Datenbanken wieder Schreibvorgänge akzeptieren. Wenn Sie für on eine beliebige Datenbank den Wert auf default_transaction_read_only setzen, 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ägt terraform plan jeder Versuch nach dem erzwungenen Upgrade fehl, bis Sie aktualisieren version.

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.

Änderungsprotokoll für PostgreSQL-Hauptversionen