Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
referensi fungsi rds_tools
rds_tools ekstensi menyediakan satu set fungsi utilitas untuk mengelola dan memantau RDS untuk PostgreSQL Instans DB. Dengan menggunakan fungsi-fungsi ini, Anda dapat mendiagnosis masalah replikasi, vakum, dan konfigurasi langsung dari SQL, tanpa alat pemantauan terpisah. Fungsi-fungsi ini adalah tambahan untuk fungsi PostgreSQL standar. Untuk informasi selengkapnya tentang fungsi PostgreSQL standar, lihat Fungsi dan Operator
Bagian ini menjelaskan rds_tools fungsi yang tersedia di RDS untuk PostgreSQL. Setiap deskripsi fungsi mencatat rds_tools versi ekstensi di mana fungsi menjadi tersedia.
Untuk membuat ekstensi, jalankan perintah berikut.
postgres=> CREATE EXTENSION rds_tools; CREATE EXTENSION
Topik
rds_tools.role_password_enkripsi
Mengembalikan metode enkripsi kata sandi yang digunakan untuk setiap peran database. Fungsi pengembalian set ini tidak termasuk RDS-protected peran sistem dari output. Tersedia mulai dengan rds_tools ekstensi versi 1.0.
Untuk contoh penggunaan fungsi ini untuk meninjau enkripsi kata sandi sebelum memigrasikan pengguna database ke SCRAM, lihat Menggunakan SCRAM untuk enkripsi kata sandi PostgreSQL.
Prototipe fungsi
rds_tools.role_password_encryption_type()
Argumen
Tidak ada.
Output
Fungsi ini mengembalikan kolom berikut:
-
rolname— Nama peran database. -
encryption_type— Metode enkripsi kata sandi yang digunakan, sepertimd5atauscram-sha-256.
Contoh penggunaan
=> 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.blue_green_get_status
Memeriksa perintah terbatas dijalankan selama blue/green operasi penyebaran. Selama blue/green penerapan yang menggunakan replikasi logis, Anda tidak dapat mereplikasi perintah bahasa definisi data (DDL) atau operasi objek besar (LO) antara lingkungan biru dan hijau. Jika perintah terbatas terdeteksi, mulai ulang blue/green penyebaran, karena data tidak dapat direplikasi dengan benar ke lingkungan hijau. Tersedia mulai dengan rds_tools ekstensi versi 1.3.
Prototipe fungsi
rds_tools.blue_green_get_status(command_type)
Argumen
Fungsi ini mengambil argumen berikut:
-
command_type— Jenis perintah terbatas untuk diperiksa. Nilai yang valid adalah'DDL'(perintah bahasa definisi data) dan'LO'(operasi objek besar).
Output
SEBUAH boolean nilai. Pengembalian true jika perintah terbatas dari jenis yang ditentukan dijalankan selama penerapan, atau false jika tidak ada perintah seperti itu yang terdeteksi.
Contoh penggunaan
=> SELECT rds_tools.blue_green_get_status('DDL'); blue_green_get_status ----------------------- f (1 row)
rds_tools.postgres_get_av_diag
Mengambil informasi diagnostik tentang proses autopacuum yang memblokir atau tertinggal, bersama dengan saran untuk menyelesaikan setiap masalah. Jalankan fungsi set-return ini di database dengan ID transaksi tertua untuk hasil yang akurat. Untuk informasi lebih lanjut, lihat Mengidentifikasi dan mengatasi penghambat vakum agresif.
Tersedia mulai dengan rds_tools ekstensi versi 1.9.
Prototipe fungsi
rds_tools.postgres_get_av_diag()
Argumen
Tidak ada.
Output
Fungsi ini mengembalikan kolom berikut:
-
blocker— Kategori aktivitas database yang memblokir vakum. Nilainya adalah salah satu dari berikut ini:Pernyataan aktif
Idle pada transaksi
Transaksi yang disiapkan
Slot replikasi logis
Baca replika dengan slot replikasi fisik
Baca replika dengan replikasi streaming
Tabel sementara
-
database— Nama database tempat aktivitas pemblokiran terjadi. -
blocker_identifier— Pengidentifikasi aktivitas pemblokiran. Nilainya tergantung pada jenis pemblokir:Untuk pernyataan aktif atau sesi idle-in-transaksi, ID proses dengan pernyataan SQL-nya.
Untuk transaksi yang disiapkan, nama transaksi yang disiapkan.
Untuk replika baca, alamat IP replika.
Untuk slot replikasi, nama slot replikasi.
-
wait_event— Acara tunggu sesi pemblokiran, jika berlaku. -
autovacuum_lagging_by— Jumlah transaksi di mana autopacuum tertinggal untuk kategori tersebut. -
suggestion— Saran untuk menyelesaikan pemblokir, termasuk nama database, ID proses, dan tindakan yang harus diambil. -
suggested_action— Serangkaian tindakan yang harus diambil untuk menyelesaikan pemblokir.
Contoh penggunaan
=> 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
Menampilkan versi mesin RDS untuk PostgreSQL untuk instans DB Anda. Fungsi ini membaca informasi versi dari file konfigurasi instance. Tersedia mulai dengan rds_tools ekstensi versi 1.1.
Prototipe fungsi
rds_tools.rds_version()
Argumen
Tidak ada.
Output
String karakter yang berisi versi mesin.
Contoh penggunaan
=> SELECT rds_tools.rds_version(); rds_version ------------- 18.1.R1 (1 row)
rds_tools.logical_seed_lsn
Mengembalikan nomor urutan log benih logis (LSN) yang mewakili titik di mana replikasi logis menyimpang dari instance sumber. Gunakan fungsi ini untuk mengelola pengaturan replikasi logis dan memahami titik konsistensi replikasi. Tersedia mulai dengan rds_tools ekstensi versi 1.2.
Prototipe fungsi
rds_tools.logical_seed_lsn()
Argumen
Tidak ada.
Output
SEBUAH pg_lsn nilai.
Contoh penggunaan
=> SELECT rds_tools.logical_seed_lsn(); logical_seed_lsn ------------------ 0/1677B68 (1 row)
rds_tools.db_instance_identifier
Menampilkan pengidentifikasi instance DB. Anda menentukan pengidentifikasi ini saat membuat instance DB, dan layanan AWS menggunakannya secara keseluruhan untuk mengidentifikasi database Anda. Tersedia mulai dengan rds_tools ekstensi versi 1.2.
Prototipe fungsi
rds_tools.db_instance_identifier()
Argumen
Tidak ada.
Output
String karakter yang berisi pengidentifikasi instance DB.
Contoh penggunaan
=> SELECT rds_tools.db_instance_identifier(); db_instance_identifier ------------------------ my-postgres-instance (1 row)
rds_tools.dbi_resource_id
Menampilkan ID sumber daya instans DB (ID sumber daya DBI) instans DB Anda. ID sumber daya DBI adalah pengenal unik yang tidak dapat diubah yang dihasilkan AWS untuk instans DB. Itu tetap konstan sepanjang masa pakai instance, bahkan jika Anda mengganti nama instance. Gunakan nilai ini untuk menghubungkan aktivitas database dengan AWS CloudTrail log atau layanan pemantauan AWS lainnya. Nilai ini cocok dengan DbiResourceId Bidang dikembalikan oleh DB-Instance Perintah API RDS. Tersedia mulai dengan rds_tools ekstensi versi 1.4.
Prototipe fungsi
rds_tools.dbi_resource_id()
Argumen
Tidak ada.
Output
String karakter yang berisi ID sumber daya DBI.
Contoh penggunaan
=> SELECT rds_tools.dbi_resource_id(); dbi_resource_id ----------------------------------- db-ABC123DEF456GHI789JKL012MNO345P (1 row)
rds_tools.multi_az_db_cluster_source_dbi_resource_id
Menampilkan ID sumber daya DBI dari instance sumber untuk Multi-AZ Penyebaran cluster DB. Gunakan fungsi ini untuk memahami hubungan antara instance dalam Multi-AZ konfigurasi dan untuk memecahkan masalah skenario replikasi atau failover. Tersedia mulai dengan rds_tools ekstensi versi 1.4.
Prototipe fungsi
rds_tools.multi_az_db_cluster_source_dbi_resource_id()
Argumen
Tidak ada.
Output
String karakter yang berisi ID sumber daya DBI. Mengembalikan NULL jika instance bukan bagian dari Multi-AZ Cluster DB, file konfigurasi tidak ada, atau dbi_resource_id bidang tidak ada dalam konfigurasi.
Contoh penggunaan
=> 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_topologi
Menampilkan metadata topologi untuk RDS Multi-AZ cluster, yang memungkinkan peralihan cepat dengan menyediakan informasi koneksi untuk semua instance di cluster. Pustaka klien seperti AWS Advanced JDBC Wrapper Driver menggunakan fungsi pengembalian set ini untuk terhubung langsung ke semua instance dalam RDS Multi-AZ klaster. Untuk mengidentifikasi ID sumber daya dari instance penulis, gunakan fungsi ini bersama-sama dengan rds_tools.multi_az_db_cluster_source_dbi_resource_id fungsi. Tersedia mulai dengan rds_tools ekstensi versi 1.4.
Prototipe fungsi
rds_tools.show_topology([client_identifier])
Argumen
Fungsi ini mengambil argumen berikut:
-
client_identifier(opsional) — Pengidentifikasi untuk pustaka klien atau proxy yang menanyakan topologi. Parameter ini opsional tetapi direkomendasikan, karena memungkinkan Amazon RDS melacak klien mana yang secara aktif menanyakan topologi dan menyediakan telemetri untuk dukungan klien tambahan.
Output
Fungsi ini mengembalikan kolom berikut:
-
id— ID sumber daya DBI dari setiap instans di RDS Multi-AZ klaster. -
endpoint— Titik akhir untuk setiap node dalam cluster. -
port— Nomor port untuk setiap instance di RDS Multi-AZ klaster. -
role— Peran node dalam cluster, seperti penulis atau pembaca. -
status— Status simpul. -
version— Versi catatan topologi.
Contoh penggunaan
=> 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
Mencantumkan isi dari pg_multixact direktori, yang menyimpan data multitransaksi di PostgreSQL. Gunakan fungsi pengembalian set ini untuk memantau penggunaan multixact, memecahkan masalah terkait multixact, dan memahami pola penyimpanan database. Tersedia mulai dengan rds_tools ekstensi versi 1.7.
Prototipe fungsi
rds_tools.pg_ls_multixactdir()
Argumen
Tidak ada.
Output
Fungsi ini mengembalikan kolom berikut:
-
name— Nama file atau direktori. -
size— Ukuran dalam byte. -
modification— Stempel waktu modifikasi terakhir.
Contoh penggunaan
=> 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)