Durchführen eines Hauptversions-Upgrades

Wählen Sie die gewünschte Hauptversion aus der Liste der verfügbaren Ziele aus, die für Ihre Version in der Tabelle aufgeführt sind. Sie können eine genaue Liste der in Ihrer AWS-Region aktuellen Version verfügbaren Versionen abrufen, indem Sie die verwenden AWS CLI. Details hierzu finden Sie unter Abrufen einer Liste der verfügbaren Versionen in Ihrem AWS-Region.

Stellen Sie sicher, dass Ihre Anwendungen bei einer Testbereitstellung der neuen Version erwartungsgemäß funktionieren. Weitere Informationen zum vollständigen Prozess finden Sie unter Testen eines Upgrades Ihres Produktions-DB-Clusters auf eine neue Hauptversion.

Nachdem Sie überprüft haben, dass Ihre Anwendungen bei der Testbereitstellung wie erwartet funktionieren, können Sie Ihren Cluster aktualisieren. Details hierzu finden Sie unter Upgrade der Aurora-PostgreSQL-Engine auf eine neue Hauptversion.

Halten Sie eine versionskompatible Parametergruppe bereit.

Wenn Sie eine benutzerdefinierte DB-Instance- oder DB-Cluster-Parametergruppe verwenden, haben Sie zwei Möglichkeiten:

Wenn Sie eine neue DB-Instance- oder eine neue DB-Cluster-Parametergruppe als Teil der Upgrade-Anforderung zuordnen, stellen Sie sicher, dass Sie die Datenbank nach Abschluss des Upgrades neu starten, um die Parameter anzuwenden. Wenn eine DB-Instance neu gestartet werden muss, um die Änderungen der Parametergruppe zu übernehmen, wird als Parametergruppenstatus der Instance angegebe pending-reboot. Sie können den Parametergruppenstatus einer Instance in der Konsole anzeigen oder einen CLI-Befehl, wie z. B. describe-db-instances oder describe-db-clusters, verwenden.

Suchen Sie nach ungültigen Datenbanken und löschen Sie alle vorhandenen.

Die datconnlimit Spalte im pg_database Katalog enthält den Wert, -2 um alle Datenbanken, die während eines DROP DATABASE Vorgangs unterbrochen wurden, als ungültig zu kennzeichnen. Verwenden Sie die folgende Abfrage, um zu überprüfen, ob ungültige Datenbanken existieren.

SELECT
    datname
FROM
    pg_database
WHERE
    datconnlimit = - 2;

Wenn die Abfrage Datenbanknamen zurückgibt, sind diese Datenbanken ungültig. Verwenden Sie die DROP DATABASE invalid_db_name Anweisung, um ungültige Datenbanken zu löschen. Sie können die folgende dynamische Anweisung verwenden, um alle ungültigen Datenbanken zu löschen.

SELECT
    'DROP DATABASE ' || quote_ident(datname) || ';'
FROM
    pg_database
WHERE
    datconnlimit = -2 \gexec

Auf nicht unterstützte Verwendung prüfen:

Suchen Sie nach den Datenbanken Template1 und Template0.

Für ein erfolgreiches Upgrade müssen die Datenbanken Template 1 und Template 0 vorhanden sein und sollten als Vorlage aufgeführt werden. Verwenden Sie den folgenden Befehl, um dies zu überprüfen:

SELECT datname, datistemplate FROM pg_database; 
                        
datname    | datistemplate
-----------+---------------
template0  | t
rdsadmin   | f
template1  | t
postgres   | f

In der Befehlsausgabe sollte der Wert datistemplate für die Datenbanken template1 und template0 t lauten.

Entfernen von logischen Replikations-Slots.

Der Upgrade-Vorgang kann nicht fortgesetzt werden, wenn der Aurora PostgreSQL DB-Cluster logische Replikations-Slots verwendet. Logische Replikationssteckplätze werden in der Regel für kurzfristige Datenmigrationsaufgaben verwendet, z. B. für die Migration von Daten mithilfe von AWS DMS oder für die Replikation von Tabellen aus der Datenbank in Data Lakes, BI-Tools oder andere Ziele. Vergewissern Sie sich vor dem Upgrade, dass Sie den Zweck der vorhandenen logischen Replikations-Slots kennen, und bestätigen Sie, dass sie gelöscht werden dürfen. Sie können mit der folgenden Abfrage nach logischen Replikationssteckplätzen suchen:

SELECT * FROM pg_replication_slots;

Wenn die logischen Replikations-Slots noch verwendet werden, sollten Sie sie nicht löschen, und Sie können mit dem Upgrade nicht fortfahren. Wenn die logischen Replikations-Slots jedoch nicht benötigt werden, können Sie sie mit folgendem SQL-Befehl löschen:

SELECT pg_drop_replication_slot(slot_name);

Für logische Replikationsszenarien, die die pglogical-Erweiterung verwenden, müssen außerdem Slots vom Herausgeberknoten gelöscht werden, damit ein Hauptversions-Upgrade auf diesem Knoten erfolgreich durchgeführt werden kann. Sie können den Replikationsprozess jedoch nach dem Upgrade vom Abonnentenknoten aus neu starten. Weitere Informationen finden Sie unter Wiederherstellung der logischen Replikation nach einem Hauptversions-Upgrade.

Führen Sie ein Backup durch.

Der Aktualisierungsprozess erstellt während des Upgrades einen DB-Cluster-Snapshot des DB-Clusters. Wenn Sie vor dem Upgrade auch ein manuelles Backup durchführen möchten, finden Sie weitere Informationen unter Erstellen eines DB-Cluster-Snapshots.

Aktualisieren Sie bestimmte Erweiterungen auf die neueste verfügbare Version, bevor Sie das Upgrade der Hauptversion durchführen. Zu den Erweiterungen, die aktualisiert werden sollen, gehören folgende:

Führen Sie den folgenden Befehl für jede derzeit installierte Erweiterung aus.

ALTER EXTENSION PostgreSQL-extension UPDATE TO 'new-version';

Weitere Informationen finden Sie unter Aktualisieren von PostgreSQL-Erweiterungen. Weitere Informationen zum Aktualisieren von PostGIS finden Sie unterSchritt 6: Aktualisieren Sie die GIS Post-Erweiterung.

Wenn Sie ein Upgrade auf Version 11.x durchführen, löschen Sie die Erweiterungen, die nicht unterstützt werden, bevor Sie das Upgrade der Hauptversion durchführen. Die zu löschenden Erweiterungen umfassen:

Löschen Sie unknown-Datentypen, abhängig von Ihrer Zielversion.

PostgreSQL-Version 10 unterstützt den Datentyp unknown nicht. Wenn eine Datenbank der Version 9.6 den Datentyp unknown verwendet, wird bei einem Upgrade auf Version 10 eine Fehlermeldung wie die folgende angezeigt.

Database instance is in a state that cannot be upgraded: PreUpgrade checks failed: 
The instance could not be upgraded because the 'unknown' data type is used in user tables. 
Please remove all usages of the 'unknown' data type and try again."

Verwenden Sie den folgenden SQL-Code für jede Datenbank, um den unknown-Datentyp in Ihrer Datenbank zu finden, damit Sie solche Spalten entfernen oder in unterstützte Datentypen ändern können.

SELECT n.nspname, c.relname, a.attname
    FROM pg_catalog.pg_class c,
    pg_catalog.pg_namespace n,
    pg_catalog.pg_attribute a
    WHERE c.oid = a.attrelid AND NOT a.attisdropped AND
    a.atttypid = 'pg_catalog.unknown'::pg_catalog.regtype AND
    c.relkind IN ('r','m','c') AND
    c.relnamespace = n.oid AND
    n.nspname !~ '^pg_temp_' AND
    n.nspname !~ '^pg_toast_temp_' AND n.nspname NOT IN ('pg_catalog', 'information_schema');

Führen Sie ein Test-Upgrade durch.

Es wird dringend empfohlen, das Upgrade der Hauptversion auf einem Duplikat Ihrer Produktionsdatenbank zu testen, bevor Sie versuchen, das Upgrade für Ihre Produktionsdatenbank auszuführen. Sie können die Ausführungspläne auf der duplizierten Testinstance auf mögliche Regressionen des Ausführungsplans überwachen und deren Leistung bewerten. Um ein Duplikat der Test-Instance zu erstellen, können Sie Ihre Datenbank entweder aus einem aktuellen Snapshot wiederherstellen oder Ihre Datenbank klonen. Weitere Informationen finden Sie unter Wiederherstellung aus einem Snapshot oder Klonen eines Volumes für einen Amazon-Aurora-DB-Cluster.

Weitere Informationen finden Sie unter Upgrade der Aurora-PostgreSQL-Engine auf eine neue Hauptversion.

Aktualisieren Sie Ihre Produktionsinstance.

Wenn das Hauptversions-Upgrade für den Testlauf erfolgreich ist, sollten Sie jetzt in der Lage sein, Ihre Produktionsdatenbank sicher zu aktualisieren. Weitere Informationen finden Sie unter Upgrade der Aurora-PostgreSQL-Engine auf eine neue Hauptversion.

Für Informationen zu einem laufenden Upgrade können Sie mit Amazon RDS zwei Protokolle anzeigen, die von dem pg_upgrade-Dienstprogramm erstellt werden. Diese sind pg_upgrade_internal.log und pg_upgrade_server.log. Amazon Aurora hängt einen Zeitstempel an den Dateinamen für diese Protokolle an. Sie können diese Protokolle wie jedes andere Protokoll einsehen. Weitere Informationen finden Sie unter Überwachung von Aurora Aurora-Protokolldateien.

Aktualisieren Sie PostgreSQL-Erweiterungen. Bei einem PostgreSQL-Upgrade-Prozess werden keine PostgreSQL-Erweiterungen aktualisiert. Weitere Informationen finden Sie unter Aktualisieren von PostgreSQL-Erweiterungen.