

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Aktualisierungen für die Verwaltung von Aurora PostgreSQL-Abfrageplänen
<a name="auroraqpm.updates"></a>

Die AWS `apg_plan_mgmt` Erweiterung bietet Ihrem Aurora PostgreSQL-DB-Cluster die Funktion zur Verwaltung von Abfrageplänen. Dadurch können Sie die Abfrageausführungspläne verwalten, die vom Optimierer für Ihre SQL-Anwendungen generiert wurden, um eine bessere Stabilität zu erzielen und Regressionen zu verhindern. Weitere Informationen finden Sie unter [Verwalten von Abfrageausführungsplänen für Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) im *Benutzerhandbuch für Amazon Aurora*. 

**Topics**
+ [PostgreSQL 17 Versionen](#auroraqpm-version17)
+ [PostgreSQL-16-Versionen](#auroraqpm-version16)
+ [PostgreSQL-15-Versionen](#auroraqpm-version15)
+ [PostgreSQL-14-Versionen](#auroraqpm-version14)
+ [PostgreSQL 13-Versionen](#auroraqpm-version13)
+ [PostgreSQL 12-Versionen](#auroraqpm-version12)
+ [Version 2.3 der Aurora-PostgreSQL-Erweiterung apg\$1plan\$1mgmt](#auroraqpm-version.23)
+ [Version 2.1 der Aurora-PostgreSQL-Erweiterung apg\$1plan\$1mgmt](#auroraqpm-version.21)
+ [Version 2.0 der Aurora PostgreSQL apg\$1plan\$1mgmt-Erweiterung](#auroraqpm-version.20)
+ [Version 1.0.1 der Aurora PostgreSQL apg\$1plan\$1mgmt-Erweiterung](#auroraqpm-version.101)

## PostgreSQL 17 Versionen
<a name="auroraqpm-version17"></a>

**Topics**
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 17.9, 6. April 2026](#auroraqpm-version17-179)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 17.7, 18. Dezember 2025](#auroraqpm-version17-177)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 17.5, 30. Juni 2025](#auroraqpm-version17-175)
+ [apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 17.4, 01. Mai 2025](#auroraqpm-version17-174)

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 17.9, 6. April 2026
<a name="auroraqpm-version17-179"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 17.9 gehören:

**Erweiterungsverbesserungen**
+ Es wurde ein Problem in der Abfrageplanverwaltung behoben, das dazu führte, dass Pläne nicht erfasst wurden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 17.7, 18. Dezember 2025
<a name="auroraqpm-version17-177"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 17.7 gehören:

**Erweiterungsverbesserungen**
+ Es wurde eine Verbesserung in der Abfrageplanverwaltung hinzugefügt, sodass Parameterlisten, die aus früheren Versionen gespeichert wurden, automatisch wieder erfasst werden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 17.5, 30. Juni 2025
<a name="auroraqpm-version17-175"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 17.5 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem bei der Abfrageplanverwaltung behoben, bei dem parallele Bitmap-Scans durchgesetzt wurden, wenn ein BitmapOr/BitmapAnd Operator anwesend war.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen mit der Durchsetzung von Plänen behoben, bei dem mehrere Tabellenpartitionen zu einer Tabellenpartition zusammengefügt wurden.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen behoben, bei dem Append-Knoten über einer einzelnen Tabellenpartition erzwungen wurden.
+ Die `apg_plan_mgmt` Rolle in der Abfrageplanverwaltung ist reserviert und kann nicht mehr von Benutzern erstellt, geändert oder gelöscht werden.
+ Ein Problem beim Umgang mit Parameterlisten aus früheren Versionen der Abfrageplanverwaltung wurde behoben.

### apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 17.4, 01. Mai 2025
<a name="auroraqpm-version17-174"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.8 für Aurora PostgreSQL 17.4 gehören:

**Neue Features**
+ Die Verwaltung von Abfrageplänen kann Pläne mit einer korrelierten Unterabfragetransformation erzwingen.
+ Die Verwaltung von Abfrageplänen kann Pläne mit einem korrelierten Unterabfrage-Cache erzwingen.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Parameterliste behoben, das zu einem Fehler oder einem Neustart beim Abfragen von `dba_plans` Ansichten oder Aufrufen `validate_plans` von `evolve_plan_baselines` Funktionen in der Abfrageplanverwaltung führte. 
+ Es wurde ein Problem mit der Durchsetzung von Plänen behoben, die durch korrelierte Transformationen in der Query-Planverwaltung optimiert wurden.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen behoben, bei dem unmittelbar nach der Installation der Erweiterung eine Utility-Anweisung ausgeführt oder Shared Memory zurückgesetzt wurde.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen für Abfragen mit Aufrufen unveränderlicher Funktionen in der Abfrageplanverwaltung behoben.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen in der Abfrageplanverwaltung behoben.

## PostgreSQL-16-Versionen
<a name="auroraqpm-version16"></a>

**Topics**
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 16.13, 6. April 2026](#auroraqpm-version16-1613)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 16.11, 18. Dezember 2025](#auroraqpm-version16-1611)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 16.9, 30. Juni 2025](#auroraqpm-version16-169)
+ [apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 16.8, 8. April 2025](#auroraqpm-version16-168)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 16.6, 27. Dezember 2024](#auroraqpm-version16-166)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 16.3](#auroraqpm-version16-163)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 16.2](#auroraqpm-version16-162)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 16.1](#auroraqpm-version16-161)

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 16.13, 6. April 2026
<a name="auroraqpm-version16-1613"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 16.13 gehören:

**Erweiterungsverbesserungen**
+ Es wurde ein Problem in der Abfrageplanverwaltung behoben, das dazu führte, dass Pläne nicht erfasst wurden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 16.11, 18. Dezember 2025
<a name="auroraqpm-version16-1611"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 16.11 gehören:

**Erweiterungsverbesserungen**
+ Es wurde eine Verbesserung in der Abfrageplanverwaltung hinzugefügt, sodass Parameterlisten, die aus früheren Versionen gespeichert wurden, automatisch wieder erfasst werden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 16.9, 30. Juni 2025
<a name="auroraqpm-version16-169"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 16.9 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem bei der Abfrageplanverwaltung behoben, bei dem parallele Bitmap-Scans durchgesetzt wurden, wenn ein BitmapOr/BitmapAnd Operator anwesend war.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen mit der Durchsetzung von Plänen behoben, bei dem mehrere Tabellenpartitionen zu einer Tabellenpartition zusammengefügt wurden.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen behoben, bei dem Append-Knoten über einer einzelnen Tabellenpartition erzwungen wurden.
+ Die `apg_plan_mgmt` Rolle in der Abfrageplanverwaltung ist reserviert und kann nicht mehr von Benutzern erstellt, geändert oder gelöscht werden.
+ Ein Problem beim Umgang mit Parameterlisten aus früheren Versionen der Abfrageplanverwaltung wurde behoben.

### apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 16.8, 8. April 2025
<a name="auroraqpm-version16-168"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.8 für Aurora PostgreSQL 16.8 gehören:

**Neue Features**
+ Die Verwaltung von Abfrageplänen kann Pläne mit einer korrelierten Unterabfragetransformation erzwingen.
+ Die Verwaltung von Abfrageplänen kann Pläne mit einem korrelierten Unterabfrage-Cache erzwingen.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Parameterliste behoben, das zu einem Fehler oder einem Neustart beim Abfragen von `dba_plans` Ansichten oder Aufrufen `validate_plans` von `evolve_plan_baselines` Funktionen in der Abfrageplanverwaltung führte. 
+ Es wurde ein Problem mit der Durchsetzung von Plänen behoben, die durch korrelierte Transformationen in der Query-Planverwaltung optimiert wurden.
+ Es wurde ein Problem in der Query-Planverwaltung behoben, bei dem unmittelbar nach der Installation der Erweiterung eine Utility-Anweisung ausgeführt oder Shared Memory zurückgesetzt wurde.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen für Abfragen mit Aufrufen unveränderlicher Funktionen in der Abfrageplanverwaltung behoben.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen in der Query-Planverwaltung behoben.

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 16.6, 27. Dezember 2024
<a name="auroraqpm-version16-166"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 16.6 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Planerfassung auf dem Replikat in der Abfrageplanverwaltung behoben, bei dem das gemeinsam genutzte Speicher-Array im Replikat voll wurde.
+ Es wurde ein Problem mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben, das dazu führte, dass die Aufbewahrungsfrist für den Plan nicht durchgesetzt und das Datum der letzten Verwendung nicht aktualisiert wurde.
+ Es wurde ein Problem im Zusammenhang mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben.
+ Ein Problem mit der Durchsetzung von Plänen zur Verwaltung von Abfrageplänen, die Bitmap-Scans enthalten, wurde behoben.
+ Es wurde ein Problem mit der Verwaltung von Abfrageplänen behoben, bei dem Pläne für Funktionen oder Verfahren mit mehreren Abfragen falsch erfasst wurden.
+ Es wurde ein Problem mit der Erfassung von Plänen für verschachtelte Abfrageausführungen in der Abfrageplanverwaltung behoben. 
+ Ein Problem mit der Erfassung von Plänen in der Abfrageplanverwaltung mit erweitertem Abfrageprotokoll wurde behoben. 

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 16.3
<a name="auroraqpm-version16-163"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 16.3 gehören:

**Neue Features**
+ Sie müssen das nicht mehr aktualisieren. `plan_hash_version` Nach dem Upgrade der Datenbank-Engine aktiviert QPM automatisch neue Funktionen. Sie müssen keine Maßnahmen ergreifen, damit neue Funktionen verfügbar werden.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Ein Problem mit der Durchsetzung von QPM-Plänen mit mehr als 64 partitionierten Tabellen wurde behoben.
+ Ein Problem mit der Durchsetzung von QPM-Plänen, die den Operator Append enthielten, wurde behoben.
+ Ein Problem mit QPM validate\$1plans mit der Aktion update\$1plan\$1hash wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 16.2
<a name="auroraqpm-version16-162"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 16.2 gehören:

**Neue Features**
+ QPM kann Pläne mit Aggregate-Operatoren durchsetzen.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem behoben, bei dem beim Löschen einer Datenbank die zugehörigen erfassten Pläne nicht aus dem gemeinsamen Speicher entfernt wurden.
+ Ein Problem mit der Durchsetzung von Plänen, die Ansichten enthalten, wurde behoben.
+ Verbesserungen bei der Durchsetzung von Parallel-Append-Plänen.
+ Ein Problem im Zusammenhang mit der Planerfassung wurde behoben.
+ Ein Problem mit der Durchsetzung von Plänen, die Sammelknoten enthalten, wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 16.1
<a name="auroraqpm-version16-161"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 16.1 gehören:

**Neue Features**
+ Die Planentwürfe werden im Rahmen der `update_plan_hash`-Aktion für die `apg_plan_mgmt.validate_plans`-Funktion auf das neueste Format aktualisiert.
+ Unterstützung für die parallele Append-Erzwingung als Teil von Parallel Query Enforce wurde hinzugefügt. Um parallele Append-Knoten korrekt zu erzwingen, müssen Sie die folgenden Schritte ausführen:

  1. `apg_plan_mgmt.plan_hash_version` auf 5 setzen.

  1. Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Leistungsverbesserung bei der Plan-Hash-Berechnung. 
+ Verbesserte Speicherauslastung für Planentwürfe, die sich wiederholende Teilpläne enthalten.
+ Es wurde ein Problem bei der parallelen Abfrageerzwingung behoben, bei dem `GatherMerge` nicht erzwungen werden konnte.
+ Es wurde ein Problem behoben, bei dem die geschätzten Kosten des erzwungenen Plans falsch waren.
+ Es wurde ein Problem bei der Durchsetzung genehmigter Pläne behoben, bei dem die Gliederung partitionierte Tabellen und Unterpläne enthielt.

## PostgreSQL-15-Versionen
<a name="auroraqpm-version15"></a>

**Topics**
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 15.17, 6. April 2026](#auroraqpm-version15-1517)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 15.15, 18. Dezember 2025](#auroraqpm-version15-1515)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 15.13, 30. Juni 2025](#auroraqpm-version15-1513)
+ [apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 15.12, 8. April 2025](#auroraqpm-version15-1512)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 15.10, 27. Dezember 2024](#auroraqpm-version15-1510)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 15.8, 30. September 2024](#auroraqpm-version15-158)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 15.7, 8. August 2024](#auroraqpm-version15-157)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 15.6](#auroraqpm-version15-156)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 15.5](#auroraqpm-version15-155)
+ [apg\$1plan\$1mgmt Version 2.5 für Aurora PostgreSQL 15.4](#auroraqpm-version15-154)
+ [apg\$1plan\$1mgmt Version 2.4 für Aurora PostgreSQL 15.3](#auroraqpm-version15-153)

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 15.17, 6. April 2026
<a name="auroraqpm-version15-1517"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 15.17 gehören:

**Erweiterungsverbesserungen**
+ Es wurde ein Problem in der Abfrageplanverwaltung behoben, das dazu führte, dass Pläne nicht erfasst wurden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 15.15, 18. Dezember 2025
<a name="auroraqpm-version15-1515"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 15.15 gehören:

**Erweiterungsverbesserungen**
+ Es wurde eine Verbesserung in der Abfrageplanverwaltung hinzugefügt, sodass Parameterlisten, die aus früheren Versionen gespeichert wurden, automatisch wieder erfasst werden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 15.13, 30. Juni 2025
<a name="auroraqpm-version15-1513"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 15.13 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem bei der Abfrageplanverwaltung behoben, bei dem parallele Bitmap-Scans durchgesetzt wurden, wenn ein BitmapOr/BitmapAnd Operator anwesend war.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen mit der Durchsetzung von Plänen behoben, bei dem mehrere Tabellenpartitionen zu einer Tabellenpartition zusammengefügt wurden.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen behoben, bei dem Append-Knoten über einer einzelnen Tabellenpartition erzwungen wurden.
+ Die `apg_plan_mgmt` Rolle in der Abfrageplanverwaltung ist reserviert und kann nicht mehr von Benutzern erstellt, geändert oder gelöscht werden.
+ Ein Problem beim Umgang mit Parameterlisten aus früheren Versionen der Abfrageplanverwaltung wurde behoben.

### apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 15.12, 8. April 2025
<a name="auroraqpm-version15-1512"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.8 für Aurora PostgreSQL 15.12 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Parameterliste behoben, das zu einem Fehler oder einem Neustart beim Abfragen von `dba_plans` Ansichten oder Aufrufen von `evolve_plan_baselines` Funktionen in der `validate_plans` Abfrageplanverwaltung führte. 
+ Es wurde ein Problem mit der Durchsetzung von Plänen behoben, die durch korrelierte Transformationen in der Query-Planverwaltung optimiert wurden.
+ Es wurde ein Problem in der Query-Planverwaltung behoben, bei dem unmittelbar nach der Installation der Erweiterung eine Utility-Anweisung ausgeführt oder Shared Memory zurückgesetzt wurde.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen für Abfragen mit Aufrufen unveränderlicher Funktionen in der Abfrageplanverwaltung behoben.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen in der Query-Planverwaltung behoben.

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 15.10, 27. Dezember 2024
<a name="auroraqpm-version15-1510"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 15.10 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Planerfassung auf dem Replikat in der Abfrageplanverwaltung behoben, bei dem das gemeinsam genutzte Speicher-Array im Replikat voll wurde.
+ Es wurde ein Problem mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben, das dazu führte, dass die Aufbewahrungsfrist für den Plan nicht durchgesetzt und das Datum der letzten Verwendung nicht aktualisiert wurde.
+ Es wurde ein Problem im Zusammenhang mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben.
+ Ein Problem mit der Durchsetzung von Plänen zur Verwaltung von Abfrageplänen, die Bitmap-Scans enthalten, wurde behoben.
+ Es wurde ein Problem mit der Verwaltung von Abfrageplänen behoben, bei dem Pläne für Funktionen oder Verfahren mit mehreren Abfragen falsch erfasst wurden.
+ Es wurde ein Problem mit der Erfassung von Plänen für verschachtelte Abfrageausführungen in der Abfrageplanverwaltung behoben. 
+ Ein Problem mit der Erfassung von Plänen in der Abfrageplanverwaltung mit erweitertem Abfrageprotokoll wurde behoben. 

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 15.8, 30. September 2024
<a name="auroraqpm-version15-158"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 15.8 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Durchsetzung von Query Plan Management-Plänen behoben, die Hash-Aggregate enthalten.

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 15.7, 8. August 2024
<a name="auroraqpm-version15-157"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 15.7 gehören:

**Neue Features**
+ Sie müssen das nicht mehr aktualisieren. `plan_hash_version` Nach dem Upgrade der Datenbank-Engine aktiviert QPM automatisch neue Funktionen. Sie müssen keine Maßnahmen ergreifen, damit neue Funktionen verfügbar werden.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Ein Problem mit der Durchsetzung von QPM-Plänen mit mehr als 64 partitionierten Tabellen wurde behoben.
+ Ein Problem mit der Durchsetzung von QPM-Plänen, die den Operator Append enthielten, wurde behoben.
+ Ein Problem mit QPM validate\$1plans mit der Aktion update\$1plan\$1hash wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 15.6
<a name="auroraqpm-version15-156"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 15.6 gehören:

**Neue Features**
+ QPM kann Pläne mit Aggregate-Operatoren durchsetzen.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem behoben, bei dem beim Löschen einer Datenbank die zugehörigen erfassten Pläne nicht aus dem gemeinsamen Speicher entfernt wurden.
+ Ein Problem mit der Durchsetzung von Plänen, die Ansichten enthalten, wurde behoben.
+ Verbesserungen bei der Durchsetzung von Parallel-Append-Plänen.
+ Ein Problem im Zusammenhang mit der Planerfassung wurde behoben.
+ Ein Problem mit der Durchsetzung von Plänen, die Sammelknoten enthalten, wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 15.5
<a name="auroraqpm-version15-155"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 15.5 gehören:

**Neue Features**
+ Die Planentwürfe werden im Rahmen der `update_plan_hash`-Aktion für die `apg_plan_mgmt.validate_plans`-Funktion auf das neueste Format aktualisiert.
+ Unterstützung für die parallele Append-Erzwingung als Teil von Parallel Query Enforce wurde hinzugefügt. Um parallele Append-Knoten korrekt zu erzwingen, müssen Sie die folgenden Schritte ausführen:

  1. `apg_plan_mgmt.plan_hash_version` auf 5 setzen.

  1. Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Leistungsverbesserung bei der Plan-Hash-Berechnung. 
+ Verbesserte Speicherauslastung für Planentwürfe, die sich wiederholende Teilpläne enthalten.
+ Es wurde ein Problem bei der parallelen Abfrageerzwingung behoben, bei dem `GatherMerge` nicht erzwungen werden konnte.
+ Es wurde ein Problem behoben, bei dem die geschätzten Kosten des erzwungenen Plans falsch waren.
+ Es wurde ein Problem bei der Durchsetzung genehmigter Pläne behoben, bei dem die Gliederung partitionierte Tabellen und Unterpläne enthielt.

### apg\$1plan\$1mgmt Version 2.5 für Aurora PostgreSQL 15.4
<a name="auroraqpm-version15-154"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.5 für Aurora PostgreSQL 15.4 gehören:

**Neue Features**
+ QPM kann durchsetzen, dass Abfragepläne parallele Operatoren enthalten, mit Ausnahme des Parallel-Append-Knotens. Damit parallele Abfragepläne korrekt durchgesetzt werden, müssen Sie nach dem Upgrade auf 15.4 oder 14.9 wie folgt vorgehen:
  + Setzen Sie `apg_plan_mgmt.plan_hash_version` auf 4 oder höher.
  + Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.
  + Erfassen Sie genehmigte Pläne mit dem Gather-Knoten in plan\$1outline erneut.
+ QPM kann Abfragepläne mit Materialize-Knoten durchsetzen. Zum Durchsetzen von Materialize-Knoten müssen Sie nach dem Upgrade auf 15.4 oder 14.9 wie folgt vorgehen:
  + Setzen Sie `apg_plan_mgmt.plan_hash_version` auf 4 oder höher.
  + Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.
+ Damit Abfragepläne von Replikaten erfasst werden, müssen Sie die Erweiterung `apg_plan_mgmt` aktualisieren, indem Sie ALTER EXTENSION apg\$1plan\$1mgmt UPDATE aufrufen. 
+ Sie müssen `apg_plan_mgmt.plan_capture_threshold` angeben, damit QPM keine Abfragepläne erfassen kann.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Leistungsverbesserung bei der Berechnung. `plan_hash`

### apg\$1plan\$1mgmt Version 2.4 für Aurora PostgreSQL 15.3
<a name="auroraqpm-version15-153"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.4 für Aurora PostgreSQL 15.3 gehören:

**Neue Features**
+ Es wurde die neue GUC auto\$1explain.hashes eingeführt. Wenn der Wert auf true gesetzt ist (Standard: false), werden sql\$1hash und plan\$1hash am Ende des Auto-Explain-Ergebnisses angezeigt. 
+ Es wurde die neue GUC apg\$1plan\$1mgmt.explain\$1hashes eingeführt. Wenn der Wert auf true gesetzt ist (Standard: false), zeigt das EXPLAIN-Ergebnis sql\$1hash und plan\$1hash auch ohne die Option true für Hashes an.
+ Es wurde die neue GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result eingeführt. Je nach Wert (Standard: keiner) werden die Ergebnisse der Plandurchsetzung in Postgres-Protokolldateien geschrieben.
+ Es wurde eine neue Version der Plan-Hash-Berechnung eingeführt, um partitionierte Tabellen zu unterstützen. Benutzer müssen apg\$1plan\$1mgmt.plan\$1hash\$1version auf 3 setzen und apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') in jeder Datenbank mit installiertem `apg_plan_mgmt` und Einträgen in der Plantabelle aufrufen.
+ QPM kann Abfragepläne mit Memoize-Knoten durchsetzen.
+  Die Funktion `apg_plan_mgmt.copy_outline` kann ein neues fünftes Argument annehmen: `force_update_target_plan_hash`. Wenn der Wert auf true gesetzt ist, wird der Zielplan-Hash aktualisiert, auch wenn der Quellplan nicht für den Ziel-sql\$1hash reproduzierbar ist. 

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Plandurchsetzung für vorbereitete JDBC-Anweisungen behoben.
+ Die Parität in Bezug auf queryid zwischen pg\$1stat\$1statements und apg\$1plan\$1mgmt.dba\$1plans wurde verbessert.
+ Es wurde ein Problem mit der Plandurchsetzung behoben, das auftrat, wenn Indexnamen mit Ziffern endeten. 
+  Die Funktion apg\$1plan\$1mgmt.copy\$1outline kopiert jetzt environment\$1variables. 
+  Der Mindestwert von apg\$1plan\$1mgmt.plan\$1retention\$1period ändert sich von 1 in 32. 
+  Die Abfrageplanverwaltung kann jetzt Pläne für Abfragen in schreibgeschützten Transaktionen von den Writer-Knoten aus speichern. 
+  Es wurde ein Problem in der Funktion apg\$1plan\$1mgmt.evolve\$1plan\$1baselines behoben. 
+  Es wurde ein Problem behoben, das bei Aktivierung von apg\$1plan\$1mgmt Nichtverfügbarkeit verursachen konnte. 

Informationen zum Installieren, Upgraden und Verwenden der Erweiterung `apg_plan_mgmt` finden Sie unter [Verwalten von Abfrageausführungsplänen für Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) im *Benutzerhandbuch für Amazon Aurora*.

## PostgreSQL-14-Versionen
<a name="auroraqpm-version14"></a>

**Topics**
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 14.22, 6. April 2026](#auroraqpm-version14-1422)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 14.20, 18. Dezember 2025](#auroraqpm-version14-1420)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 14.18, 30. Juni 2025](#auroraqpm-version14-1418)
+ [apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 14.17, 8. April 2025](#auroraqpm-version14-1417)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 14.15, 27. Dezember 2024](#auroraqpm-version14-1415)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 14.12, 8. August 2024](#auroraqpm-version14-1412)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 14.11](#auroraqpm-version14-1411)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 14.10](#auroraqpm-version14-1410)
+ [apg\$1plan\$1mgmt Version 2.5 für Aurora PostgreSQL 14.9](#auroraqpm-version14-149)
+ [apg\$1plan\$1mgmt Version 2.4 für Aurora PostgreSQL 14.8](#auroraqpm-version14-148)

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 14.22, 6. April 2026
<a name="auroraqpm-version14-1422"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 14.22 gehören:

**Erweiterungsverbesserungen**
+ Es wurde ein Problem in der Abfrageplanverwaltung behoben, das dazu führte, dass Pläne nicht erfasst wurden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 14.20, 18. Dezember 2025
<a name="auroraqpm-version14-1420"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 14.20 gehören:

**Erweiterungsverbesserungen**
+ Es wurde eine Verbesserung in der Abfrageplanverwaltung hinzugefügt, sodass Parameterlisten, die aus früheren Versionen gespeichert wurden, automatisch wieder erfasst werden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 14.18, 30. Juni 2025
<a name="auroraqpm-version14-1418"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 14.18 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem bei der Abfrageplanverwaltung behoben, bei dem parallele Bitmap-Scans durchgesetzt wurden, wenn ein BitmapOr/BitmapAnd Operator anwesend war.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen mit der Durchsetzung von Plänen behoben, bei dem mehrere Tabellenpartitionen zu einer Tabellenpartition zusammengefügt wurden.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen behoben, bei dem Append-Knoten über einer einzelnen Tabellenpartition erzwungen wurden.
+ Die `apg_plan_mgmt` Rolle in der Abfrageplanverwaltung ist reserviert und kann nicht mehr von Benutzern erstellt, geändert oder gelöscht werden.
+ Ein Problem beim Umgang mit Parameterlisten aus früheren Versionen der Abfrageplanverwaltung wurde behoben.

### apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 14.17, 8. April 2025
<a name="auroraqpm-version14-1417"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.8 für Aurora PostgreSQL 14.17 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Parameterliste behoben, das zu einem Fehler oder einem Neustart beim Abfragen von `dba_plans` Ansichten oder Aufrufen von `evolve_plan_baselines` Funktionen in der `validate_plans` Abfrageplanverwaltung führte. 
+ Es wurde ein Problem mit der Durchsetzung von Plänen behoben, die durch korrelierte Transformationen in der Query-Planverwaltung optimiert wurden.
+ Es wurde ein Problem in der Query-Planverwaltung behoben, bei dem unmittelbar nach der Installation der Erweiterung eine Utility-Anweisung ausgeführt oder Shared Memory zurückgesetzt wurde.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen für Abfragen mit Aufrufen unveränderlicher Funktionen in der Abfrageplanverwaltung behoben.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen in der Query-Planverwaltung behoben.

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 14.15, 27. Dezember 2024
<a name="auroraqpm-version14-1415"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 14.15 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Planerfassung auf dem Replikat in der Abfrageplanverwaltung behoben, bei dem das gemeinsam genutzte Speicher-Array im Replikat voll wurde.
+ Es wurde ein Problem mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben, das dazu führte, dass die Aufbewahrungsfrist für den Plan nicht durchgesetzt und das Datum der letzten Verwendung nicht aktualisiert wurde.
+ Es wurde ein Problem im Zusammenhang mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben.
+ Ein Problem mit der Durchsetzung von Plänen zur Verwaltung von Abfrageplänen, die Bitmap-Scans enthalten, wurde behoben.
+ Es wurde ein Problem mit der Verwaltung von Abfrageplänen behoben, bei dem Pläne für Funktionen oder Verfahren mit mehreren Abfragen falsch erfasst wurden.
+ Es wurde ein Problem mit der Erfassung von Plänen für verschachtelte Abfrageausführungen in der Abfrageplanverwaltung behoben. 
+ Ein Problem mit der Erfassung von Plänen in der Abfrageplanverwaltung mit erweitertem Abfrageprotokoll wurde behoben. 

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 14.12, 8. August 2024
<a name="auroraqpm-version14-1412"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 14.12 gehören:

**Neue Features**
+ Sie müssen das nicht mehr aktualisieren. `plan_hash_version` Nach dem Upgrade der Datenbank-Engine aktiviert QPM automatisch neue Funktionen. Sie müssen keine Maßnahmen ergreifen, damit neue Funktionen verfügbar werden.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Ein Problem mit der Durchsetzung von QPM-Plänen mit mehr als 64 partitionierten Tabellen wurde behoben.
+ Ein Problem mit der Durchsetzung von QPM-Plänen, die den Operator Append enthielten, wurde behoben.
+ Ein Problem mit QPM validate\$1plans mit der Aktion update\$1plan\$1hash wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 14.11
<a name="auroraqpm-version14-1411"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 14.11 gehören:

**Neue Features**
+ QPM kann Pläne mit Aggregate-Operatoren durchsetzen.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem behoben, bei dem beim Löschen einer Datenbank die zugehörigen erfassten Pläne nicht aus dem gemeinsamen Speicher entfernt wurden.
+ Ein Problem mit der Durchsetzung von Plänen, die Ansichten enthalten, wurde behoben.
+ Verbesserungen bei der Durchsetzung von Parallel-Append-Plänen.
+ Ein Problem im Zusammenhang mit der Planerfassung wurde behoben.
+ Ein Problem mit der Durchsetzung von Plänen, die Sammelknoten enthalten, wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 14.10
<a name="auroraqpm-version14-1410"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 14.10 gehören:

**Neue Features**
+ Die Planentwürfe werden im Rahmen der `update_plan_hash`-Aktion für die `apg_plan_mgmt.validate_plans`-Funktion auf das neueste Format aktualisiert.
+ Unterstützung für die parallele Append-Erzwingung als Teil von Parallel Query Enforce wurde hinzugefügt. Um parallele Append-Knoten korrekt zu erzwingen, müssen Sie die folgenden Schritte ausführen:

  1. `apg_plan_mgmt.plan_hash_version` auf 5 setzen.

  1. Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Leistungsverbesserung bei der Plan-Hash-Berechnung. 
+ Verbesserte Speicherauslastung für Planentwürfe, die sich wiederholende Teilpläne enthalten.
+ Es wurde ein Problem bei der parallelen Abfrageerzwingung behoben, bei dem `GatherMerge` nicht erzwungen werden konnte.
+ Es wurde ein Problem behoben, bei dem die geschätzten Kosten des erzwungenen Plans falsch waren.
+ Es wurde ein Problem bei der Durchsetzung genehmigter Pläne behoben, bei dem die Gliederung partitionierte Tabellen und Unterpläne enthielt.

### apg\$1plan\$1mgmt Version 2.5 für Aurora PostgreSQL 14.9
<a name="auroraqpm-version14-149"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.5 für Aurora PostgreSQL 14.9 gehören:

**Neue Features**
+ QPM kann durchsetzen, dass Abfragepläne parallele Operatoren enthalten, mit Ausnahme des Parallel-Append-Knotens. Damit parallele Abfragepläne korrekt durchgesetzt werden, müssen Sie nach dem Upgrade auf 15.4 oder 14.9 wie folgt vorgehen:
  + Setzen Sie `apg_plan_mgmt.plan_hash_version` auf 4 oder höher.
  + Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.
  + Erfassen Sie genehmigte Pläne mit dem Gather-Knoten in plan\$1outline erneut.
+ QPM kann Abfragepläne mit Materialize-Knoten durchsetzen. Zum Durchsetzen von Materialize-Knoten müssen Sie nach dem Upgrade auf 15.4 oder 14.9 wie folgt vorgehen:
  + Setzen Sie `apg_plan_mgmt.plan_hash_version` auf 4 oder höher.
  + Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.
+ Damit Abfragepläne von Replikaten erfasst werden, müssen Sie die Erweiterung `apg_plan_mgmt` aktualisieren, indem Sie ALTER EXTENSION apg\$1plan\$1mgmt UPDATE aufrufen. 
+ Sie müssen `apg_plan_mgmt.plan_capture_threshold` angeben, damit QPM keine Abfragepläne erfassen kann.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Leistungsverbesserung bei der Berechnung. `plan_hash`

### apg\$1plan\$1mgmt Version 2.4 für Aurora PostgreSQL 14.8
<a name="auroraqpm-version14-148"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.4 für Aurora PostgreSQL 14.8 gehören:

**Neue Features**
+ Es wurde die neue GUC auto\$1explain.hashes eingeführt. Wenn der Wert auf true gesetzt ist (Standard: false), werden sql\$1hash und plan\$1hash am Ende des Auto-Explain-Ergebnisses angezeigt. 
+ Es wurde die neue GUC apg\$1plan\$1mgmt.explain\$1hashes eingeführt. Wenn der Wert auf true gesetzt ist (Standard: false), zeigt das EXPLAIN-Ergebnis sql\$1hash und plan\$1hash auch ohne die Option true für Hashes an.
+ Es wurde die neue GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result eingeführt. Je nach Wert (Standard: keiner) werden die Ergebnisse der Plandurchsetzung in Postgres-Protokolldateien geschrieben.
+ Es wurde eine neue Version der Plan-Hash-Berechnung eingeführt, um partitionierte Tabellen zu unterstützen. Benutzer müssen apg\$1plan\$1mgmt.plan\$1hash\$1version auf 3 setzen und apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') in jeder Datenbank mit installiertem `apg_plan_mgmt` und Einträgen in der Plantabelle aufrufen.
+ QPM kann Abfragepläne mit Memoize-Knoten durchsetzen.
+  Die Funktion `apg_plan_mgmt.copy_outline` kann ein neues fünftes Argument annehmen: `force_update_target_plan_hash`. Wenn der Wert auf true gesetzt ist, wird der Zielplan-Hash aktualisiert, auch wenn der Quellplan nicht für den Ziel-sql\$1hash reproduzierbar ist. 

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Plandurchsetzung für vorbereitete JDBC-Anweisungen behoben.
+ Die Parität in Bezug auf queryid zwischen pg\$1stat\$1statements und apg\$1plan\$1mgmt.dba\$1plans wurde verbessert.
+ Es wurde ein Problem mit der Plandurchsetzung behoben, das auftrat, wenn Indexnamen mit Ziffern endeten. 
+  Die Funktion apg\$1plan\$1mgmt.copy\$1outline kopiert jetzt environment\$1variables. 
+  Der Mindestwert von apg\$1plan\$1mgmt.plan\$1retention\$1period ändert sich von 1 in 32. 
+  Die Abfrageplanverwaltung kann jetzt Pläne für Abfragen in schreibgeschützten Transaktionen von den Writer-Knoten aus speichern. 
+  Es wurde ein Problem in der Funktion apg\$1plan\$1mgmt.evolve\$1plan\$1baselines behoben. 
+  Es wurde ein Problem behoben, das bei Aktivierung von apg\$1plan\$1mgmt Nichtverfügbarkeit verursachen konnte. 

Informationen zum Installieren, Upgraden und Verwenden der Erweiterung `apg_plan_mgmt` finden Sie unter [Verwalten von Abfrageausführungsplänen für Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) im *Benutzerhandbuch für Amazon Aurora*.

## PostgreSQL 13-Versionen
<a name="auroraqpm-version13"></a>

**Topics**
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 13.23, 18. Dezember 2025](#auroraqpm-version13-1323)
+ [apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 13.21, 30. Juni 2025](#auroraqpm-version13-1321)
+ [apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 13.20, 8. April 2025](#auroraqpm-version13-1320)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 13.18, 27. Dezember 2024](#auroraqpm-version13-1318)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 13.15, 8. August 2024](#auroraqpm-version13-1315)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 13.14](#auroraqpm-version13-1314)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 13.13](#auroraqpm-version13-1313)
+ [apg\$1plan\$1mgmt Version 2.5 für Aurora PostgreSQL 13.12](#auroraqpm-version13-1312)
+ [apg\$1plan\$1mgmt Version 2.4 für Aurora PostgreSQL 13.11](#auroraqpm-version13-1311)

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 13.23, 18. Dezember 2025
<a name="auroraqpm-version13-1323"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 13.23 gehören:

**Erweiterungsverbesserungen**
+ Es wurde eine Verbesserung in der Abfrageplanverwaltung hinzugefügt, sodass Parameterlisten, die aus früheren Versionen gespeichert wurden, automatisch wieder erfasst werden.

### apg\$1plan\$1mgmt Version 2.9 für Aurora PostgreSQL 13.21, 30. Juni 2025
<a name="auroraqpm-version13-1321"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.9 für Aurora PostgreSQL 13.21 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem bei der Abfrageplanverwaltung behoben, bei dem parallele Bitmap-Scans durchgesetzt wurden, wenn ein BitmapOr/BitmapAnd Operator anwesend war.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen mit der Durchsetzung von Plänen behoben, bei dem mehrere Tabellenpartitionen zu einer Tabellenpartition zusammengefügt wurden.
+ Es wurde ein Problem bei der Verwaltung von Abfrageplänen behoben, bei dem Append-Knoten über einer einzelnen Tabellenpartition erzwungen wurden.
+ Die `apg_plan_mgmt` Rolle in der Abfrageplanverwaltung ist reserviert und kann nicht mehr von Benutzern erstellt, geändert oder gelöscht werden.
+ Ein Problem beim Umgang mit Parameterlisten aus früheren Versionen von Query Plan Management wurde behoben.

### apg\$1plan\$1mgmt Version 2.8 für Aurora PostgreSQL 13.20, 8. April 2025
<a name="auroraqpm-version13-1320"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.8 für Aurora PostgreSQL 13.20 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Parameterliste behoben, das zu einem Fehler oder einem Neustart beim Abfragen von `dba_plans` Ansichten oder Aufrufen von `evolve_plan_baselines` Funktionen in der `validate_plans` Abfrageplanverwaltung führte. 
+ Es wurde ein Problem mit der Durchsetzung von Plänen behoben, die durch korrelierte Transformationen in der Query-Planverwaltung optimiert wurden.
+ Es wurde ein Problem in der Query-Planverwaltung behoben, bei dem unmittelbar nach der Installation der Erweiterung eine Utility-Anweisung ausgeführt oder Shared Memory zurückgesetzt wurde.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen für Abfragen mit Aufrufen unveränderlicher Funktionen in der Abfrageplanverwaltung behoben.
+ Es wurde ein Problem bei der Durchsetzung, Validierung und Weiterentwicklung von Plänen in der Query-Planverwaltung behoben.

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 13.18, 27. Dezember 2024
<a name="auroraqpm-version13-1318"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 13.18 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Planerfassung auf dem Replikat in der Abfrageplanverwaltung behoben, bei dem das gemeinsam genutzte Speicher-Array im Replikat voll wurde.
+ Es wurde ein Problem mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben, das dazu führte, dass die Aufbewahrungsfrist für den Plan nicht durchgesetzt und das Datum der letzten Verwendung nicht aktualisiert wurde.
+ Es wurde ein Problem im Zusammenhang mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben.
+ Ein Problem mit der Durchsetzung von Plänen zur Verwaltung von Abfrageplänen, die Bitmap-Scans enthalten, wurde behoben.
+ Es wurde ein Problem mit der Verwaltung von Abfrageplänen behoben, bei dem Pläne für Funktionen oder Verfahren mit mehreren Abfragen falsch erfasst wurden.
+ Es wurde ein Problem mit der Erfassung von Plänen für verschachtelte Abfrageausführungen in der Abfrageplanverwaltung behoben. 
+ Ein Problem mit der Erfassung von Plänen in der Abfrageplanverwaltung mit erweitertem Abfrageprotokoll wurde behoben. 

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 13.15, 8. August 2024
<a name="auroraqpm-version13-1315"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 13.15 gehören:

**Neue Features**
+ Sie müssen das nicht mehr aktualisieren. `plan_hash_version` Nach dem Upgrade der Datenbank-Engine aktiviert QPM automatisch neue Funktionen. Sie müssen keine Maßnahmen ergreifen, damit neue Funktionen verfügbar werden.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Ein Problem mit der Durchsetzung von QPM-Plänen mit mehr als 64 partitionierten Tabellen wurde behoben.
+ Ein Problem mit der Durchsetzung von QPM-Plänen, die den Operator Append enthielten, wurde behoben.
+ Ein Problem mit QPM validate\$1plans mit der Aktion update\$1plan\$1hash wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 13.14
<a name="auroraqpm-version13-1314"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 13.14 gehören:

**Neue Features**
+ QPM kann Pläne mit Aggregate-Operatoren durchsetzen.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem behoben, bei dem beim Löschen einer Datenbank die zugehörigen erfassten Pläne nicht aus dem gemeinsamen Speicher entfernt wurden.
+ Ein Problem mit der Durchsetzung von Plänen, die Ansichten enthalten, wurde behoben.
+ Verbesserungen bei der Durchsetzung von Parallel-Append-Plänen.
+ Ein Problem im Zusammenhang mit der Planerfassung wurde behoben.
+ Ein Problem mit der Durchsetzung von Plänen, die Sammelknoten enthalten, wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 13.13
<a name="auroraqpm-version13-1313"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 13.13 gehören:

**Neue Features**
+ Die Planentwürfe werden im Rahmen der `update_plan_hash`-Aktion für die `apg_plan_mgmt.validate_plans`-Funktion auf das neueste Format aktualisiert.
+ Unterstützung für die parallele Append-Erzwingung als Teil von Parallel Query Enforce wurde hinzugefügt. Um parallele Append-Knoten korrekt zu erzwingen, müssen Sie die folgenden Schritte ausführen:

  1. `apg_plan_mgmt.plan_hash_version` auf 5 setzen.

  1. Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Leistungsverbesserung bei der Plan-Hash-Berechnung. 
+ Verbesserte Speicherauslastung für Planentwürfe, die sich wiederholende Teilpläne enthalten.
+ Es wurde ein Problem bei der parallelen Abfrageerzwingung behoben, bei dem `GatherMerge` nicht erzwungen werden konnte.
+ Es wurde ein Problem behoben, bei dem die geschätzten Kosten des erzwungenen Plans falsch waren.
+ Es wurde ein Problem bei der Durchsetzung genehmigter Pläne behoben, bei dem die Gliederung partitionierte Tabellen und Unterpläne enthielt.

### apg\$1plan\$1mgmt Version 2.5 für Aurora PostgreSQL 13.12
<a name="auroraqpm-version13-1312"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.5 für Aurora PostgreSQL 13.12 gehören:

**Neue Features**
+ QPM kann durchsetzen, dass Abfragepläne parallele Operatoren enthalten, mit Ausnahme des Parallel-Append-Knotens. Damit parallele Abfragepläne korrekt durchgesetzt werden, müssen Sie nach dem Upgrade auf 15.4 oder 14.9 wie folgt vorgehen:
  + Setzen Sie `apg_plan_mgmt.plan_hash_version` auf 4 oder höher.
  + Rufen Sie die Seite `apg_plan_mgmt.validate_plans('update_plan_hash')` auf.
  + Erfassen Sie genehmigte Pläne mit dem Gather-Knoten in plan\$1outline erneut.
+ Damit Abfragepläne von Replikaten erfasst werden, müssen Sie die Erweiterung `apg_plan_mgmt` aktualisieren, indem Sie ALTER EXTENSION apg\$1plan\$1mgmt UPDATE aufrufen. 
+ Sie müssen `apg_plan_mgmt.plan_capture_threshold` angeben, damit QPM keine Abfragepläne erfassen kann.

### apg\$1plan\$1mgmt Version 2.4 für Aurora PostgreSQL 13.11
<a name="auroraqpm-version13-1311"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.4 für Aurora PostgreSQL 13.11 gehören:

**Neue Features**
+ Es wurde die neue GUC auto\$1explain.hashes eingeführt. Wenn der Wert auf true gesetzt ist (Standard: false), werden sql\$1hash und plan\$1hash am Ende des Auto-Explain-Ergebnisses angezeigt. 
+ Es wurde die neue GUC apg\$1plan\$1mgmt.explain\$1hashes eingeführt. Wenn der Wert auf true gesetzt ist (Standard: false), zeigt das EXPLAIN-Ergebnis sql\$1hash und plan\$1hash auch ohne die Option true für Hashes an.
+ Es wurde die neue GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result eingeführt. Je nach Wert (Standard: keiner) werden die Ergebnisse der Plandurchsetzung in Postgres-Protokolldateien geschrieben.
+ Es wurde eine neue Version der Plan-Hash-Berechnung eingeführt, um partitionierte Tabellen zu unterstützen. Benutzer müssen apg\$1plan\$1mgmt.plan\$1hash\$1version auf 3 setzen und apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') in jeder Datenbank mit installiertem `apg_plan_mgmt` und Einträgen in der Plantabelle aufrufen.
+  Die Funktion `apg_plan_mgmt.copy_outline` kann ein neues fünftes Argument annehmen: `force_update_target_plan_hash`. Wenn der Wert auf true gesetzt ist, wird der Zielplan-Hash aktualisiert, auch wenn der Quellplan nicht für den Ziel-sql\$1hash reproduzierbar ist. 

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Plandurchsetzung für vorbereitete JDBC-Anweisungen behoben.
+ Es wurde ein Problem mit der Plandurchsetzung behoben, das auftrat, wenn Indexnamen mit Ziffern endeten. 
+  Die Funktion apg\$1plan\$1mgmt.copy\$1outline kopiert jetzt environment\$1variables. 
+  Der Mindestwert von apg\$1plan\$1mgmt.plan\$1retention\$1period ändert sich von 1 in 32. 
+  Die Abfrageplanverwaltung kann jetzt Pläne für Abfragen in schreibgeschützten Transaktionen von den Writer-Knoten aus speichern. 
+  Es wurde ein Problem in der Funktion apg\$1plan\$1mgmt.evolve\$1plan\$1baselines behoben. 
+  Es wurde ein Problem behoben, das bei Aktivierung von apg\$1plan\$1mgmt Nichtverfügbarkeit verursachen konnte. 

Informationen zum Installieren, Upgraden und Verwenden der Erweiterung `apg_plan_mgmt` finden Sie unter [Verwalten von Abfrageausführungsplänen für Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) im *Benutzerhandbuch für Amazon Aurora*.

## PostgreSQL 12-Versionen
<a name="auroraqpm-version12"></a>

**Topics**
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 12.22, 27. Dezember 2024](#auroraqpm-version12-1222)
+ [apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 12.19, 8. August 2024](#auroraqpm-version12-1219)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 12.18](#auroraqpm-version12-1218)
+ [apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 12.17](#auroraqpm-version12-1217)
+ [apg\$1plan\$1mgmt Version 2.5 für Aurora PostgreSQL 12.16](#auroraqpm-version12-1216)

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 12.22, 27. Dezember 2024
<a name="auroraqpm-version12-1222"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 12.22 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Es wurde ein Problem mit der Planerfassung auf dem Replikat in der Abfrageplanverwaltung behoben, bei dem das gemeinsam genutzte Speicher-Array im Replikat voll wurde.
+ Es wurde ein Problem mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben, das dazu führte, dass die Aufbewahrungsfrist für den Plan nicht durchgesetzt und das Datum der letzten Verwendung nicht aktualisiert wurde.
+ Es wurde ein Problem im Zusammenhang mit dem Hintergrund-Worker für die Abfrageplanverwaltung behoben.

### apg\$1plan\$1mgmt Version 2.7 für Aurora PostgreSQL 12.19, 8. August 2024
<a name="auroraqpm-version12-1219"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.7 für Aurora PostgreSQL 12.19 gehören:

**Neue Features**
+ Sie müssen das nicht mehr aktualisieren. `plan_hash_version` Nach dem Upgrade der Datenbank-Engine aktiviert QPM automatisch neue Funktionen. Sie müssen keine Maßnahmen ergreifen, damit neue Funktionen verfügbar werden.

**Zusätzliche Verbesserungen und Erweiterungen**
+ Ein Problem mit der Durchsetzung von QPM-Plänen mit mehr als 64 partitionierten Tabellen wurde behoben.
+ Ein Problem mit der Durchsetzung von QPM-Plänen, die den Operator Append enthielten, wurde behoben.
+ Ein Problem mit QPM validate\$1plans mit der Aktion update\$1plan\$1hash wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 12.18
<a name="auroraqpm-version12-1218"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 12.18 gehören:

**Zusätzliche Verbesserungen und Erweiterungen**
+ Ein Problem im Zusammenhang mit der Erfassung von Plänen wurde behoben.

### apg\$1plan\$1mgmt Version 2.6 für Aurora PostgreSQL 12.17
<a name="auroraqpm-version12-1217"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.6 für Aurora PostgreSQL 12.17 gehören:

**Neue Features**
+ Die Planentwürfe werden im Rahmen der `update_plan_hash`-Aktion für die `apg_plan_mgmt.validate_plans`-Funktion auf das neueste Format aktualisiert.

### apg\$1plan\$1mgmt Version 2.5 für Aurora PostgreSQL 12.16
<a name="auroraqpm-version12-1216"></a>

Zu den Verbesserungen der `apg_plan_mgmt` Erweiterung in Version 2.5 für Aurora PostgreSQL 12.16 gehören:

**Neue Features**
+ Damit Abfragepläne von Replikaten erfasst werden, müssen Sie die Erweiterung `apg_plan_mgmt` aktualisieren, indem Sie ALTER EXTENSION apg\$1plan\$1mgmt UPDATE aufrufen. 
+ Sie müssen `apg_plan_mgmt.plan_capture_threshold` angeben, damit QPM keine Abfragepläne erfassen kann.

## Version 2.3 der Aurora-PostgreSQL-Erweiterung apg\$1plan\$1mgmt
<a name="auroraqpm-version.23"></a>

Zu den Verbesserungen der Erweiterung `apg_plan_mgmt` in Version 2.3 gehören folgende:

**Neue Erweiterungsfunktionen**
+ Support für die neue Funktion `apg_plan_mgmt.copy_outline`. Diese Funktion ermöglicht das Kopieren eines Plan-Hashs und einer Plangliederung von einem SQL-Hash und Plan-Hash in einen anderen. Verwenden Sie diese Funktion, wenn Sie einen Plan, der Hinweise verwendet, in andere ähnliche Anweisungen kopieren möchten, ohne die Inline-Hinweisanweisung bei jedem Vorkommen verwenden zu müssen. Wenn die Aktualisierung der Abfrage zu einem ungültigen Plan führt, löst diese Funktion einen Fehler aus und macht die Aktualisierung rückgängig. Weitere Informationen finden Sie unter [Funktionsreferenz für die Aurora-PostgreSQL-Abfrageplanverwaltung](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Functions.html#AuroraPostgreSQL.Optimize.Functions.copy_outline) im *Benutzerhandbuch für Amazon Aurora*. 

**Erweiterungsverbesserungen**
+ Das Feature der Abfrageplanverwaltung speichert jetzt Pläne für Abfragen, die sich innerhalb von Prozeduren und DO-Blöcken befinden. Für frühere `apg_plan_mgmt`-Versionen als 2.3 stellte dies eine Einschränkung dar.

Informationen zum Installieren, Upgraden und Verwenden der Erweiterung `apg_plan_mgmt` finden Sie unter [Verwalten von Abfrageausführungsplänen für Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) im *Benutzerhandbuch für Amazon Aurora*.

## Version 2.1 der Aurora-PostgreSQL-Erweiterung apg\$1plan\$1mgmt
<a name="auroraqpm-version.21"></a>

Zu den Verbesserungen der Erweiterung `apg_plan_mgmt` in Version 2.1 für Aurora PostgreSQL 11.20 gehören folgende:

**Neue Erweiterungsfunktionen in Aurora PostgreSQL 11.20**
+ Es wurde die neue GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result eingeführt. Je nach Wert (Standard: keiner) werden die Ergebnisse der Plandurchsetzung in Postgres-Protokolldateien geschrieben.

**Erweiterungsverbesserungen in Aurora PostgreSQL 11.20**
+ Es wurde ein Problem mit der Plandurchsetzung für vorbereitete JDBC-Anweisungen behoben.

Informationen zum Installieren, Upgraden und Verwenden der Erweiterung `apg_plan_mgmt` finden Sie unter [Verwalten von Abfrageausführungsplänen für Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) im *Benutzerhandbuch für Amazon Aurora*.

## Version 2.0 der Aurora PostgreSQL apg\$1plan\$1mgmt-Erweiterung
<a name="auroraqpm-version.20"></a>

Die `apg_plan_mgmt`-Erweiterungsänderungen für Version 2.0 umfassen Folgendes:

**Neue Erweiterungsfunktionen**

1. Sie können nun alle Abfragen innerhalb von SQL-Funktionen verwalten, unabhängig davon, ob sie Parameter haben oder nicht.

1. Sie können jetzt alle Abfragen innerhalb von PL/pgSQL Funktionen verwalten, unabhängig davon, ob sie Parameter haben oder nicht.

1. Sie können nun Abfragen in allgemeinen Plänen verwalten, unabhängig davon, ob sie Parameter haben oder nicht. Weitere Informationen zu allgemeinen Plänen im Vergleich zu benutzerdefinierten Plänen finden Sie bei der `PREPARE`-Anweisung in der [PostgreSQL-Dokumentation](https://www.postgresql.org/docs/current/sql-prepare.html). 

1. Sie können nun die Abfrageplanverwaltung verwenden, um die Verwendung bestimmter Typen von Aggregatsmethoden in Abfrageplänen zu erzwingen.

**Erweiterungsverbesserungen**

1. Sie können jetzt Pläne mit einer Größe von bis zu 8  KB multipliziert mit der Einstellung des `max_worker_processes`-Parameters speichern. Zuvor betrug die maximale Plangröße 8 KB.

1. Fehler für unbenannte vorbereitete Anweisungen wie jene von JDBC wurden behoben.

1. Bisher ging die PostgreSQL-Backend-Verbindung verloren, wenn Sie versucht haben, `CREATE EXTENSION apg_plan_mgmt` durchzuführen, wenn es nicht in den `shared_preload_libraries` geladen war. Jetzt wird eine Fehlermeldung ausgegeben und die Verbindung wird nicht beendet.

1. Der Standardwert von `cardinality_error` in der `apg_plan_mgmt.plans table` ist NULL, kann aber während der `apg_plan_mgmt.evolve_plan_baselines`-Funktion auf -1 gesetzt werden. NULL wird jetzt konsistent verwendet.

1. Pläne werden nun für Abfragen gespeichert, die sich auf temporäre Tabellen beziehen.

1. Die standardmäßige maximale Anzahl von Plänen wird von 1000 auf 10 000 erhöht.

1. Die folgenden pgss-Parameter sind veraltet, da anstelle dieser Parameter der automatische Planerfassungsmodus verwendet werden sollte.
   + `apg_plan_mgmt.pgss_min_calls`
   + `apg_plan_mgmt.pgss_min_mean_time_ms`
   + `apg_plan_mgmt.pgss_min_stddev_time_ms`
   + `apg_plan_mgmt.pgss_min_total_time_ms`

## Version 1.0.1 der Aurora PostgreSQL apg\$1plan\$1mgmt-Erweiterung
<a name="auroraqpm-version.101"></a>

Die `apg_plan_mgmt`-Erweiterungsänderungen für Version 1.0.1 umfassen Folgendes:

**Neue Erweiterungsfunktionen**

1. Die Funktion `validate_plans` hat einen neuen `action`-Wert mit dem Namen `update_plan_hash`. Diese Aktion aktualisiert die `plan_hash`-ID für Pläne, die nicht genau reproduziert werden können. Mit dem `update_plan_hash`-Wert können Sie auch einen Plan korrigieren, indem Sie die SQL-Anweisung neu schreiben. Anschließend können Sie den korrigierten Plan als `Approved`-Plan für die ursprüngliche SQL-Anweisung registrieren. Es folgt ein Beispiel für die Verwendung der Aktion `update_plan_hash`.

   ```
   UPDATE apg_plan_mgmt.plans SET plan_hash = new _plan_hash, plan_outline = good_plan_outline
      WHERE sql_hash = bad_plan_sql_hash AND plan_hash = bad_plan_plan_hash;
   SELECT apg_plan_mgmt.validate_plans(bad_plan_sql_hash, bad_plan_plan_hash, 'update_plan_hash');
   SELECT apg_plan_mgmt.reload();
   ```

1. Eine neue `get_explain_stmt`-Funktion ist verfügbar, die den Text einer `EXPLAIN`-Anweisung für die angegebene SQL-Anweisung generiert. Sie enthält die Parameter `sql_hash`, `plan_hash` und `explain_options`. 

   Der Parameter `explain_options` kann eine beliebige durch Komma getrennte Liste gültiger `EXPLAIN`-Optionen sein, wie nachfolgend dargestellt.

   ```
   analyze,verbose,buffers,hashes,format json
   ```

   Wenn der Parameter `explain_options` NULL oder eine leere Zeichenfolge ist, generiert die `get_explain_stmt`-Funktion eine einfache `EXPLAIN`-Anweisung. 

   Verwenden Sie zum Erstellen eines `EXPLAIN`-Skripts für Ihren gesamten oder einen Teil Ihres Workloads die Optionen `\a`, `\t` und `\o`, um die Ausgabe in eine Datei weiterzuleiten. Sie können z. B. ein `EXPLAIN`-Skript für die Top-K-Anweisungen erstellen, indem Sie die PostgreSQL-Ansicht `pg_stat_statements` nach `total_time` in `DESC` Reihenfolge sortieren.

1. Die genaue Position des Gather Parallel Query-Operators wird durch die Bewertung bestimmt und kann sich im Zeitverlauf geringfügig ändern. Damit diese Abweichungen nicht den gesamten Plan ungültig machen, berechnet die Abfrageplanverwaltung nun denselben `plan_hash`, auch wenn die Gather-Operatoren innerhalb der Planstruktur verschoben werden.

1. Nicht parametrisierte Anweisungen werden jetzt innerhalb von pl/pgsql-Funktionen unterstützt.

1. Der Overhead wird reduziert, wenn die Erweiterung `apg_plan_mgmt` auf mehreren Datenbanken desselben Clusters installiert wird, während auf zwei oder mehr Datenbanken gleichzeitig zugegriffen wird. Mit dieser Version wird außerdem ein Fehler in diesem Bereich behoben, der dazu führte, dass Pläne nicht in freigegebenem Speicher abgelegt wurden.

**Erweiterungsverbesserungen**

1. Verbesserungen der `evolve_plan_baselines`-Funktion.

   1. Die `evolve_plan_baselines`-Funktion berechnet nun eine `cardinality_error`-Metrik für alle Knoten im Plan. Mithilfe dieser Metrik können Sie jeden Plan identifizieren, bei dem der Kardinalitätsschätzungsfehler groß und die Planqualität zweifelhaft ist. Anweisungen mit langer Ausführungszeit und hohen `cardinality_error`-Werten haben bei der Abfrageoptimierung oberste Priorität.

   1. Von `evolve_plan_baselines` erstellte Berichte umfassen nun `sql_hash`, `plan_hash` sowie den `status` des Plans.

   1. Sie können jetzt zulassen, dass `evolve_plan_baselines` zuvor `Rejected` Pläne genehmigt.

   1. Die Bedeutung des `speedup_factor` für `evolve_plan_baselines` ist jetzt stets relativ zum Basisplan. Der Wert 1.1 z. B. steht jetzt für eine zehnprozentige Beschleunigung gegenüber dem Basisplan. Der Wert 0,9 bedeutet eine zehnprozentige Verlangsamung gegenüber dem Basisplan. Der Vergleich basiert ausschließlich auf der Ausführungsdauer. Die Gesamtdauer wird außer acht gelassen.

   1. Die `evolve_plan_baselines`-Funktion füllt den Cache jetzt auf neuartige Weise. Dazu wird der Basisplan zweimal nacheinander und der Kandidatplan einmal ausgeführt. Zuvor führte `evolve_plan_baselines` den Kandidatplan zweimal aus. Dieser Ansatz erforderte eine längere Ausführungszeit, insbesondere bei langsamen Kandidatsplänen. Die zweimalige Ausführung des Kandidatplans erhöht jedoch die Zuverlässigkeit, wenn der Kandidatplan einen Index verwendet, der im Basisplan nicht genutzt wird.

1. Die Abfrageplanverwaltung speichert keine Pläne mehr, die sich auf Systemtabellen oder -ansichten, temporäre Tabellen oder die eigenen Tabellen der Abfrageplanverwaltung beziehen.

1. Fehlerbehebungen umfassen ein sofortiges Ablegen eines Plans im Cache beim Speichern und die Korrektur eines Fehlers, der zum Beenden des Backends führte.