Modifikasi parameter instans ApsaraDB RDS for PostgreSQL - ApsaraDB RDS

Modifikasi parameter instans ApsaraDB RDS for PostgreSQL di Konsol atau melalui pemanggilan operasi API untuk mengoptimalkan kinerja. Anda juga dapat melihat riwayat modifikasi parameter.

Catatan penggunaan

Memodifikasi parameter tertentu memerlukan restart instans setelah Anda mengklik Apply Changes. Periksa kolom Force Restart pada tab Editable Parameters di Konsol. Restart akan mengganggu layanan—rencanakan sesuai kebutuhan.
Saat memodifikasi parameter, periksa kolom Valid Values pada tab Editable Parameters.
Perubahan parameter berikut pada instans primary secara otomatis disinkronkan ke instans hanya baca:

wal_level, max_replication_slots, max_wal_senders, max_locks_per_transaction, max_worker_processes, max_prepared_transactions
Setelah Anda mengirimkan perubahan, sistem akan memvalidasinya. Jika nilai tidak valid atau mencegah startup, perubahan akan dikembalikan dengan status Failed. Periksa kolom Status pada tab Edit History.
Parameter log_statement tidak dapat dimodifikasi secara langsung. Sebagai gantinya, aktifkan atau nonaktifkan SQL Explorer dan 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 Editable Parameters, temukan parameter yang ingin dimodifikasi. Modifikasi parameter satu per satu atau secara batch:
- Modifikasi satu parameter
  1. Klik ikon di samping parameter yang dituju.
  2. Masukkan nilai baru dan klik OK.
  3. Klik Apply Changes.
  4. Pilih waktu penerapan perubahan: Take Effect Immediately, Take Effect Within the Maintenance Window, atau Take Effect at Specified Time Range. Lalu, klik OK.
- Modifikasi parameter secara batch
  1. Klik Export Parameters untuk mengunduh file parameter.
  2. Buka file tersebut dan modifikasi nilai parameternya.
  3. Klik Import Parameters.
  4. Pada kotak dialog Import Parameters, tempel parameter dan nilai yang telah dimodifikasi, lalu klik OK.
  5. Verifikasi perubahan dan klik Apply Changes.
  6. Pilih waktu penerapan perubahan: Take Effect Immediately, Take Effect Within the Maintenance Window, atau Take Effect at Specified Time Range. Lalu, klik OK.
Catatan
Pada tab Scheduled Tasks for Parameter Modification, lihat jadwal modifikasi parameter untuk opsi Take Effect Within the Maintenance Window atau Take Effect at Specified Time Range.

Lihat riwayat modifikasi

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

Gunakan ekspresi untuk parameter yang bergantung pada spesifikasi instans. Saat Anda mengubah tipe instans, parameter berbasis ekspresi akan menyesuaikan secara otomatis.

Tabel berikut mencantumkan sintaksis ekspresi.

Kategori	Deskripsi	Contoh
Parameter	Parameter berikut mendukung ekspresi: Parameter yang mendukung ekspresi work_mem: memori untuk operasi sorting internal dan tabel hash sebelum ditulis ke file temporary. maintenance_work_mem: memori maksimum untuk operasi maintenance seperti VACUUM dan CREATE INDEX. autovacuum_work_mem: memori maksimum per proses autovacuum worker. max_parallel_workers: jumlah maksimum worker untuk operasi paralel. max_parallel_workers_per_gather: jumlah maksimum worker per node Gather atau Gather Merge. effective_cache_size: perkiraan total ukuran cache disk untuk query planner. autovacuum_max_workers: jumlah maksimum proses autovacuum konkuren (tidak termasuk launcher). max_wal_size: ukuran WAL yang memicu checkpoint. min_wal_size: ukuran WAL minimum. Di bawah ambang batas ini, file WAL lama didaur ulang saat checkpoint alih-alih dihapus. temp_file_limit: disk space maksimum per proses untuk file temporary (sorting, hashing, cursor). wal_buffers: memori bersama untuk data WAL yang belum ditulis ke disk. max_parallel_maintenance_workers: jumlah maksimum worker paralel untuk CREATE INDEX. max_worker_processes: jumlah maksimum proses worker konkuren. Catatan Parameter max_parallel_maintenance_workers hanya tersedia di ApsaraDB RDS for PostgreSQL 11.0 dan versi lebih baru.	effective_cache_size
Variabel	AllocatedStorage: kapasitas penyimpanan dalam MB. Bilangan bulat. DBInstanceClassMemory: ukuran memori dalam byte. Bilangan bulat. DBInstanceClassCPU: jumlah core CPU. Bilangan bulat. DBInstanceClassConnections: jumlah koneksi maksimum. Bilangan bulat. Catatan Untuk spesifikasi seperti penyimpanan, memori, core CPU, dan batas koneksi, lihat Tipe instans primary ApsaraDB RDS for PostgreSQL.	effective_cache_size={DBInstanceClassMemory/16384}
Operator	Sintaksis ekspresi: Ekspresi harus diapit tanda kurung kurawal (`{}`). Operator pembagian (/): menghasilkan hasil bagi bilangan bulat. Hasil pecahan dipotong, bukan dibulatkan. Operator perkalian (*): menghasilkan hasil kali bilangan bulat. Hasil pecahan dipotong, bukan dibulatkan.	effective_cache_size={DBInstanceClassMemory/16384}
Fungsi	GREATEST(): mengembalikan nilai terbesar dari daftar bilangan bulat atau ekspresi. LEAST(): mengembalikan nilai terkecil dari daftar bilangan bulat atau ekspresi. SUM(): menjumlahkan nilai dari bilangan bulat atau ekspresi yang ditentukan.	max_parallel_workers={GREATEST(DBInstanceClassCPU*3/4, 8)}

Referensi

Untuk detail parameter PostgreSQL, lihat Server Configuration dalam dokumentasi PostgreSQL.

Untuk memodifikasi parameter dengan memanggil operasi API:

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

FAQ

Q: Bagaimana cara meningkatkan jumlah koneksi maksimum untuk instans ApsaraDB RDS for PostgreSQL?

A: Jumlah koneksi maksimum (max_connections) bergantung pada tipe instans dan tidak dapat dimodifikasi secara langsung. Untuk meningkatkan koneksi, upgrade tipe instans. Untuk batas koneksi berdasarkan tipe instans, lihat Tipe instans primary ApsaraDB RDS for PostgreSQL dan Tipe instans hanya baca ApsaraDB RDS for PostgreSQL.