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. 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 und Arbeiten mit DB-Parametergruppen in einer DB-Instance.

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.

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.

Standard	Zulässige Werte	Beschreibung
aus	Automatisch	Aktiviert die Planerfassung für alle Datenbanken auf der DB-Instance. Sammelt einen Plan für jede SQL-Anweisung, die mindestens zwei Mal ausgeführt wird. Verwenden Sie diese Einstellung für große oder sich entwickelnde Workloads, um Planstabilität zu gewährleisten.
	Manuell	Aktiviert die Planerfassung nur für nachfolgende Anweisungen, bis Sie sie wieder deaktivieren. Mit dieser Einstellung können Sie Abfrageausführungspläne nur für bestimmte kritische SQL-Anweisungen oder für bekannte problematische Abfragen erfassen.
	aus	Deaktiviert die Planerfassung.

Weitere Informationen finden Sie unter Erfassung von Aurora PostgreSQL-Ausführungsplänen.

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	Beschreibung
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.

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.

Standard	Zulässige Werte	Beschreibung
0	0 (aus)	EXPLAIN zeigt sql_hash und plan_hash ohne die Option true für die Hashes nicht an.
	1 (ein)	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.

Standard	Zulässige Werte	Beschreibung
none	none	Zeigt in den Protokolldateien kein Ergebnis der Plandurchsetzung an.
	on_error	Zeigt nur das Ergebnis der Plandurchsetzung in Protokolldateien an, wenn QPM keine verwalteten Pläne verwendet.
	all	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 Instanz 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	Beschreibung
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	Beschreibung
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.

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.

Standard	Zulässige Werte	Beschreibung
1	1	Standardberechnung von plan_hash.
	2	plan_hash-Berechnung für die Unterstützung mehrerer Schemas geändert.
	3	plan_hash-Berechnung für die Unterstützung mehrerer Schemas und Unterstützung partitionierter Tabellen geändert.
	4	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	Beschreibung
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.

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.

Um den Wert dieses Parameters zu ändern, ist kein Neustart erforderlich.

Standard	Zulässige Werte	Beschreibung
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.

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. Ein Bild, das diesen Prozess detailliert beschreibt, finden Sie unter Erfahren Sie, wie der Optimierer bestimmt, welche Pläne ausgeführt werden..

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.

Standard	Zulässige Werte	Beschreibung
false	true	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..
	false	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 Pflege der Aurora-PostgreSQL-Ausführungspläne.

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.

Standard	Zulässige Werte	Beschreibung
0 (aus)	0 (aus)	Das Ergebnis von auto_explain zeigt sql_hash und plan_hash nicht an.
	1 (ein)	Das Ergebnis von auto_explain zeigt sql_hash und plan_hash an.