Atur parameter instans RDS for PostgreSQL - ApsaraDB RDS

Topik ini menjelaskan cara memodifikasi parameter instans ApsaraDB RDS for PostgreSQL untuk mengoptimalkan kinerja atau memenuhi kebutuhan bisnis Anda. Anda juga dapat melihat riwayat modifikasi parameter.

Catatan penggunaan

Memodifikasi beberapa parameter akan memicu restart instans. Instans akan segera direstart setelah Anda memodifikasi parameter dan mengklik Apply Parameters. Untuk memeriksa apakah modifikasi suatu parameter memicu restart, lihat kolom Force Restart pada tab Modifiable Parameters. Jika instans direstart, aplikasi Anda akan terputus. Pastikan bisnis Anda dapat menoleransi restart tersebut sebelum melanjutkan.
Saat memodifikasi parameter di Konsol, rujuk kolom Valid Values pada tab Modifiable Parameters untuk mengetahui nilai yang diizinkan.
Saat Anda memodifikasi parameter berikut pada instans primary, perubahan tersebut akan disinkronkan ke semua instans read-only terkait:
wal_level, max_replication_slots, max_wal_senders, max_locks_per_transaction, max_worker_processes, max_prepared_transactions
Saat Anda memodifikasi parameter, sistem akan mencoba menerapkan perubahan tersebut. Jika nilai baru tidak valid atau menyebabkan instans gagal, modifikasi akan dikembalikan (rollback) dan hasilnya ditandai sebagai Failed. Anda dapat melihat hasilnya di kolom Status pada tab Edit History.
Parameter log_statement tidak dapat dimodifikasi secara langsung. Untuk mengubah parameter ini, aktifkan atau nonaktifkan SQL Explorer and Audit.

Modifikasi nilai parameter

Masuk ke Konsol ApsaraDB RDS dan buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada. Lalu, temukan instans RDS tersebut dan klik ID instansnya.
Di panel navigasi kiri, klik Parameters.
Pada tab Modifiable Parameters, temukan parameter yang ingin Anda modifikasi. Anda dapat memodifikasi parameter satu per satu atau secara batch:
- Modifikasi satu parameter
  1. Klik ikon di samping parameter yang ingin Anda modifikasi.
  2. Masukkan nilai baru dan klik OK.
  3. Klik Apply Parameters.
  4. Pada kotak dialog, pilih kapan nilai baru diterapkan: Take Effect Immediately, Take Effect Within the Maintenance Window (02:00-06:00), atau Take Effect at Specified Time. Lalu, klik OK.
- Modifikasi parameter secara batch
  1. Klik Export Parameters untuk mengunduh file parameter ke komputer Anda.
  2. Buka file parameter dan modifikasi nilai parameternya.
  3. Klik Import Parameters.
  4. Pada kotak dialog Import Parameters, tempel parameter beserta nilai barunya, lalu klik OK.
  5. Konfirmasi modifikasi pada daftar parameter dan klik Apply Parameters.
  6. Pada kotak dialog, pilih kapan nilai baru diterapkan: Take Effect Immediately, Take Effect Within the Maintenance Window (02:00-06:00), atau Take Effect at Specified Time, lalu klik OK.
Catatan
Pada tab Scheduled Tasks, Anda dapat melihat tugas modifikasi parameter yang dijadwalkan untuk Take Effect Within the Maintenance Window (02:00-06:00) or Take Effect at Specified Time.

Riwayat modifikasi parameter kueri

Masuk ke Konsol ApsaraDB RDS dan buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada. Lalu, temukan instans RDS tersebut dan klik ID instansnya.
Di panel navigasi kiri, klik Parameters.
Klik tab Edit History.
Pilih rentang waktu dan klik OK.

Ekspresi parameter

Anda dapat menggunakan ekspresi untuk mengatur parameter. Saat Anda mengatur parameter yang terkait dengan tipe instans dalam bentuk ekspresi, nilai parameter tersebut akan menyesuaikan secara otomatis ketika Anda mengubah tipe instans. Hal ini memastikan bahwa nilai parameter tetap optimal untuk tipe instans yang baru.

Tabel berikut menjelaskan sintaks ekspresi yang didukung.

Kategori	Catatan penggunaan	Contoh
Parameter	Parameter berikut mendukung ekspresi: Parameter yang mendukung ekspresi work_mem: menentukan jumlah memori yang digunakan oleh operasi pengurutan internal dan tabel hash sebelum data ditulis ke file temporary. maintenance_work_mem: mengatur jumlah maksimum memori yang dapat digunakan untuk operasi maintenance, seperti VACUUM dan CREATE INDEX. autovacuum_work_mem: menentukan jumlah maksimum memori yang dapat digunakan oleh setiap proses autovacuum worker. max_parallel_workers: mengatur jumlah maksimum worker yang didukung sistem untuk operasi paralel. max_parallel_workers_per_gather: mengatur jumlah maksimum worker yang dapat dijalankan oleh satu node Gather atau Gather Merge. effective_cache_size: mengatur nilai awal pengoptimal untuk ukuran total cache data. autovacuum_max_workers: menentukan jumlah maksimum proses autovacuum yang dapat berjalan secara bersamaan, kecuali launcher autovacuum. max_wal_size: mengatur ukuran file write-ahead logging (WAL) yang memicu checkpoint. min_wal_size: mengatur ukuran minimum file WAL untuk didaur ulang. Selama penggunaan disk WAL tetap di bawah pengaturan ini, file WAL lama selalu didaur ulang untuk penggunaan di masa depan saat checkpoint, bukan dihapus. temp_file_limit: menentukan ruang disk maksimum yang dapat digunakan oleh suatu proses untuk file temporary, seperti file temporary untuk pengurutan dan hash, atau file penyimpanan untuk cursor yang ditahan. wal_buffers: mengatur ukuran buffer halaman disk dalam memori bersama untuk WAL, yaitu jumlah memori bersama yang digunakan untuk data WAL yang belum ditulis ke disk. max_parallel_maintenance_workers: mengatur jumlah maksimum worker paralel untuk operasi CREATE INDEX. max_worker_processes: mengatur jumlah maksimum proses worker konkuren. Catatan Parameter max_parallel_maintenance_workers hanya didukung untuk RDS PostgreSQL 11.0 dan versi setelahnya.	effective_cache_size
Variabel	AllocatedStorage: kapasitas penyimpanan tipe instans dalam MB. Nilai variabel ini berupa bilangan bulat. DBInstanceClassMemory: ukuran memori tipe instans dalam byte. Nilai variabel ini berupa bilangan bulat. DBInstanceClassCPU: jumlah core CPU tipe instans. Nilai variabel ini berupa bilangan bulat. DBInstanceClassConnections: jumlah koneksi maksimum tipe instans. Nilai variabel ini berupa bilangan bulat. Catatan Untuk informasi lebih lanjut tentang tipe instans serta kapasitas penyimpanan, ukuran memori, jumlah core CPU, dan jumlah koneksi maksimum yang didukung setiap tipe instans, lihat Tipe instans primary RDS for PostgreSQL.	effective_cache_size={DBInstanceClassMemory/16384}
Operator	Sintaks ekspresi: Ekspresi diapit tanda kurung kurawal (`{}`). Operator pembagian (/): membagi dividend dengan divisor dan mengembalikan hasil bagi berupa bilangan bulat. Jika hasil bagi berupa desimal, sistem tidak membulatkannya tetapi memotong bagian desimalnya. Dividend dan divisor dapat berupa angka desimal. Operator perkalian (*): mengalikan dua operand dan mengembalikan hasil kali berupa bilangan bulat. Jika hasil kali berupa desimal, sistem tidak membulatkannya tetapi memotong bagian desimalnya. Kedua operand dapat berupa angka desimal.	effective_cache_size={DBInstanceClassMemory/16384}
Fungsi	Fungsi GREATEST() mengembalikan nilai terbesar dari daftar bilangan bulat atau formula parameter. Fungsi LEAST() mengembalikan nilai terkecil dari daftar bilangan bulat atau formula parameter. Fungsi SUM() menjumlahkan nilai dari bilangan bulat atau formula parameter yang ditentukan.	max_parallel_workers={GREATEST(DBInstanceClassCPU*3/4, 8)}

Referensi

Untuk informasi lebih lanjut tentang parameter PostgreSQL, lihat Server Configuration dalam dokumentasi PostgreSQL.

Untuk memodifikasi parameter dengan memanggil operasi API, lihat API berikut:

API	Deskripsi
ModifyParameter	Memodifikasi parameter instans RDS.
DescribeParameterTemplates	Mengkueri template parameter database.
DescribeParameters	Mengkueri pengaturan parameter saat ini dari suatu instans.

FAQ

Bagaimana cara mengubah jumlah koneksi maksimum untuk instans RDS for PostgreSQL?

Jumlah koneksi maksimum untuk instans RDS for PostgreSQL ditentukan oleh tipe instans dan tidak dapat diubah secara manual. Untuk menambahkannya, lakukan upgrade ke tipe instans yang lebih besar. Jumlah koneksi maksimum dapat berbeda antara instans primary dan instans read-only. Untuk informasi lebih lanjut, lihat Tipe instans primary dan Tipe instans read-only.

Mengapa terjadi error saat saya memodifikasi parameter max_slot_wal_keep_size?

Masalah ini biasanya terjadi pada instans RDS for PostgreSQL yang menggunakan mesin DuckDB. Berikut penyebab dan rekomendasinya:

Parameter max_slot_wal_keep_size merupakan batasan mesin DuckDB dan tidak dapat dimodifikasi.
Jika Anda ingin menyesuaikan parameter ini untuk mengontrol pertumbuhan log WAL, kami merekomendasikan agar Anda membeli instans RDS for PostgreSQL baru yang tidak menggunakan mesin DuckDB. Anda kemudian dapat memodifikasi parameter ini pada instans baru tersebut.