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 RDS für 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 diesem Abschnitt wird beschrieben rds_tools Funktionen verfügbar auf RDS für 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
Themen
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.md5oderscram-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.blau_grün_get_status
Prüfungen auf eingeschränkte Befehle werden während ausgeführt blue/green Bereitstellungsvorgänge. Während blue/green Bei Bereitstellungen, die logische Replikation verwenden, können Sie keine DDL-Befehle (Data Definition Language) oder LO-Operationen (Large Object) zwischen der blauen und der grünen Umgebung replizieren. Wenn ein eingeschränkter Befehl erkannt wird, starten Sie den blue/green Bereitstellung, da die Daten nicht ordnungsgemäß in die grüne Umgebung repliziert werden können. Verfügbar ab rds_tools Erweiterung Version 1.3.
Funktionsprototyp
rds_tools.blue_green_get_status(command_type)
Argumente
Diese Funktion verwendet das folgende Argument:
-
command_type— Der Typ des eingeschränkten Befehls, der überprüft werden soll. Gültige Werte sind'DDL'(Befehle in der Datendefinitionssprache) und'LO'(Operationen mit großen Objekten).
Ausgabe
Ein boolean-Wert. Kehrt zurück true wenn während der Bereitstellung ein eingeschränkter Befehl des angegebenen Typs ausgeführt wurde, oder false wenn kein solcher Befehl erkannt wurde.
Verwendungsbeispiel
=> SELECT rds_tools.blue_green_get_status('DDL'); blue_green_get_status ----------------------- f (1 row)
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);"}
rds_tools.rds_version
Zeigt die Version der RDS for PostgreSQL Engine für Ihre DB-Instance an. Diese Funktion liest die Versionsinformationen aus den Konfigurationsdateien der Instance. Verfügbar ab rds_tools Erweiterung Version 1.1.
Funktionsprototyp
rds_tools.rds_version()
Argumente
Keine.
Ausgabe
Eine Zeichenfolge, die die Engine-Version enthält.
Verwendungsbeispiel
=> SELECT rds_tools.rds_version(); rds_version ------------- 18.1.R1 (1 row)
rds_tools.logical_seed_lsn
Gibt die logische Seed-Log-Sequenznummer (LSN) zurück, die den Punkt darstellt, an dem die logische Replikation von der Quellinstanz abweicht. Verwenden Sie diese Funktion, um logische Replikationseinrichtungen zu verwalten und die Konsistenzpunkte der Replikation zu verstehen. Verfügbar ab rds_tools Erweiterung Version 1.2.
Funktionsprototyp
rds_tools.logical_seed_lsn()
Argumente
Keine.
Ausgabe
Ein pg_lsn-Wert.
Verwendungsbeispiel
=> SELECT rds_tools.logical_seed_lsn(); logical_seed_lsn ------------------ 0/1677B68 (1 row)
rds_tools.db_instance_identifier
Zeigt die DB-Instance-ID an. Sie geben diese Kennung an, wenn Sie die DB-Instance erstellen, und die AWS-Services verwenden sie durchgehend, um Ihre Datenbank zu identifizieren. Verfügbar ab rds_tools Erweiterung Version 1.2.
Funktionsprototyp
rds_tools.db_instance_identifier()
Argumente
Keine.
Ausgabe
Eine Zeichenfolge, die den DB-Instance-Bezeichner enthält.
Verwendungsbeispiel
=> SELECT rds_tools.db_instance_identifier(); db_instance_identifier ------------------------ my-postgres-instance (1 row)
rds_tools.dbi_resource_id
Zeigt die DB-Instance-Ressourcen-ID (DBI-Ressourcen-ID) Ihrer DB-Instance an. Die DBI-Ressourcen-ID ist eine eindeutige, unveränderliche Kennung, die AWS für die DB-Instance generiert. Sie bleibt während der gesamten Lebensdauer der Instance konstant, auch wenn Sie die Instance umbenennen. Verwenden Sie diesen Wert, um die Datenbankaktivität mit AWS zu korrelieren CloudTrail Protokolle oder andere AWS-Überwachungsdienste. Dieser Wert entspricht dem DbiResourceId von der zurückgegebenes Feld DBInstance RDS-API-Befehl. Verfügbar ab rds_tools Erweiterung Version 1.4.
Funktionsprototyp
rds_tools.dbi_resource_id()
Argumente
Keine.
Ausgabe
Eine Zeichenfolge, die die DBI-Ressourcen-ID enthält.
Verwendungsbeispiel
=> SELECT rds_tools.dbi_resource_id(); dbi_resource_id ----------------------------------- db-ABC123DEF456GHI789JKL012MNO345P (1 row)
rds_tools.multi_az_db_cluster_source_dbi_resource_id
Zeigt die DBI-Ressourcen-ID der Quell-Instance für eine Multi-AZ Bereitstellung eines DB-Clusters. Verwenden Sie diese Funktion, um die Beziehung zwischen Instanzen in einem zu verstehen Multi-AZ Konfiguration und zur Fehlerbehebung bei Replikations- oder Failover-Szenarien. Verfügbar ab rds_tools Erweiterung Version 1.4.
Funktionsprototyp
rds_tools.multi_az_db_cluster_source_dbi_resource_id()
Argumente
Keine.
Ausgabe
Eine Zeichenfolge, die die Quell-DBI-Ressourcen-ID enthält. Gibt NULL zurück, wenn die Instanz nicht Teil von ist Multi-AZ DB-Cluster, die Konfigurationsdatei existiert nicht, oder dbi_resource_id Das Feld ist in der Konfiguration nicht vorhanden.
Verwendungsbeispiel
=> SELECT rds_tools.multi_az_db_cluster_source_dbi_resource_id(); multi_az_db_cluster_source_dbi_resource_id -------------------------------------------- db-XYZ789ABC123DEF456GHI012JKL345MNO678P (1 row)
rds_tools.show_topology
Zeigt Topologie-Metadaten für RDS an Multi-AZ Cluster, die schnelle Switchover ermöglichen, indem Verbindungsinformationen für alle Instances im Cluster bereitgestellt werden. Client-Bibliotheken wie der AWS Advanced JDBC Wrapper Driver verwenden diese Set-Returning-Funktion, um sich direkt mit allen Instances in einem RDS zu verbinden Multi-AZ Cluster. Um die Ressourcen-ID der Writer-Instanz zu identifizieren, verwenden Sie diese Funktion zusammen mit rds_tools.multi_az_db_cluster_source_dbi_resource_id Funktion. Verfügbar ab rds_tools Erweiterung Version 1.4.
Funktionsprototyp
rds_tools.show_topology([client_identifier])
Argumente
Diese Funktion verwendet das folgende Argument:
-
client_identifier(optional) — Ein Bezeichner für die Client-Bibliothek oder den Proxy, der die Topologie abfragt. Dieser Parameter ist optional, wird aber empfohlen, da Amazon RDS damit verfolgen kann, welche Clients aktiv die Topologie abfragen, und Telemetrie zur Unterstützung weiterer Clients bereitstellt.
Ausgabe
Diese Funktion gibt die folgenden Spalten zurück:
-
id— Die DBI-Ressourcen-ID jeder Instanz im RDS Multi-AZ Cluster. -
endpoint— Der Endpunkt für jeden Knoten im Cluster. -
port— Die Portnummer für jede Instance im RDS Multi-AZ Cluster. -
role— Die Rolle des Knotens im Cluster, z. B. Autor oder Leser. -
status— Der Status des Knotens. -
version— Die Version des Topologiedatensatzes.
Verwendungsbeispiel
=> SELECT id, endpoint, port, role FROM rds_tools.show_topology('my-jdbc-app'); id | endpoint | port | role -----------------+-----------------------------------------------------------+------+-------- db-IDENTIFIER-1 | somedb-instance-1.aaaaaaaaaaaa.us-west-2.rds.amazonaws.com | 5432 | writer db-IDENTIFIER-2 | somedb-instance-2.aaaaaaaaaaaa.us-west-2.rds.amazonaws.com | 5432 | reader db-IDENTIFIER-3 | somedb-instance-3.aaaaaaaaaaaa.us-west-2.rds.amazonaws.com | 5432 | reader (3 rows)
rds_tools.pg_ls_multixactdir
Listet den Inhalt von pg_multixact Verzeichnis, das Multitransaktionsdaten in PostgreSQL speichert. Verwenden Sie diese Set-Returning-Funktion, um die Nutzung von Multixact zu überwachen, Probleme im Zusammenhang mit Multixact zu beheben und die Speichermuster von Datenbanken zu verstehen. Verfügbar ab rds_tools Erweiterung Version 1.7.
Funktionsprototyp
rds_tools.pg_ls_multixactdir()
Argumente
Keine.
Ausgabe
Diese Funktion gibt die folgenden Spalten zurück:
-
name— Der Name der Datei oder des Verzeichnisses. -
size— Die Größe in Byte. -
modification— Der Zeitstempel der letzten Änderung.
Verwendungsbeispiel
=> SELECT * FROM rds_tools.pg_ls_multixactdir(); name | size | modification ---------------------------+------+------------------------ pg_multixact/members/ | 4096 | 2026-10-01 19:17:29+00 pg_multixact/members/0000 | 8192 | 2025-08-22 21:53:46+00 pg_multixact/offsets/ | 4096 | 2026-10-01 19:17:29+00 pg_multixact/offsets/0000 | 8192 | 2026-10-01 19:22:38+00 (4 rows)