Konfigurationsparameter

Sie können das Verhalten und die Leistung von Analysen mithilfe von PostgreSQL-Konfigurationsparametern konfigurieren. Sie können diese Parameter auf Sitzungs-, Datenbank-, Benutzer- oder DB-Cluster-Parametergruppenebene mit standardmäßigen PostgreSQL-Befehlen festlegen.

In der folgenden Tabelle sind alle Analytics-Konfigurationsparameter aufgeführt.

Analytics-Konfigurationsparameter

Parametername	Description	Standard	Modifizierbar durch
aurora_analytics.enabled	Aktiviert die Erweiterung aurora_analytics	false	Parametergruppe
aurora_analytics.query_mem	(KB) Legt den maximalen Speicher fest, den eine einzelne aurora_analytics Abfrage verwenden kann.	Abgeleitet (z. B. 4 GB)	Jeder Benutzer
aurora_analytics.lowercase_unquoted_column_name	Beim Ableiten aurora_analytics fremder Tabellenspalten werden Spaltennamen ohne Anführungszeichen in Kleinbuchstaben geschrieben.	true	Jeder Benutzer
aurora_analytics.skip_unsupported_columns	Überspringt Spalten mit nicht unterstützten Datentypen oder widersprüchlichen Namen, wenn fremde Tabellenspalten abgeleitet werden. aurora_analytics	false	Jeder Benutzer
aurora_analytics.enable_logging	Aktiviert die Protokollierung füraurora_analytics.	true	rds_superuser
aurora_analytics.logging_level	Legt die detaillierte Protokollierung für festaurora_analytics.	WARNING	rds_superuser
aurora_analytics.track_detailed_metrics	Sammelt detaillierte Leistungskennzahlen pro Abfrage füraurora_analytics.	false	Jeder Benutzer

aurora_analytics.enabled

Aktiviert die Erweiterung. aurora_analytics

Eigenschaften für aurora_analytics.enabled

Eigenschaft	Wert
Standard	false
Zulässige Werte	true, false
Typ	Boolesch
Typ anwenden	Dynamisch
Scope	DB-Cluster-Parametergruppe

Dieser Parameter ist der primäre Schalter für die Analysefunktion. Stellen Sie ihn true in Ihrer DB-Cluster-Parametergruppe auf ein, um die Funktion zu aktivieren. Da es sich um einen dynamischen Parameter handelt, wird die Änderung sofort und ohne Neustart übernommen. Nach der Aktivierung können Sie die Erweiterung (CREATE EXTENSION aurora_analytics) in jeder Datenbank installieren.

aurora_analytics.query_mem

(KB) Legt den maximalen Speicher fest, den eine einzelne Abfrage verwenden kann. aurora_analytics

Eigenschaften für aurora_analytics.query_mem

Eigenschaft	Wert
Standard	Aus dem Instanzspeicher abgeleitet (z. B. 4 GB)
Zulässige Werte	Zeichenfolge mit Einheit (z. B.'2GB','16GB') oder Ganzzahl in Kilobyte (kB)
Typ	Arbeitsspeicher
Kontext	User-settable
Scope	Sitzung, Benutzer, Datenbank, Parametergruppe

Dieser Parameter steuert den maximalen Speicher, den die Analytics-Ausführungs-Engine für die Verarbeitung einer einzelnen Abfrage zuweist. Dieser Speicher wird für Hashtabellen, Sortierung, Aggregationspuffer und Zwischenergebnisse verwendet. Sie können den Wert als Zeichenfolge mit einem Einheitensuffix (z. B.'4GB') oder als Ganzzahl in Kilobyte (kB) angeben, wobei 1 kB 1024 Byte entspricht, wobei die PostgreSQL-Speichereinheitenkonvention eingehalten wird.

Wenn sich die Speichernutzung einer Abfrage diesem Grenzwert nähert, gibt die Engine Zwischenergebnisse in den temporären lokalen Speicher aus. Durch Verschütten kann die Abfrage abgeschlossen werden, allerdings mit verminderter Leistung.

Standardberechnung

Aurora leitet den Standard aus dem Instanzspeicher ab und verwendet dabei den kleinsten von drei Begriffen:

query_mem = LEAST(
    48 GiB,                                  -- ceiling for the derived default
    DBInstanceClassMemory x 12.5%,           -- lower bound on smaller instances
    DBInstanceClassMemory x 3.125% + 8 GiB   -- lower bound on larger instances
)

Die folgende Tabelle zeigt ungefähre Standardwerte nach Instance-Klassen:

Standard query_mem nach Instanzklasse

Instance-Klasse	Instanzspeicher	Standard query_mem
db.r8gd.large	16 GB	~2 GB
db.r8gd.xlarge	32 GB	~4 GB
db.r8gd.2xlarge	64 GB	~8 GB
db.r8gd.4xlarge	128 GB	~12 GB
db.r8gd.8xlarge	256 GB	~16 GB
db.r8gd.16xlarge	512 GB	~24 GB

Bei diesen Werten handelt es sich um Näherungswerte, da bei der Ableitung ein Wert verwendet wirdDBInstanceClassMemory, der geringfügig unter dem nominalen Speicher der Instanzklasse liegt.

Anmerkung

SHOW aurora_analytics.query_memgibt den von Ihnen angeforderten Wert zurück, nicht unbedingt den Wert, den die Engine verwendet. Das effektive Limit ist auf den Instanzspeicher abzüglich des Speichers begrenzt, der für die gemeinsam genutzten Strukturen der Engine reserviert ist. Das Einstellen eines höheren Werts ist erfolgreich, aber die Engine verwendet weiterhin den begrenzten Wert.

Wann sollte dieser Wert erhöht werden:

• Abfragen schlagen fehl, weil nicht genügend Arbeitsspeicher zur Verfügung steht.

• Sie führen komplexe Aggregationen und Verknüpfungen aus, die Millionen von Zeilen verarbeiten.

• Es werden nur wenige Analysesitzungen gleichzeitig ausgeführt.

Wann sollte dieser Wert verringert werden:

• Viele Benutzer führen gleichzeitig analytische Abfragen durch.

• Sie beobachten den Speicherdruck in der gesamten DB-Instance.

Verwendungsbeispiele

Legen Sie unterschiedliche Grenzwerte für verschiedene Benutzerrollen fest:

-- Heavy analytics users
ALTER USER data_scientist SET aurora_analytics.query_mem = '16GB';
-- Light reporting users
ALTER USER dashboard_user SET aurora_analytics.query_mem = '8GB';

Verwenden Sie eine Einstellung auf Sitzungsebene für eine bestimmte komplexe Abfrage:

SET aurora_analytics.query_mem = '16GB';
SELECT complex_aggregation FROM ft_large_table;
RESET aurora_analytics.query_mem;

Anmerkung

Als bewährte Methode sollten Sie sicherstellen, dass dieser Wert etwa 30% des Instance-Speichers concurrent_sessions x query_mem nicht überschreitet.

aurora_analytics.lowercase_unquoted_column_name

Kleinbuchstaben von Spaltennamen ohne Anführungszeichen beim Ableiten fremder Tabellenspalten aurora_analytics

Eigenschaften für aurora_analytics.lowercase_unquoted_column_name

Eigenschaft	Wert
Standard	true
Zulässige Werte	true, false
Typ	Boolesch
Kontext	User-settable
Scope	Sitzung, Benutzer, Datenbank, Parametergruppe

Wenn Aurora PostgreSQL das Schema einer Fremdtabelle (erstellt mit leeren Klammern) ableitet, liest es Spaltennamen aus Parquet- oder Iceberg-Metadaten. Parquet-Dateien enthalten häufig Spaltennamen mit gemischter Groß- und Kleinschreibung wie oder. OrderDate CustomerID

Wenn diese Option auf true (Standard) gesetzt ist, werden Spaltennamen in Kleinbuchstaben geschrieben, um dem Standardverhalten von PostgreSQL ohne Bezeichner ohne Anführungszeichen zu entsprechen. Beispielsweise wird OrderDate zu orderdate.

Wenn auf gesetzt, werden Spaltennamen mit gemischter Groß false - und Kleinschreibung beibehalten. Sie müssen Bezeichner in doppelten Anführungszeichen verwenden, um auf sie zu verweisen (z. B.). SELECT "OrderDate" FROM ft_orders

Anmerkung

Belassen Sie diesen Parameter auf true (Standard), um die natürlichste PostgreSQL-Erfahrung zu erzielen.

aurora_analytics.skip_unsupported_columns

Überspringt Spalten mit nicht unterstützten Datentypen oder widersprüchlichen Namen, wenn fremde Tabellenspalten abgeleitet werden. aurora_analytics

Eigenschaften für aurora_analytics.skip_unsupported_columns

Eigenschaft	Wert
Standard	false
Zulässige Werte	true, false
Typ	Boolesch
Kontext	User-settable
Scope	Sitzung, Benutzer, Datenbank, Parametergruppe

Wenn auf false (Standard) gesetzt, gibt Aurora PostgreSQL einen Fehler aus, wenn es bei der Schemainferenz auf einen nicht unterstützten Spaltentyp stößt.

Wenn diese Option auf gesetzt ist, werden Spalten, die nicht unterstützt werdentrue, automatisch übersprungen. Die Fremdtabelle wird nur mit den unterstützten Spalten erstellt, sodass Sie die verbleibenden Daten abfragen können.

Legen Sie diesen Parameter auf fest, true wenn Ihre Quelldaten eine Mischung aus unterstützten und nicht unterstützten Spaltentypen enthalten und Sie nur eine Teilmenge von Spalten benötigen.

aurora_analytics.enable_logging

Aktiviert die Protokollierung für. aurora_analytics

Eigenschaften für aurora_analytics.enable_logging

Eigenschaft	Wert
Standard	true
Zulässige Werte	true, false
Typ	Boolesch
Kontext	Nur rds_superuser
Scope	Sitzung, Benutzer, Datenbank, Parametergruppe

Wenn diese Option aktiviert ist, schreibt die Analyse-Engine Diagnosemeldungen mit der Ausführlichkeitsstufe, die von angegeben ist, in das PostgreSQL-Fehlerprotokoll. aurora_analytics.logging_level

aurora_analytics.logging_level

Legt die detaillierte Protokollierung für fest. aurora_analytics

Eigenschaften für aurora_analytics.logging_level

Eigenschaft	Wert
Standard	WARNING
Zulässige Werte	DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC
Typ	Enum
Kontext	Nur rds_superuser
Scope	Sitzung, Benutzer, Datenbank, Parametergruppe

Dieser Parameter steuert die Ausführlichkeit der Analytics-Engine-Nachrichten, die in das PostgreSQL-Fehlerprotokoll geschrieben werden. Verwenden Sie DEBUG1 oder höher für die Fehlerbehebung. Verwenden Sie WARNING (Standard) oder ERROR für Produktionsworkloads, um das Protokollvolumen zu minimieren.

Dieser Parameter muss aurora_analytics.enable_logging auf gesetzt seintrue.

aurora_analytics.track_detailed_metrics

Sammelt detaillierte Leistungskennzahlen pro Abfrage für. aurora_analytics

Eigenschaften für aurora_analytics.track_detailed_metrics

Eigenschaft	Wert
Standard	false
Zulässige Werte	true, false
Typ	Boolesch
Kontext	User-settable
Scope	Sitzung, Benutzer, Datenbank, Parametergruppe

Wenn diese Option aktiviert ist, sammelt Aurora PostgreSQL detaillierte Metriken pro Abfrage, wie Cache-Trefferquoten und Datenübertragungsstatistiken. Sie können diese Metriken mithilfe der Analytics-Statistikfunktionen abrufen.

Aktivieren Sie diesen Parameter, wenn Sie die Cache-Leistung analysieren oder langsame Abfragen diagnostizieren müssen. Weitere Informationen finden Sie unter Ressourcenmanagement.