View a markdown version of this page

rds_tools-Funktionsreferenz - Amazon Aurora

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.

rds_tools-Funktionsreferenz

Die rds_tools Die Erweiterung bietet eine Reihe von Hilfsfunktionen zur Verwaltung und Überwachung Ihrer Aurora PostgreSQL DB-Instanz. Mit diesen Funktionen können Sie Replikations-, Vakuum- und Konfigurationsprobleme direkt von SQL aus diagnostizieren, ohne separate Überwachungstools. Diese Funktionen sind zusätzlich zu den PostgreSQL-Standardfunktionen verfügbar. Weitere Hinweise zu PostgreSQL-Standardfunktionen finden Sie unter Funktionen und Operatoren in der PostgreSQL-Dokumentation.

In diesem Abschnitt wird beschrieben rds_tools Funktionen verfügbar auf Aurora PostgreSQL. Jede Funktionsbeschreibung vermerkt rds_tools Erweiterungsversion, in der die Funktion verfügbar wurde.

Führen Sie den folgenden Befehl aus, um die Erweiterung zu erstellen.

postgres=> CREATE EXTENSION rds_tools; CREATE EXTENSION

rds_tools.role_password_encryption_type

Gibt die Methode zur Kennwortverschlüsselung zurück, die für jede Datenbankrolle verwendet wird. Diese Funktion, die einen Satz zurückgibt, schließt Folgendes aus RDS-protected Systemrollen aus der Ausgabe. Verfügbar ab rds_tools Erweiterung Version 1.0.

Ein Beispiel für die Verwendung dieser Funktion zur Überprüfung der Passwortverschlüsselung vor der Migration von Datenbankbenutzern zu SCRAM finden Sie unter Verwenden von SCRAM für die PostgreSQL-Passwortverschlüsselung.

Funktionsprototyp

rds_tools.role_password_encryption_type()

Argumente

Keine.

Ausgabe

Diese Funktion gibt die folgenden Spalten zurück:

  • rolname — Der Name der Datenbankrolle.

  • encryption_type — Die verwendete Methode zur Passwortverschlüsselung, z. B. md5 oder scram-sha-256.

Verwendungsbeispiel

=> SELECT * FROM rds_tools.role_password_encryption_type(); rolname | encryption_type ---------------+----------------- postgres | md5 app_user | md5 readonly_user | scram-sha-256 (3 rows)

rds_tools.postgres_get_av_diag

Ruft Diagnoseinformationen zu Autovakuumprozessen ab, die blockieren oder hinterherhinken, sowie Vorschläge zur Lösung der einzelnen Probleme. Führen Sie diese Funktion zur Rückgabe von Mengen in der Datenbank mit der ältesten Transaktions-ID aus, um genaue Ergebnisse zu erhalten. Weitere Informationen finden Sie unter Identifizieren und beheben Sie aggressive Vakuumblocker.

Verfügbar ab rds_tools Erweiterung Version 1.9.

Funktionsprototyp

rds_tools.postgres_get_av_diag()

Argumente

Keine.

Ausgabe

Diese Funktion gibt die folgenden Spalten zurück:

  • blocker — Die Kategorie der Datenbankaktivität, die das Vakuum blockiert. Der Wert ist einer der folgenden:

    • Aktive Anweisung

    • Leerlauf in Transaktion

    • Vorbereitete Transaktion

    • Logischer Replikations-Slot

    • Lesereplikat mit physischen Replikations-Slots

    • Lesereplikat mit Streaming-Replikation

    • Temporäre Tabellen

  • database — Der Name der Datenbank, in der die Blockierungsaktivität stattfindet.

  • blocker_identifier — Die Kennung der blockierenden Aktivität. Der Wert hängt vom Blockertyp ab:

    • Bei einer aktiven Anweisung oder einer Sitzung, die während einer Transaktion im Leerlauf läuft, die Prozess-ID mit ihrer SQL-Anweisung.

    • Für eine vorbereitete Transaktion der Name der vorbereiteten Transaktion.

    • Bei einem Read Replica die IP-Adresse des Replikats.

    • Für einen Replikationssteckplatz der Name des Replikationssteckplatzes.

  • wait_event — Das Warteereignis der Blockierungssitzung, falls zutreffend.

  • autovacuum_lagging_by — Die Anzahl der Transaktionen, bei denen Autovacuum in dieser Kategorie hinterherhinkt.

  • suggestion — Ein Vorschlag zur Behebung des Blockers, einschließlich des Datenbanknamens, der Prozess-ID und der auszuführenden Aktion.

  • suggested_action — Eine Reihe von Maßnahmen, die zur Behebung des Blockers ergriffen werden müssen.

Verwendungsbeispiel

=> SELECT * FROM rds_tools.postgres_get_av_diag() ORDER BY autovacuum_lagging_by DESC; blocker | Active statement database | my_database blocker_identifier | SELECT pg_sleep(20000); wait_event | Timeout:PgSleep autovacuum_lagging_by | 568600871 suggestion | Connect to database "my_database", review carefully, and consider terminating the process using suggested_action. suggested_action | {"SELECT pg_terminate_backend(29621);"}