

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# referensi fungsi rds\_tools
<a name="PostgreSQL_rds_tools-functions-reference"></a>

 `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](https://www.postgresql.org/docs/current/functions.html) dalam dokumentasi PostgreSQL.

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
```

**Topics**
+ [rds\_tools.role\_password\_enkripsi](#rds_tools.role_password_encryption_type)
+ [rds\_tools.blue\_green\_get\_status](#rds_tools.blue_green_get_status)
+ [rds\_tools.postgres\_get\_av\_diag](#rds_tools.postgres_get_av_diag)
+ [rds\_tools.rds\_version](#rds_tools.rds_version)
+ [rds\_tools.logical\_seed\_lsn](#rds_tools.logical_seed_lsn)
+ [rds\_tools.db\_instance\_identifier](#rds_tools.db_instance_identifier)
+ [rds\_tools.dbi\_resource\_id](#rds_tools.dbi_resource_id)
+ [rds\_tools.multi\_az\_db\_cluster\_source\_dbi\_resource\_id](#rds_tools.multi_az_db_cluster_source_dbi_resource_id)
+ [rds\_tools.show\_topologi](#rds_tools.show_topology)
+ [rds\_tools.pg\_ls\_multixactdir](#rds_tools.pg_ls_multixactdir)

## rds\_tools.role\_password\_enkripsi
<a name="rds_tools.role_password_encryption_type"></a>

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](PostgreSQL_Password_Encryption_configuration.md).

### Prototipe fungsi
<a name="rds_tools.role_password_encryption_type-prototype"></a>

```
rds_tools.role_password_encryption_type()
```

### Argumen
<a name="rds_tools.role_password_encryption_type-arguments"></a>

Tidak ada.

### Output
<a name="rds_tools.role_password_encryption_type-output"></a>

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
<a name="rds_tools.role_password_encryption_type-example"></a>

```
=> 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
<a name="rds_tools.blue_green_get_status"></a>

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
<a name="rds_tools.blue_green_get_status-prototype"></a>

```
rds_tools.blue_green_get_status(command_type)
```

### Argumen
<a name="rds_tools.blue_green_get_status-arguments"></a>

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
<a name="rds_tools.blue_green_get_status-output"></a>

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
<a name="rds_tools.blue_green_get_status-example"></a>

```
=> SELECT rds_tools.blue_green_get_status('DDL');
 blue_green_get_status
-----------------------
 f
(1 row)
```

## rds\_tools.postgres\_get\_av\_diag
<a name="rds_tools.postgres_get_av_diag"></a>

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](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.md).

Tersedia mulai dengan `rds_tools` ekstensi versi 1.9.

### Prototipe fungsi
<a name="rds_tools.postgres_get_av_diag-prototype"></a>

```
rds_tools.postgres_get_av_diag()
```

### Argumen
<a name="rds_tools.postgres_get_av_diag-arguments"></a>

Tidak ada.

### Output
<a name="rds_tools.postgres_get_av_diag-output"></a>

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
<a name="rds_tools.postgres_get_av_diag-example"></a>

```
=> 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
<a name="rds_tools.rds_version"></a>

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
<a name="rds_tools.rds_version-prototype"></a>

```
rds_tools.rds_version()
```

### Argumen
<a name="rds_tools.rds_version-arguments"></a>

Tidak ada.

### Output
<a name="rds_tools.rds_version-output"></a>

String karakter yang berisi versi mesin.

### Contoh penggunaan
<a name="rds_tools.rds_version-example"></a>

```
=> SELECT rds_tools.rds_version();
 rds_version
-------------
 18.1.R1
(1 row)
```

## rds\_tools.logical\_seed\_lsn
<a name="rds_tools.logical_seed_lsn"></a>

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
<a name="rds_tools.logical_seed_lsn-prototype"></a>

```
rds_tools.logical_seed_lsn()
```

### Argumen
<a name="rds_tools.logical_seed_lsn-arguments"></a>

Tidak ada.

### Output
<a name="rds_tools.logical_seed_lsn-output"></a>

SEBUAH `pg_lsn` nilai.

### Contoh penggunaan
<a name="rds_tools.logical_seed_lsn-example"></a>

```
=> SELECT rds_tools.logical_seed_lsn();
 logical_seed_lsn
------------------
 0/1677B68
(1 row)
```

## rds\_tools.db\_instance\_identifier
<a name="rds_tools.db_instance_identifier"></a>

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
<a name="rds_tools.db_instance_identifier-prototype"></a>

```
rds_tools.db_instance_identifier()
```

### Argumen
<a name="rds_tools.db_instance_identifier-arguments"></a>

Tidak ada.

### Output
<a name="rds_tools.db_instance_identifier-output"></a>

String karakter yang berisi pengidentifikasi instance DB.

### Contoh penggunaan
<a name="rds_tools.db_instance_identifier-example"></a>

```
=> SELECT rds_tools.db_instance_identifier();
 db_instance_identifier
------------------------
 my-postgres-instance
(1 row)
```

## rds\_tools.dbi\_resource\_id
<a name="rds_tools.dbi_resource_id"></a>

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](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DBInstance.html) Perintah API RDS. Tersedia mulai dengan `rds_tools` ekstensi versi 1.4.

### Prototipe fungsi
<a name="rds_tools.dbi_resource_id-prototype"></a>

```
rds_tools.dbi_resource_id()
```

### Argumen
<a name="rds_tools.dbi_resource_id-arguments"></a>

Tidak ada.

### Output
<a name="rds_tools.dbi_resource_id-output"></a>

String karakter yang berisi ID sumber daya DBI.

### Contoh penggunaan
<a name="rds_tools.dbi_resource_id-example"></a>

```
=> SELECT rds_tools.dbi_resource_id();
          dbi_resource_id
-----------------------------------
 db-ABC123DEF456GHI789JKL012MNO345P
(1 row)
```

## rds\_tools.multi\_az\_db\_cluster\_source\_dbi\_resource\_id
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id"></a>

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
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id-prototype"></a>

```
rds_tools.multi_az_db_cluster_source_dbi_resource_id()
```

### Argumen
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id-arguments"></a>

Tidak ada.

### Output
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id-output"></a>

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
<a name="rds_tools.multi_az_db_cluster_source_dbi_resource_id-example"></a>

```
=> 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
<a name="rds_tools.show_topology"></a>

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
<a name="rds_tools.show_topology-prototype"></a>

```
rds_tools.show_topology([client_identifier])
```

### Argumen
<a name="rds_tools.show_topology-arguments"></a>

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
<a name="rds_tools.show_topology-output"></a>

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
<a name="rds_tools.show_topology-example"></a>

```
=> 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
<a name="rds_tools.pg_ls_multixactdir"></a>

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
<a name="rds_tools.pg_ls_multixactdir-prototype"></a>

```
rds_tools.pg_ls_multixactdir()
```

### Argumen
<a name="rds_tools.pg_ls_multixactdir-arguments"></a>

Tidak ada.

### Output
<a name="rds_tools.pg_ls_multixactdir-output"></a>

Fungsi ini mengembalikan kolom berikut:
+ `name` — Nama file atau direktori.
+ `size` — Ukuran dalam byte.
+ `modification` — Stempel waktu modifikasi terakhir.

### Contoh penggunaan
<a name="rds_tools.pg_ls_multixactdir-example"></a>

```
=> 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)
```