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\_plan\_mgmt.capture\_plan\_baselines](#AuroraPostgreSQL.Optimize.Parameters.capture_plan_baselines) + [apg\_plan\_mgmt.plan\_capture\_threshold](#AuroraPostgreSQL.Optimize.Parameters.plan_capture_threshold) + [apg\_plan\_mgmt.explain\_hashes](#AuroraPostgreSQL.Optimize.Parameters.explain_hashes) + [apg\_plan\_mgmt.log\_plan\_enforcement\_result](#AuroraPostgreSQL.Optimize.Parameters.log_plan_enforcement_result) + [apg\_plan\_mgmt.max\_databases](#AuroraPostgreSQL.Optimize.Parameters.max_databases) + [apg\_plan\_mgmt.max\_plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans) + [apg\_plan\_mgmt.plan\_hash\_version](#AuroraPostgreSQL.Optimize.Parameters.plan_hash_version) + [apg\_plan\_mgmt.plan\_retention\_period](#AuroraPostgreSQL.Optimize.Parameters.plan_retention_period) + [apg\_plan\_mgmt.unapproved\_plan\_execution\_threshold](#AuroraPostgreSQL.Optimize.Parameters.unapproved_plan_execution_threshold) + [apg\_plan\_mgmt.use\_plan\_baselines](#AuroraPostgreSQL.Optimize.Parameters.use_plan_baselines) + [auto\_explain.hashes](#AuroraPostgreSQL.Optimize.Parameters.auto_explain.hashes) ## apg\_plan\_mgmt.capture\_plan\_baselines 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\_plan\_mgmt.max\_plans](#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. - **aus** - **Zulässige Werte:** Automatisch / **Description:** Wenden Sie diese Einstellung entweder auf Sitzungsebene oder in einer Parametergruppe an, um Pläne zu erfassen, die zweimal oder öfter verwendet werden. - **Zulässige Werte:** Manuell / **Description:** Wenden Sie diese Einstellung entweder auf Sitzungsebene oder in einer Parametergruppe an, um Pläne zu erfassen, die einmal oder öfter verwendet werden. - **Zulässige Werte:** aus / **Description:** Deaktiviert die Planerfassung. Weitere Informationen finden Sie unter [Erfassung von Aurora-PostgreSQL-Ausführungsplänen](AuroraPostgreSQL.Optimize.CapturePlans.md). ## apg\_plan\_mgmt.plan\_capture\_threshold 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\+308 | 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\_plans-Ansicht](AuroraPostgreSQL.Optimize.ViewPlans.md). ## apg\_plan\_mgmt.explain\_hashes 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. - **0** - **Zulässige Werte:** 0 (aus) / **Description:** EXPLAIN zeigt sql\_hash und plan\_hash ohne die Option true für die Hashes nicht an. - **Zulässige Werte:** 1 (ein) / **Description:** EXPLAIN zeigt sql\_hash und plan\_hash ohne die Option true für die Hashes an. ## apg\_plan\_mgmt.log\_plan\_enforcement\_result 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. - **none** - **Zulässige Werte:** Keine / **Description:** Zeigt in den Protokolldateien kein Ergebnis der Plandurchsetzung an. - **Zulässige Werte:** on\_error / **Description:** Zeigt nur das Ergebnis der Plandurchsetzung in Protokolldateien an, wenn QPM keine verwalteten Pläne verwendet. - **Zulässige Werte:** all / **Description:** Zeigt alle Ergebnisse der Plandurchsetzung in Protokolldateien an, einschließlich Erfolgen und Fehlern. ## apg\_plan\_mgmt.max\_databases 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\_plan\_mgmt.max\_plans 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\_plans-Ansicht](AuroraPostgreSQL.Optimize.ViewPlans.md). ## apg\_plan\_mgmt.plan\_hash\_version Gibt die Anwendungsfälle an, für die die plan\_hash-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\_hash-Werte in jeder Datenbank, in der apg\_plan\_mgmt 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). - **1** - **Zulässige Werte:** 1 / **Description:** Standardberechnung von plan\_hash. - **Zulässige Werte:** 2 / **Description:** plan\_hash-Berechnung für die Unterstützung mehrerer Schemas geändert. - **Zulässige Werte:** 3 / **Description:** plan\_hash-Berechnung für die Unterstützung mehrerer Schemas und Unterstützung partitionierter Tabellen geändert. - **Zulässige Werte:** 4 / **Description:** plan\_hash-Berechnung für parallele Operatoren und zur Unterstützung von Materialisierungsknoten geändert. ## apg\_plan\_mgmt.plan\_retention\_period 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\_plans-Ansicht](AuroraPostgreSQL.Optimize.ViewPlans.md). ## apg\_plan\_mgmt.unapproved\_plan\_execution\_threshold 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\_plans-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\_plan\_mgmt.use\_plan\_baselines 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. - **false** - **Zulässige Werte:** true / **Description:** Verwenden Sie einen genehmigten, bevorzugten oder nicht genehmigten Plan aus dem apg\_plan\_mgmt.dba\_plans. Wenn keiner von ihnen alle Bewertungskriterien für den Optimierer erfüllt, kann er seinen eigenen generierten Mindestkostenplan verwenden. Weitere Informationen finden Sie unter [Erfahren Sie, wie der Optimierer bestimmt, welche Pläne ausgeführt werden.](AuroraPostgreSQL.Optimize.UsePlans.md#AuroraPostgreSQL.Optimize.UsePlans.ChoosePlans). - **Zulässige Werte:** false / **Description:** Verwenden Sie den vom Optimierer generierten Minimalkostenplan. 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\_explain.hashes Gibt an, ob die auto\_explain-Ausgabe sql\_hash und plan\_hash anzeigt. Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich. - **0 (aus)** - **Zulässige Werte:** 0 (aus) / **Description:** Das Ergebnis von auto\_explain zeigt sql\_hash und plan\_hash nicht an. - **Zulässige Werte:** 1 (ein) / **Description:** Das Ergebnis von auto\_explain zeigt sql\_hash und plan\_hash an.