05 November 2026

Wie plant man ein PostgreSQL Major Upgrade?

Steinerne Säule im Bau mit Gerüst, Arbeiter setzen Kapitell auf, weiches Tageslicht beleuchtet die Sandsteintextur.
KI-generiertes Bild

Ein PostgreSQL® Major Upgrade ist eine der anspruchsvollsten Wartungsaufgaben im Datenbankbetrieb. Anders als bei Minor-Updates wechseln Sie dabei zwischen Hauptversionen, was Änderungen am internen Datenformat, an Systemkatalogen und teilweise an der SQL-Syntax mit sich bringt. Mit der richtigen Vorbereitung lässt sich der Versionswechsel jedoch strukturiert und risikoarm durchführen.

Diese Anleitung führt Sie Schritt für Schritt durch einen PostgreSQL-Versionswechsel: von der ersten Bestandsaufnahme über die Wahl der Upgrade-Methode bis zur abschließenden Freigabe des Produktionssystems. Folgen Sie den Schritten in der angegebenen Reihenfolge, um typische Fallstricke zu vermeiden und die Ausfallzeit so gering wie möglich zu halten.

Voraussetzungen für ein PostgreSQL Major Upgrade prüfen

Bevor Sie mit dem eigentlichen PostgreSQL-Upgrade planen, verschaffen Sie sich einen vollständigen Überblick über Ihre aktuelle Umgebung. Unvollständige Informationen in dieser Phase sind die häufigste Ursache für unerwartete Probleme während des Upgrades.

  1. Ermitteln Sie die exakte Quell- und Zielversion mit SELECT version(); und prüfen Sie den offiziellen PostgreSQL-Supportzeitraum für die Zielversion.
  2. Inventarisieren Sie alle installierten Erweiterungen (SELECT * FROM pg_extension;) und prüfen Sie für jede Erweiterung, ob eine kompatible Version für die Zielversion verfügbar ist.
  3. Prüfen Sie die Größe aller Datenbanken (SELECT pg_size_pretty(pg_database_size(datname)) FROM pg_database;), um den Speicherbedarf für das Upgrade zu kalkulieren.
  4. Dokumentieren Sie alle Replikations-Setups, Verbindungspooler (z.B. PgBouncer), externe Monitoring-Agenten und Backup-Werkzeuge, die nach dem Upgrade neu konfiguriert werden müssen.
  5. Lesen Sie die Release Notes der Zielversion sorgfältig und markieren Sie alle Änderungen, die Ihre Applikationen oder Abfragen betreffen könnten.

Nach diesem Schritt sollten Sie eine vollständige Liste aller Abhängigkeiten, Erweiterungen und potenziellen Inkompatibilitäten vorliegen haben. Erst wenn diese Liste vollständig ist, ist die Grundlage für eine realistische Upgrade-Planung gelegt.

Upgrade-Strategie und Methode auswählen

Für ein PostgreSQL-Datenbankupgrade stehen Ihnen grundsätzlich drei Methoden zur Verfügung. Die Wahl hängt von Ihrer tolerierbaren Ausfallzeit, der Datenbankgröße und den verfügbaren Ressourcen ab.

  • pg_upgrade: Das offizielle Werkzeug für In-Place-Upgrades. Es konvertiert die Datendateien direkt und ist für die meisten Umgebungen die schnellste Methode mit minimaler Ausfallzeit.
  • Logische Replikation: Ermöglicht Near-Zero-Downtime-Upgrades, indem eine neue Instanz parallel betrieben und per logischer Replikation synchron gehalten wird. Geeignet für Umgebungen mit sehr hohen Verfügbarkeitsanforderungen.
  • Dump und Restore: Klassische Methode über pg_dumpall und anschließenden Import. Einfach und zuverlässig, aber bei großen Datenbanken zeitaufwändig und mit längerer Ausfallzeit verbunden.

Wählen Sie pg_upgrade, wenn Sie eine einzelne Instanz ohne komplexe Replikation betreiben und ein Wartungsfenster von wenigen Stunden akzeptabel ist. Entscheiden Sie sich für die logische Replikation, wenn Ihre SLA eine maximale Ausfallzeit von wenigen Minuten vorschreibt. Der Dump-und-Restore-Ansatz eignet sich vor allem für kleinere Datenbanken oder wenn eine vollständige Neueinrichtung ohnehin geplant ist. Halten Sie Ihre Entscheidung schriftlich fest, damit alle Beteiligten die gleiche Methode umsetzen.

Testumgebung aufbauen und Upgrade-Lauf simulieren

Führen Sie das PostgreSQL Major Upgrade niemals zuerst in der Produktion durch. Eine realistische Testumgebung ist keine optionale Maßnahme, sondern eine zwingende Voraussetzung für ein sicheres Upgrade.

  1. Erstellen Sie einen aktuellen Dump oder einen Snapshot der Produktionsdatenbank und spielen Sie ihn in eine isolierte Testumgebung ein, die der Produktionsumgebung möglichst genau entspricht.
  2. Installieren Sie die Zielversion von PostgreSQL® parallel zur bestehenden Installation und stellen Sie sicher, dass alle benötigten Erweiterungen in der kompatiblen Version vorliegen.
  3. Führen Sie das Upgrade mit der gewählten Methode vollständig durch und dokumentieren Sie jeden Schritt sowie alle aufgetretenen Fehlermeldungen.
  4. Messen Sie die Gesamtdauer des Upgrade-Laufs, um ein realistisches Wartungsfenster für die Produktion planen zu können.
  5. Führen Sie nach dem Testupgrade einen vollständigen Regressionstest Ihrer Applikationen durch und prüfen Sie, ob alle Abfragen korrekte Ergebnisse liefern.

Wenn der Testlauf Fehler oder Inkompatibilitäten aufgedeckt hat, beheben Sie diese vollständig und wiederholen Sie den Testlauf, bis er fehlerfrei abläuft. Erst ein sauberer, dokumentierter Testlauf gibt Ihnen die Sicherheit, das PostgreSQL Upgrade in der Produktion erfolgreich durchzuführen.

Produktions-Upgrade durchführen und absichern

Wenn die Testumgebung erfolgreich validiert wurde, beginnen Sie das Produktions-Upgrade zum geplanten Wartungsfenster. Kommunizieren Sie den geplanten Ausfall rechtzeitig an alle betroffenen Teams.

Vor dem Upgrade

  1. Erstellen Sie unmittelbar vor dem Upgrade ein vollständiges, verifiziertes Backup, das im Notfall als Rückkehrpunkt dient.
  2. Stoppen Sie alle Applikationen, Verbindungspooler und Dienste, die auf die Datenbank zugreifen, und stellen Sie sicher, dass keine aktiven Verbindungen mehr bestehen (SELECT count(*) FROM pg_stat_activity;).
  3. Deaktivieren Sie automatische Prozesse wie Cronjobs oder Monitoring-Agenten, die während des Upgrades ungewollt Verbindungen aufbauen könnten.

Während des Upgrades

  1. Führen Sie den Upgrade-Prozess exakt nach dem in der Testumgebung dokumentierten Ablauf durch. Weichen Sie nicht spontan von der geplanten Vorgehensweise ab.
  2. Protokollieren Sie alle Ausgaben und Fehlermeldungen in eine Logdatei, um im Fehlerfall schnell reagieren zu können.
  3. Prüfen Sie nach Abschluss des Upgrades, ob der PostgreSQL-Dienst mit der neuen Version gestartet ist (SELECT version();).

Halten Sie während des gesamten Upgrade-Vorgangs einen definierten Rollback-Plan bereit. Wenn schwerwiegende Fehler auftreten, die nicht innerhalb des Wartungsfensters behebbar sind, stellen Sie das Backup wieder her, anstatt improvisierte Lösungen in der Produktion zu versuchen.

Upgrade validieren und Systeme wieder freigeben

Nach dem technischen Abschluss des Upgrades beginnt die Validierungsphase. Geben Sie die Systeme erst frei, wenn alle Prüfpunkte bestanden sind.

  1. Führen Sie ANALYZE auf allen Datenbanken aus, damit der Query Planner aktuelle Statistiken erhält. Bei pg_upgrade wird dies oft automatisch als Skript bereitgestellt.
  2. Starten Sie die Applikationen nacheinander und beobachten Sie die Logs auf Fehler, Verbindungsprobleme oder unerwartetes Verhalten.
  3. Führen Sie einen definierten Satz von Smoke-Tests durch, der die kritischsten Geschäftsfunktionen abdeckt.
  4. Prüfen Sie die Performance-Metriken (Abfragezeiten, Cache-Hit-Rate, Verbindungsanzahl) und vergleichen Sie sie mit den Baseline-Werten aus der Vorproduktion.
  5. Überwachen Sie das System in den ersten 24 bis 48 Stunden intensiv, bevor Sie das Wartungsfenster offiziell schließen.

Wenn alle Tests bestanden sind und die Performance im erwarteten Bereich liegt, können Sie die alten Datendateien der Vorgängerversion entfernen. Bewahren Sie diese jedoch so lange auf, bis Sie sicher sind, dass kein Rollback mehr erforderlich ist. Ein langfristiger Betrieb der neuen Version beginnt erst nach vollständiger Freigabe.

Häufige Fehler beim PostgreSQL Major Upgrade beheben

Auch bei sorgfältiger Vorbereitung können beim PostgreSQL-Versionswechsel Probleme auftreten. Die folgenden Fehler begegnen uns in der Praxis besonders häufig, zusammen mit den bewährten Lösungsansätzen.

Inkompatible Erweiterungen

Wenn pg_upgrade mit einem Fehler zu einer Erweiterung abbricht, fehlt entweder die Erweiterung für die Zielversion oder sie ist in einer inkompatiblen Version installiert. Prüfen Sie zunächst, ob eine aktualisierte Version der Erweiterung verfügbar ist. Falls nicht, müssen Sie die Erweiterung vor dem Upgrade deinstallieren und nach dem Upgrade in der neuen Version neu installieren. Tragen Sie diesen Schritt in Ihren Upgrade-Plan ein, damit er nicht vergessen wird.

Geänderte Standardwerte und Konfigurationsparameter

Neue PostgreSQL-Versionen ändern gelegentlich die Standardwerte von Konfigurationsparametern oder entfernen veraltete Parameter. Vergleichen Sie Ihre bestehende postgresql.conf mit den Release Notes der Zielversion und passen Sie die Konfiguration entsprechend an. Parameter, die in der neuen Version nicht mehr existieren, führen beim Start zu Fehlern und müssen entfernt werden.

Performance-Regressionen nach dem Upgrade

Wenn bestimmte Abfragen nach dem Upgrade deutlich langsamer sind, liegt das häufig an veralteten oder fehlenden Planer-Statistiken. Führen Sie VACUUM ANALYZE auf den betroffenen Tabellen aus. In einigen Fällen hilft es, den Query Planner mit pg_stat_statements zu analysieren und gezielt Indizes oder Konfigurationsparameter anzupassen. Vergleichen Sie die Ausführungspläne mit EXPLAIN ANALYZE vor und nach dem Upgrade, um die Ursache zu isolieren.

Wie credativ® beim PostgreSQL Major Upgrade unterstützt

Ein PostgreSQL Major Upgrade ist ein komplexes Vorhaben, das technische Tiefe, sorgfältige Planung und Erfahrung mit realen Upgrade-Szenarien erfordert. Als PostgreSQL® Competence Center unterstützen wir Unternehmen in allen Phasen des Upgrade-Prozesses, von der ersten Bestandsaufnahme bis zum stabilen Betrieb der neuen Version.

Unser Leistungsumfang für PostgreSQL Major Upgrades umfasst unter anderem:

  • Analyse der bestehenden Umgebung und Identifikation von Inkompatibilitäten und Risiken
  • Auswahl und Planung der geeigneten Upgrade-Methode (pg_upgrade, logische Replikation, Dump und Restore)
  • Aufbau und Durchführung von Testläufen in isolierten Umgebungen
  • Begleitung und Durchführung des Produktions-Upgrades im Wartungsfenster
  • Einrichtung von Monitoring, High Availability und Replikation nach dem Upgrade
  • Individuelle Schulungen und Workshops für Ihre Datenbankteams

Unsere Spezialisten sind festangestellt, arbeiten ohne Callcenter und stehen Ihnen direkt zur Verfügung, per Telefon, Ticket-System oder E-Mail, auf Deutsch und Englisch. Kontaktieren Sie uns, um Ihr PostgreSQL Major Upgrade gemeinsam zu planen.

Transparenzhinweis: PostgreSQL® ist eine Marke der PostgreSQL Community Association of Canada. credativ® ist Competence Center für PostgreSQL®. Die Nennung dient ausschließlich der sachlichen Beschreibung von Dienstleistungen von credativ®. Es besteht keine geschäftliche Verbindung zu den genannten Markeninhabern über die genannte Rolle hinaus.

Ähnliche Artikel

Kategorien: credativ® Inside

über den Autor

Peter Dreuw

Head of Sales & Marketing

zur Person

Peter Dreuw arbeitet seit 2016 für die credativ GmbH und ist seit 2017 Teamleiter. Seit 2021 ist er Teil des Management-Teams als VP Services der Instaclustr. Mit der Übernahme durch die NetApp wurde seine neue Rolle "Senior Manager Open Source Professional Services". Im Rahmen der Ausgründung wurde er Mitglied der Geschäftsleitung als Prokurist. Sein Aufgabenfeld ist die Leitung des Vertriebs und des Marketings. Er ist Linux-Nutzer der ersten Stunden und betreibt Linux-Systeme seit Kernel 0.97. Trotz umfangreicher Erfahrung im operativen Bereich ist er leidenschaftlicher Softwareentwickler und kennt sich auch mit hardwarenahen Systemen gut aus.

Beiträge ansehen


Beitrag teilen: