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 ini menyediakan satu set fungsi utilitas untuk mengelola dan memantau RDS Anda untuk PostgreSQL Aurora PostgreSQL  instance. Dengan menggunakan fungsi-fungsi ini, Anda dapat mendiagnosis masalah replikasi, vakum, dan konfigurasi langsung dari SQL, tanpa alat pemantauan terpisah. Fungsi-fungsi ini merupakan tambahan dari 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.

 Setiap deskripsi fungsi mencatat versi `rds_tools` ekstensi di mana fungsi menjadi tersedia.

Untuk membuat ekstensi, jalankan perintah berikut.

```
postgres=> CREATE EXTENSION rds_tools;
CREATE EXTENSION
```

**Topics**
+ [rds\_tools.role\_password\_encryption\_type](#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\_encryption\_type
<a name="rds_tools.role_password_encryption_type"></a>

Mengembalikan metode enkripsi password yang digunakan untuk setiap peran database. Fungsi set-return ini mengecualikan peran RDS-protected sistem dari output. Tersedia dimulai dengan `rds_tools` ekstensi versi 1.0.

Untuk contoh menggunakan 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>
+ `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 yang dijalankan selama operasi blue/green penerapan. 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 penerapan, karena data tidak dapat direplikasi dengan benar ke lingkungan hijau. Tersedia dimulai 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>
+ `command_type`— Jenis perintah terbatas untuk memeriksa. 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. Mengembalikan `true` jika perintah terbatas dari jenis tertentu dijalankan selama penerapan, atau `false` jika tidak ada perintah tersebut 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 autovacuum yang memblokir atau tertinggal, bersama dengan saran untuk menyelesaikan setiap masalah. Jalankan fungsi set-return ini dalam database dengan ID transaksi tertua untuk hasil yang akurat. Untuk informasi selengkapnya, lihat [Mengidentifikasi dan menyelesaikan penghambat vakum agresif](Appendix.PostgreSQL.CommonDBATasks.Autovacuum_Monitoring.md).

Tersedia dimulai 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>
+ `blocker`— Kategori aktivitas database yang memblokir ruang hampa. 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-transaction, 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 dari sesi pemblokiran, jika berlaku.
+ `autovacuum_lagging_by`— Jumlah transaksi yang autovacuum tertinggal untuk kategori tersebut.
+ `suggestion`— Saran untuk menyelesaikan pemblokir, termasuk nama database, ID proses, dan tindakan yang harus diambil.
+ `suggested_action`— Berbagai 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 RDS untuk versi mesin PostgreSQL untuk instans DB Anda. Fungsi ini membaca informasi versi dari file konfigurasi instans. Tersedia dimulai 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 contoh sumber. Gunakan fungsi ini untuk mengelola pengaturan replikasi logis dan memahami titik konsistensi replikasi. Tersedia dimulai 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 instans DB. Anda menentukan pengenal ini saat membuat instans DB, dan layanan AWS menggunakannya untuk mengidentifikasi database Anda. Tersedia dimulai 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 instans 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) dari instans DB Anda. ID sumber daya DBI adalah pengidentifikasi unik dan tidak dapat diubah yang dihasilkan AWS untuk instans DB. Itu tetap konstan sepanjang masa hidup instance, bahkan jika Anda mengganti nama instance. Gunakan nilai ini untuk menghubungkan aktivitas database dengan CloudTrail log AWS atau layanan pemantauan AWS lainnya. Nilai ini cocok dengan `DbiResourceId` bidang yang dikembalikan oleh perintah [DBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DBInstance.html) RDS API. Tersedia dimulai 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 penerapan cluster Multi-AZ DB. Gunakan fungsi ini untuk memahami hubungan antara instance dalam Multi-AZ konfigurasi dan untuk memecahkan masalah skenario replikasi atau failover. Tersedia dimulai 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 sumber. Mengembalikan NULL jika instance bukan bagian dari cluster Multi-AZ 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 Multi-AZ kluster RDS, yang memungkinkan pengalihan cepat dengan menyediakan informasi koneksi untuk semua instance di cluster. Pustaka klien seperti AWS Advanced JDBC Wrapper Driver menggunakan fungsi set-return ini untuk terhubung langsung ke semua instance dalam klaster RDS. Multi-AZ Untuk mengidentifikasi ID sumber daya dari instance penulis, gunakan fungsi ini bersama dengan `rds_tools.multi_az_db_cluster_source_dbi_resource_id` fungsi. Tersedia dimulai 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>
+ `client_identifier`(opsional) — Pengenal untuk pustaka klien atau proxy yang menanyakan topologi. Parameter ini opsional tetapi direkomendasikan, karena memungkinkan Amazon RDS untuk melacak klien mana yang secara aktif menanyakan topologi dan menyediakan telemetri untuk dukungan klien tambahan.

### Output
<a name="rds_tools.show_topology-output"></a>
+ `id`— ID sumber daya DBI dari setiap instance di cluster RDS. Multi-AZ
+ `endpoint`— Titik akhir untuk setiap node di cluster.
+ `port`— Nomor port untuk setiap instance di Multi-AZ cluster RDS.
+ `role`— Peran node dalam cluster, seperti penulis atau pembaca.
+ `status`— Status node.
+ `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>

Daftar isi `pg_multixact` direktori, yang menyimpan data multitransaction di PostgreSQL. Gunakan fungsi set-return ini untuk memantau penggunaan multixact, memecahkan masalah terkait multixact, dan memahami pola penyimpanan database. Tersedia dimulai 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>
+ `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)
```