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.
# Parameterreferenz für Aurora-PostgreSQL-Abfrageplanverwaltung
Sie können Ihre Einstellungen für die `apg_plan_mgmt`-Erweiterung unter Verwendung der in diesem Abschnitt aufgeführten Parameter vornehmen. Diese sind im benutzerdefinierten DB-Cluster-Parameter und in der DB-Parametergruppe verfügbar, die Ihrem Aurora PostgreSQL DB-Cluster zugeordnet ist. Diese Parameter steuern das Verhalten der Abfrageplanverwaltungsfunktion und deren Auswirkungen auf den Optimierer. Weitere Informationen zum Einrichten einer Abfrageverwaltung finden Sie unter [Aktivieren der Abfrageplanverwaltung in Aurora PostgreSQL](AuroraPostgreSQL.Optimize.overview.md#AuroraPostgreSQL.Optimize.Enable). Das Ändern der folgenden Parameter hat keine Auswirkung, wenn die `apg_plan_mgmt`-Erweiterung nicht wie in diesem Abschnitt beschrieben eingerichtet ist. Weitere Informationen zum Ändern von Parametern finden Sie unter [Ändern von Parametern in einer DB-Cluster-Parametergruppe in Amazon Aurora](USER_WorkingWithParamGroups.ModifyingCluster.md) und [DB-Parametergruppen für DB-Instances von Amazon Aurora](USER_WorkingWithDBInstanceParamGroups.md).
**Topics**
+ [apg\$1plan\$1mgmt.capture\$1plan\$1baselines](#AuroraPostgreSQL.Optimize.Parameters.capture_plan_baselines)
+ [apg\$1plan\$1mgmt.plan\$1capture\$1threshold](#AuroraPostgreSQL.Optimize.Parameters.plan_capture_threshold)
+ [apg\$1plan\$1mgmt.explain\$1hashes](#AuroraPostgreSQL.Optimize.Parameters.explain_hashes)
+ [apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result](#AuroraPostgreSQL.Optimize.Parameters.log_plan_enforcement_result)
+ [apg\$1plan\$1mgmt.max\$1databases](#AuroraPostgreSQL.Optimize.Parameters.max_databases)
+ [apg\$1plan\$1mgmt.max\$1plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans)
+ [apg\$1plan\$1mgmt.plan\$1hash\$1version](#AuroraPostgreSQL.Optimize.Parameters.plan_hash_version)
+ [apg\$1plan\$1mgmt.plan\$1retention\$1period](#AuroraPostgreSQL.Optimize.Parameters.plan_retention_period)
+ [apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold](#AuroraPostgreSQL.Optimize.Parameters.unapproved_plan_execution_threshold)
+ [apg\$1plan\$1mgmt.use\$1plan\$1baselines](#AuroraPostgreSQL.Optimize.Parameters.use_plan_baselines)
+ [auto\$1explain.hashes](#AuroraPostgreSQL.Optimize.Parameters.auto_explain.hashes)
## apg\$1plan\$1mgmt.capture\$1plan\$1baselines
Erfasst Abfrageausführungspläne, die vom Optimierer für jede SQL-Anweisung generiert wurden, und speichert sie im der `dba_plans`-Ansicht. Standardmäßig beträgt die maximale Anzahl von Plänen, die gespeichert werden können, 10 000, wie im `apg_plan_mgmt.max_plans`-Parameter angegeben. Referenzinformationen finden Sie unter [apg\$1plan\$1mgmt.max\$1plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans).
Sie können diesen Parameter in der benutzerdefinierten DB-Cluster-Parametergruppe oder in der benutzerdefinierten DB-Parametergruppe festlegen. Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
Weitere Informationen finden Sie unter [Erfassung von Aurora-PostgreSQL-Ausführungsplänen](AuroraPostgreSQL.Optimize.CapturePlans.md).
## apg\$1plan\$1mgmt.plan\$1capture\$1threshold
Gibt einen Schwellenwert an, sodass der Plan nicht in der Ansicht `apg_plan_mgmt.dba_plans` erfasst wird, wenn die Gesamtkosten des Abfrageausführungsplans unter dem Schwellenwert liegen.
Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich.
| Standard | Zulässige Werte | Description |
| --- | --- | --- |
| 0 | 0 – 1.79769e\$1308 | Legt den Schwellenwert der Gesamtausführungskosten des Abfrageplans `apg_plan_mgmt` für die Erfassung von Plänen fest. |
Weitere Informationen finden Sie unter [Untersuchen von Aurora-PostgreSQL-Abfrageplänen in der dba\$1plans-Ansicht](AuroraPostgreSQL.Optimize.ViewPlans.md).
## apg\$1plan\$1mgmt.explain\$1hashes
Gibt an, ob der `EXPLAIN [ANALYZE]` am Ende seiner Ausgabe `sql_hash` und `plan_hash` anzeigt. Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
## apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result
Gibt an, ob die Ergebnisse aufgezeichnet werden müssen, um zu überprüfen, ob die von QPM verwalteten Pläne ordnungsgemäß verwendet werden. Wenn ein gespeicherter generischer Plan verwendet wird, werden keine Datensätze in die Protokolldateien geschrieben. Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
## apg\$1plan\$1mgmt.max\$1databases
Gibt die maximale Anzahl an Datenbanken in der Writer-Instance Ihres Aurora-PostgreSQL-Datenbank-Clusters an, die die Abfrageplanverwaltung nutzen können. Standardmäßig können bis zu 10 Datenbanken die Abfrageplanverwaltung verwenden. Wenn die Instance über mehr als 10 Datenbanken verfügt, können Sie den Wert dieser Einstellung ändern. Um herauszufinden, wie viele Datenbanken sich in einer bestimmten Instance befinden, stellen Sie eine Verbindung mit der Instance über `psql` her. Verwenden Sie dann den psql-Meta-Befehl, `\l`, um die Datenbanken aufzulisten.
Wenn Sie den Wert dieses Parameters ändern, müssen Sie die Instance neu starten, damit die Einstellung wirksam wird.
| Standard | Zulässige Werte | Description |
| --- | --- | --- |
| 10 | 10-2147483647 | Maximale Anzahl von Datenbanken, die die Abfrageplanverwaltung auf der Instance verwenden können. |
Sie können diesen Parameter in der benutzerdefinierten DB-Cluster-Parametergruppe oder in der benutzerdefinierten DB-Parametergruppe festlegen.
## apg\$1plan\$1mgmt.max\$1plans
Legt die maximale Anzahl von SQL-Anweisungen fest, die die Abfrageplanverwaltung in der Ansicht `apg_plan_mgmt.dba_plans` anzeigen kann. Wir empfehlen, diesen Parameter für alle Aurora-PostgreSQL-Versionen auf `10000` oder höher zu setzen.
Sie können diesen Parameter in der benutzerdefinierten DB-Cluster-Parametergruppe oder in der benutzerdefinierten DB-Parametergruppe festlegen. Wenn Sie den Wert dieses Parameters ändern, müssen Sie die Instance neu starten, damit die Einstellung wirksam wird.
| Standard | Zulässige Werte | Description |
| --- | --- | --- |
| 10000 | 10-2147483647 | Maximale Anzahl von Plänen, die in der `apg_plan_mgmt.dba_plans`-Ansicht gespeichert werden können. Die Standardeinstellung für Aurora-PostgreSQL-Version 10 und älter ist 1000. |
Weitere Informationen finden Sie unter [Untersuchen von Aurora-PostgreSQL-Abfrageplänen in der dba\$1plans-Ansicht](AuroraPostgreSQL.Optimize.ViewPlans.md).
## apg\$1plan\$1mgmt.plan\$1hash\$1version
Gibt die Anwendungsfälle an, für die die plan\$1hash-Berechnung konzipiert ist. Eine höhere Version von `apg_plan_mgmt.plan_hash_version` deckt den gesamten Funktionsumfang der niedrigeren Version ab. Version 3 deckt beispielsweise die von Version 2 unterstützten Anwendungsfälle ab.
Auf die Änderung des Werts dieses Parameters muss ein Aufruf von `apg_plan_mgmt.validate_plans('update_plan_hash')` folgen. Dadurch werden die plan\$1hash-Werte in jeder Datenbank, in der apg\$1plan\$1mgmt installiert ist, und Einträge in der Plantabelle aktualisiert. Weitere Informationen finden Sie unter [Validieren von Plänen](AuroraPostgreSQL.Optimize.Deleting.md#AuroraPostgreSQL.Optimize.Maintenance.ValidatingPlans).
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
## apg\$1plan\$1mgmt.plan\$1retention\$1period
Gibt an, wie viele Tage lang Pläne in der `apg_plan_mgmt.dba_plans`-Ansicht aufbewahrt werden, danach werden sie automatisch gelöscht. Standardmäßig wird ein Plan gelöscht, wenn 32 Tage seit der letzten Verwendung des Plans vergangen sind (Die `last_used`-Spalte in der `apg_plan_mgmt.dba_plans`-Ansicht). Sie können diese Einstellung auf eine beliebige Zahl ändern (1 und höher).
Wenn Sie den Wert dieses Parameters ändern, müssen Sie die Instance neu starten, damit die Einstellung wirksam wird.
| Standard | Zulässige Werte | Description |
| --- | --- | --- |
| 32 | 1-2147483647 | Maximale Anzahl von Tagen seit der letzten Nutzung eines Plans, bevor er gelöscht wird. |
Weitere Informationen finden Sie unter [Untersuchen von Aurora-PostgreSQL-Abfrageplänen in der dba\$1plans-Ansicht](AuroraPostgreSQL.Optimize.ViewPlans.md).
## apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold
Gibt einen Kostenschwellenwert an, unterhalb dessen ein nicht genehmigter Plan vom Optimierer verwendet werden kann. Der Schwellenwert lautet standardmäßig 0, nicht genehmigte Pläne werden vom Optimierer also nicht ausgeführt. Wenn dieser Parameter auf einen belanglos niedrigen Kostenschwellenwert wie 100 gesetzt wird, wird der Overhead für die Plandurchsetzung bei trivialen Plänen vermieden. Sie können diesen Parameter auch unter Verwendung des reaktiven Planverwaltungstils auf einen extrem hohen Wert wie 10000000 festlegen. Auf diese Weise kann der Optimierer alle ausgewählten Pläne ohne Overhead für die Plandurchsetzung verwenden. Wenn jedoch ein fehlerhafter Plan gefunden wird, können Sie diesen manuell als „abgelehnt“ markieren, sodass er beim nächsten Mal nicht verwendet wird.
Der Wert dieses Parameters stellt eine Kostenschätzung für die Ausführung eines bestimmten Plans dar. Wenn ein nicht genehmigter Plan unter diesen geschätzten Kosten liegt, verwendet der Optimierer ihn für die SQL-Anweisung. Sie können erfasste Pläne und ihren Status (Genehmigt, Nicht genehmigt) in der `dba_plans`-Ansicht anzeigen. Weitere Informationen hierzu finden Sie unter [Untersuchen von Aurora-PostgreSQL-Abfrageplänen in der dba\$1plans-Ansicht](AuroraPostgreSQL.Optimize.ViewPlans.md).
Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich.
| Standard | Zulässige Werte | Description |
| --- | --- | --- |
| 0 | 0-2147483647 | Geschätzte Plankosten, unter denen ein nicht genehmigter Plan verwendet wird. |
Weitere Informationen finden Sie unter [Verwenden von Aurora-PostgreSQL-Plänen](AuroraPostgreSQL.Optimize.UsePlans.md).
## apg\$1plan\$1mgmt.use\$1plan\$1baselines
Gibt an, dass der Optimierer einen der genehmigten Pläne verwenden soll, der in der `apg_plan_mgmt.dba_plans`-Ansicht erfasst und gespeichert ist. Standardmäßig ist dieser Parameter deaktiviert (false), was dazu führt, dass der Optimierer den von ihm generierten Mindestkostenplan ohne weitere Bewertung verwendet. Wenn Sie diesen Parameter aktivieren (ihn auf true setzen), muss der Optimierer einen Abfrageausführungsplan für die Anweisung aus seiner Plan-Baseline auswählen. Weitere Informationen finden Sie unter [Verwenden von Aurora-PostgreSQL-Plänen](AuroraPostgreSQL.Optimize.UsePlans.md). Ein Bild, das diesen Prozess detailliert beschreibt, finden Sie unter [Erfahren Sie, wie der Optimierer bestimmt, welche Pläne ausgeführt werden.](AuroraPostgreSQL.Optimize.UsePlans.md#AuroraPostgreSQL.Optimize.UsePlans.ChoosePlans).
Sie können diesen Parameter in der benutzerdefinierten DB-Cluster-Parametergruppe oder in der benutzerdefinierten DB-Parametergruppe festlegen. Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
Sie können die Reaktionszeiten verschiedener erfasster Pläne auswerten und den Planstatus nach Bedarf ändern. Weitere Informationen finden Sie unter [Verbessern von Aurora-PostgreSQL-Abfrageplänen](AuroraPostgreSQL.Optimize.Maintenance.md).
## auto\$1explain.hashes
Gibt an, ob die auto\$1explain-Ausgabe sql\$1hash und plan\$1hash anzeigt. Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)