Menggunakan template parameter - ApsaraDB RDS

Topik ini menjelaskan cara menggunakan template parameter untuk mengonfigurasi parameter beberapa instance ApsaraDB RDS for PostgreSQL secara bersamaan. ApsaraDB RDS for PostgreSQL menyediakan template parameter sistem dan kustom.

Prasyarat

Instance RDS harus memenuhi persyaratan berikut:

Instance RDS menggunakan SSD standar atau SSD yang ditingkatkan (ESSD).
Instance RDS menjalankan PostgreSQL 10 atau versi lebih baru.

Informasi latar belakang

ApsaraDB RDS for PostgreSQL mendukung jenis-jenis template parameter berikut:

Template Parameter Sistem: Template parameter default yang digunakan saat membuat instance RDS.
Template Parameter Kustom: Template parameter yang dikonfigurasikan sesuai kebutuhan bisnis setelah pembuatan instance RDS. Anda dapat menerapkan template parameter kustom ke satu atau lebih instance RDS untuk menimpa pengaturan parameter dari template parameter sistem.

Catatan

Untuk informasi lebih lanjut tentang konfigurasi parameter tunggal, lihat Modifikasi Parameter Instance.

Buat template parameter kustom

Buat template secara manual

Masuk ke Konsol ApsaraDB RDS. Di panel navigasi sisi kiri, klik Parameter Templates. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada.
Di halaman yang muncul, klik Create Parameter Template.

Konfigurasikan parameter berikut.

Parameter	Deskripsi
Template Name	Masukkan nama template. Nama harus terdiri dari 8 hingga 64 karakter dan dapat berisi huruf, angka, titik (.), dan garis bawah (_). Nama harus dimulai dengan huruf.
Database Engine	Pilih PostgreSQL.
Engine Version	Pilih versi mesin database yang dijalankan oleh instance RDS. Instance RDS menjalankan PostgreSQL 10 atau versi lebih baru.
Description	Masukkan deskripsi untuk template parameter. Deskripsi dapat memiliki panjang hingga 200 karakter.
Add Parameter	Klik Add Parameter dan pilih parameter dari daftar drop-down Parameter. Kemudian, Anda dapat mengonfigurasi parameter tersebut. Anda juga dapat melihat nilai valid dan nilai default parameter tersebut. Catatan Untuk informasi lebih lanjut tentang parameter yang tersedia, lihat parameter pada tab Modifiable Parameters halaman Parameters. Jika Anda ingin menambahkan parameter lainnya, Anda harus mengklik Add Parameter lagi. Untuk menghapus parameter, Anda dapat mengklik Delete di sebelah kanan parameter.
Import	Setelah Anda mengekspor template parameter ke komputer Anda, Anda dapat mengedit template parameter berdasarkan kebutuhan bisnis Anda. Kemudian, Anda dapat mengklik Import untuk menyalin pengaturan parameter dari template parameter. Untuk informasi lebih lanjut tentang cara mengekspor template parameter, lihat Modifikasi parameter instance ApsaraDB RDS for MySQL.

Klik OK.

Ekspor pengaturan parameter yang ada sebagai template parameter

Buka halaman Instance. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada. Temukan instance RDS dan klik ID instance tersebut.
Di panel navigasi sisi kiri, klik Parameters.
Pada tab Modifiable Parameters, klik Export as Template.

Di kotak dialog yang muncul, konfigurasikan parameter Template Name dan Description.

Parameter	Deskripsi
Template Name	Masukkan nama template. Nama harus terdiri dari 8 hingga 64 karakter dan dapat berisi huruf, angka, titik (.), dan garis bawah (_). Nama harus dimulai dengan huruf.
Description	Masukkan deskripsi untuk template parameter. Deskripsi dapat memiliki panjang hingga 200 karakter.

Klik OK.
Untuk melihat template parameter yang diekspor, masuk ke Konsol ApsaraDB RDS. Di panel navigasi sisi kiri, klik Parameter Templates. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada.

Terapkan template parameter

Terapkan template parameter selama pembuatan instance

Jika Anda memilih tipe penyimpanan SSD yang ditingkatkan (ESSD) saat membuat instance RDS, Anda dapat menentukan template parameter untuk instance tersebut. Untuk informasi lebih lanjut tentang pembuatan instance RDS, lihat Buat Instance ApsaraDB RDS for PostgreSQL.

Template Parameter Sistem: ApsaraDB RDS for PostgreSQL menyediakan template parameter sistem secara default. Template parameter sistem dinamai dalam format berikut: PostgreSQL_Versi utama engine_RDS edition_Template parameter default. Contoh: PostgreSQL_14.0_Edisi High-availability_Template parameter default. Untuk detail pengaturan parameter dalam template parameter sistem, lihat Lihat Template Parameter.
Template Parameter Kustom: Anda dapat memilih template parameter kustom yang dibuat sebelum membuat instance RDS. Jika belum membuat template parameter kustom, Anda dapat mengklik tautan create a custom parameter template di bawah daftar drop-down Parameter Template untuk membuatnya, lalu memilih template yang telah dibuat untuk instance RDS. Untuk informasi lebih lanjut tentang pembuatan template parameter kustom, lihat Buat Template Parameter Kustom.

Catatan

Template parameter sistem tidak dapat dimodifikasi.

Terapkan template parameter ke beberapa instance RDS

Peringatan

Sebelum menerapkan template parameter ke beberapa instance RDS, pastikan pengaturan parameter sesuai untuk semua instance RDS.
Modifikasi beberapa parameter akan memicu restart instance RDS. Setelah modifikasi, instance RDS akan segera restart. Untuk memeriksa apakah modifikasi parameter memicu restart, masuk ke Konsol ApsaraDB RDS, buka tab Parameter Dapat Dimodifikasi, dan lihat nilai di kolom Force Restart untuk parameter tersebut. Jika nilainya adalah Ya, modifikasi parameter memicu restart. Jika nilainya adalah Tidak, modifikasi parameter tidak memicu restart. Jika instance RDS direstart, aplikasi Anda akan terputus dari instance RDS. Pastikan aplikasi Anda dikonfigurasikan untuk menyambung kembali ke instance RDS. Untuk meminimalkan dampak, kami sarankan Anda mengatur bisnis Anda sebelum merestart instance RDS. Lanjutkan dengan hati-hati.

Masuk ke Konsol ApsaraDB RDS. Di panel navigasi sisi kiri, klik Parameter Templates. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada.
Pada tab Custom Parameter Templates atau System Parameter Templates, temukan template parameter yang ingin diterapkan dan klik Apply to Instances di kolom Actions.
Catatan
Jika beberapa template parameter diterapkan ke instance RDS secara berurutan, template parameter terbaru yang diterapkan akan menimpa pengaturan parameter dari template sebelumnya.
Di bagian Instance Tersedia panel yang muncul, pilih instance RDS tempat Anda ingin menerapkan template parameter, klik ikon untuk memindahkan instance RDS yang dipilih ke bagian Instance Dipilih, lalu lihat perubahan pengaturan parameter di bagian Parameter Comparison.
Klik OK.

Terapkan template parameter ke instance RDS

Peringatan

Modifikasi beberapa parameter akan memicu restart instance RDS. Setelah modifikasi, instance RDS akan segera restart. Untuk memeriksa apakah modifikasi parameter memicu restart, masuk ke Konsol ApsaraDB RDS, buka tab Parameter Dapat Dimodifikasi, buka kotak dialog Apply Template, dan lihat nilai parameter Force Restart. Jika nilainya adalah Ya, modifikasi parameter memicu restart. Jika nilainya adalah Tidak, modifikasi parameter tidak memicu restart. Jika instance RDS direstart, aplikasi Anda akan terputus dari instance RDS. Pastikan aplikasi Anda dikonfigurasikan untuk menyambung kembali ke instance RDS. Untuk meminimalkan dampak, kami sarankan Anda mengatur bisnis Anda sebelum merestart instance RDS. Lanjutkan dengan hati-hati.

Buka halaman Instance. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada. Temukan instance RDS dan klik ID instance tersebut.
Di panel navigasi sisi kiri, klik Parameters.
Pada tab Modifiable Parameters, klik Apply Template.
Di kotak dialog yang muncul, konfigurasikan parameter Template Name.
Catatan
Anda dapat masuk ke Konsol ApsaraDB RDS. Di panel navigasi sisi kiri, klik Parameter Templates. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada untuk melihat template yang telah dibuat.
Klik OK.

Kelola template parameter

Kloning template parameter kustom

Jika Anda ingin mengkloning template parameter kustom dari wilayah saat ini ke wilayah lain atau jika Anda ingin memodifikasi pengaturan parameter dari template parameter kustom, Anda dapat menggunakan fitur pengkloningan template parameter.

Catatan

Template parameter sistem tidak dapat dikloning.

Masuk ke Konsol ApsaraDB RDS. Di panel navigasi sisi kiri, klik Parameter Templates. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada.
Pada tab Template Parameter Kustom halaman yang muncul, temukan template parameter yang ingin dikloning, klik ikon di kolom Actions, lalu pilih Clone.

Konfigurasikan parameter berikut.

Parameter	Deskripsi
Region and Zone	Tentukan wilayah tujuan ke mana Anda ingin mengkloning template parameter.
Template Name	Masukkan nama template. Nama harus terdiri dari 8 hingga 64 karakter dan dapat berisi huruf, angka, titik (.), dan garis bawah (_). Nama harus dimulai dengan huruf.
Description	Masukkan deskripsi untuk template parameter. Deskripsi dapat memiliki panjang hingga 200 karakter.

Klik OK.

Lihat template parameter

Masuk ke Konsol ApsaraDB RDS. Di panel navigasi sisi kiri, klik Parameter Templates. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada.
Pada tab Custom Parameter Templates atau System Parameter Templates, klik ID template parameter yang ingin digunakan untuk melihat pengaturan parameter dalam template parameter.

Modifikasi template parameter

Anda dapat memodifikasi template parameter kustom.

Peringatan

Setelah memodifikasi template parameter kustom, Anda harus menerapkan ulang template agar modifikasi berlaku. Jika modifikasi hanya berlaku setelah instance RDS direstart, Anda harus merestart instance RDS setelah template parameter kustom dimodifikasi. Restart instance menyebabkan aplikasi Anda terputus dari instance RDS. Pastikan aplikasi Anda dikonfigurasikan untuk menyambung kembali ke instance RDS. Untuk meminimalkan dampak, kami sarankan Anda mengatur bisnis Anda sebelum merestart instance RDS. Lanjutkan dengan hati-hati.

Masuk ke Konsol ApsaraDB RDS. Di panel navigasi sisi kiri, klik Parameter Templates. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada.
Pada tab Template Parameter Kustom halaman yang muncul, temukan template parameter yang ingin dimodifikasi, klik ikon di kolom Actions, lalu pilih Modify.
Klik OK.

Hapus template parameter

Anda dapat menghapus template parameter kustom.

Masuk ke Konsol ApsaraDB RDS. Di panel navigasi sisi kiri, klik Parameter Templates. Di bilah navigasi atas, pilih wilayah tempat instance RDS berada.
Pada tab Template Parameter Kustom halaman yang muncul, temukan template parameter yang ingin dihapus, klik ikon di kolom Actions, lalu pilih Delete.
Di pesan yang muncul, klik OK.
Catatan
Jika template parameter yang ingin dihapus diterapkan ke satu atau lebih instance RDS, template tidak dapat dihapus langsung.
Contohnya, jika Template Parameter Kustom 1 diterapkan ke Instance A dan Instance B, Template Parameter Kustom 1 tidak dapat dihapus langsung. Anda hanya dapat menghapus Template Parameter Kustom 1 setelah menerapkan template parameter lain ke Instance A dan Instance B.

Operasi terkait

Operasi	Deskripsi
CreateParameterGroup	Membuat template parameter.
ModifyParameterGroup	Memodifikasi template parameter.
CloneParameterGroup	Mengkloning template parameter dari satu wilayah ke wilayah lain.
DescribeParameterGroups	Mengquery template parameter yang tersedia di suatu wilayah.
DescribeParameterGroup	Mengquery detail tentang template parameter.
DeleteParameterGroup	Menghapus template parameter.

FAQ

Bagaimana cara mengatur ulang nilai parameter dalam template parameter kustom ke nilai defaultnya?

Temukan parameter yang ingin dimodifikasi dalam template parameter kustom dan ubah nilai yang ditentukan menjadi nilai default. Untuk informasi lebih lanjut, lihat Memodifikasi Template Parameter.
Terapkan ulang template parameter kustom ke instance RDS Anda. Untuk informasi lebih lanjut, lihat Menerapkan Template Parameter.