View a markdown version of this page

referensi fungsi rds_tools - Amazon Aurora

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 Aurora 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 dalam dokumentasi PostgreSQL.

Bagian ini menjelaskan rds_tools fungsi yang tersedia di Aurora 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

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, seperti md5 atau scram-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.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);"}