Ubah pengaturan parameter untuk database RDS for MySQL - ApsaraDB RDS

Ubah pengaturan parameter dan lihat riwayat modifikasi untuk instans RDS for MySQL melalui konsol atau API. Lihat parameter instans.

Catatan penggunaan

Untuk memastikan stabilitas instans, hanya parameter yang tersedia di konsol yang dapat diubah. Perintah set global tidak didukung.
Saat mengubah parameter, periksa kolom Value Range pada halaman Editable Parameters. Anda juga dapat menggunakan ekspresi untuk menyesuaikan parameter secara otomatis terhadap perubahan konfigurasi instans.
Beberapa parameter yang diubah pada instans utama akan disinkronkan secara otomatis ke instans read-only. Lampiran: Parameter yang disinkronkan.
Catatan mengenai parameter lower_case_table_names:
- MySQL 5.7, 8.0, dan 8.4: Sensitivitas huruf besar/kecil nama tabel harus ditentukan saat Anda membuat instans (nilai default: 1, tidak sensitif huruf besar/kecil). Parameter ini tidak dapat diubah setelah instans dibuat, dan nilainya tetap tidak berubah setelah upgrade.
- MySQL 5.6:
  - Parameter ini dapat diubah setelah instans dibuat, tetapi instans akan direstart. Kami menyarankan agar Anda mengubah parameter ini selama jam sepi.
  - Jika Anda ingin mengubah nilai dari 0 menjadi 1, Anda harus mengonversi nama tabel huruf besar di instans menjadi huruf kecil terlebih dahulu. Jika tidak, tabel dengan nama huruf besar yang sudah ada akan menjadi tidak dapat diakses.
  - Instans read-only tidak mendukung pengubahan parameter ini. Anda harus mengubahnya pada instans utama, dan perubahan tersebut akan disinkronkan ke instans read-only.

Penting

Modifikasi parameter mungkin memerlukan restart atau rekoneksi instans. Lakukan operasi ini selama jam sepi dan pastikan aplikasi Anda memiliki mekanisme rekoneksi otomatis:

Beberapa parameter memerlukan restart instans agar berlaku. Periksa kolom Force Restart pada halaman Editable Parameters. Restart menyebabkan gangguan koneksi selama sekitar 15 detik. Pastikan aplikasi Anda memiliki mekanisme rekoneksi otomatis.
Parameter yang tidak memerlukan restart hanya berlaku untuk koneksi baru. Koneksi yang sudah ada harus direkoneksi ulang.

Ubah parameter instans

Parameter yang dapat diubah bervariasi tergantung versi mesin MySQL. Daftar parameter yang dapat diubah untuk RDS for MySQL.

Ubah parameter dari satu instans

Buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada. Lalu, temukan instans RDS tersebut dan klik ID instansnya.
Di bilah navigasi kiri, klik Parameters.

Anda dapat melakukan operasi berikut:

Ubah satu parameter

Pada tab Editable Parameters, temukan parameter yang ingin Anda ubah dan sesuaikan nilainya berdasarkan skenario:
- Klik pada kolom Running Parameter Value, lalu masukkan nilai parameter berdasarkan rentang nilai yang disarankan.
- Pada kolom Running Parameter Value, pilih nilai parameter dari daftar drop-down.
Klik OK.
Klik Apply Changes. Pada kotak dialog yang muncul, pilih periode waktu penerapan. Anda dapat memilih Take Effect Immediately, Take Effect Within the Maintenance Window, atau Take Effect at Specified Time.

Catatan
Pada tab Scheduled Tasks for Parameter Modification, Anda dapat melihat tugas modifikasi parameter yang Anda pilih Take Effect Within the Maintenance Window atau Take Effect at Specified Time.
(Opsional) Untuk membatalkan modifikasi parameter sebelum dikirim, klik Cancel Changes.

Terapkan dan ekspor templat

Terapkan templat parameter

RDS menyediakan templat parameter sistem untuk skenario seperti performa tinggi. Anda juga dapat membuat templat kustom untuk menerapkan pengaturan secara batch. Gunakan templat parameter.

Klik Apply Template.
Pilih templat parameter yang akan diterapkan, lalu klik OK.
Catatan
- Kotak dialog menampilkan jumlah parameter dan apakah restart diperlukan. Untuk melihat perubahan detail, klik View Parameter Change.
- Jika templat parameter tidak tercantum, kemungkinan berada di wilayah berbeda. Salin templat tersebut ke wilayah instans. Gunakan templat parameter.

Ekspor templat parameter

Klik Export as Template.

Konfigurasikan parameter berikut.

Parameter	Deskripsi
Template Name	Nama templat. Panjang 8 hingga 64 karakter; boleh berisi huruf, angka, titik (.), dan garis bawah (_). Harus dimulai dengan huruf. Tidak boleh mengandung karakter Tionghoa.
Description	Deskripsi templat. Maksimal 200 karakter.

Klik OK untuk membuat templat parameter baru di wilayah tersebut.

Impor dan ekspor parameter

Untuk mengubah banyak parameter sekaligus atau menyimpan pengaturan saat ini, ekspor file TXT berisi semua nilai parameter, edit secara lokal, lalu impor untuk menerapkan perubahan.

Klik Export Parameters untuk mengekspor file parameter dalam format TXT.
Setelah mengedit file, klik Import Parameters dan tempel konten file ke dalam kotak dialog.
Klik OK.
Klik Apply Changes. Pada kotak dialog yang muncul, pilih kapan perubahan diterapkan. Anda dapat memilih Take Effect Immediately, Take Effect Within the Maintenance Window, atau Take Effect at Specified Time.

Catatan
Pada tab Scheduled Tasks for Parameter Modification, Anda dapat melihat tugas modifikasi parameter yang Anda pilih Take Effect Within the Maintenance Window atau Take Effect at Specified Time.
(Opsional) Untuk membatalkan modifikasi parameter sebelum dikirim, klik Cancel Changes.

Penting
Jika muncul pesan error Operation failed. The specified parameter format is invalid., periksa apakah nilai parameter yang Anda masukkan berada dalam rentang Valid Values.

Ubah parameter untuk beberapa instans

Masuk ke ApsaraDB RDS console. Di panel navigasi kiri, klik Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada.
Pilih kotak centang di sebelah kiri beberapa instans target, lalu klik Apply Changes di bagian bawah halaman.

Catatan
Instans dalam perubahan parameter batch harus memiliki versi dan seri yang sama. Jika tidak, tombol Modify Parameters akan dinonaktifkan dan tidak dapat diklik.
Pada halaman Parameters yang muncul, klik ikon di paling kanan nama parameter yang ingin diubah.
Pada kotak value, pilih atau masukkan nilai baru, lalu klik OK.
Pada jendela Parameters yang muncul, verifikasi bahwa perubahan sudah benar, lalu klik OK.

Lihat riwayat modifikasi

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

FAQ

Apakah modifikasi parameter langsung berlaku? Apakah diperlukan restart instans?

Beberapa perubahan berlaku dalam waktu sekitar 5 menit tanpa restart. Yang lain memerlukan restart. Periksa halaman Editable Parameters dan kolom Force Restart untuk memastikan sebelum mengirimkan.

Mengapa modifikasi parameter saya tidak diterapkan?

Modifikasi parameter hanya diterapkan setelah Anda mengklik Apply Changes.

Jika instans read-only merupakan Edisi Ketersediaan Tinggi dan memiliki instans utama serta instans secondary, bagaimana cara mengatur parameter untuk keduanya?

Atur parameter hanya pada instans utama dari pasangan read-only. Parameter tersebut kemudian akan disinkronkan secara otomatis ke instans secondary.

Saya ingin mengubah parameter expire_logs_days atau binlog_expire_logs_seconds, tetapi tidak dapat menemukannya di konsol RDS. Apa yang harus saya lakukan?

Parameter expire_logs_days dan binlog_expire_logs_seconds digunakan di MySQL open-source untuk mengontrol periode retensi log biner lokal. Namun, RDS for MySQL tidak menggunakan parameter ini untuk tujuan tersebut. Untuk mengubah periode retensi log biner pada instans RDS for MySQL, Anda dapat mengatur kebijakan retensi log biner di konsol RDS.

Catatan

Untuk menghapus atau mengurangi cadangan log dan data pada instans RDS for MySQL, Hapus atau kurangi cadangan.

Bagaimana cara mengubah parameter lower_case_table_names?

Untuk informasi lebih lanjut, lihat Catatan mengenai parameter lower_case_table_names.

Saat saya menggunakan perintah set global untuk mengubah parameter, saya mendapatkan error: Access denied; you need (at least one of) the SUPER or SYSTEM_VARIABLES_ADMIN privilege(s) for this operation. Apa yang harus saya lakukan?

RDS for MySQL tidak mendukung perintah set global. Hanya parameter yang tersedia di konsol yang dapat diubah.

Bagaimana cara mengubah parameter collation_connection dan collation_database?

Anda tidak dapat mengubah langsung collation_connection atau collation_database. Sebagai gantinya, atur parameter init_connect di konsol RDS. Nilai yang didukung mencakup 'set names utf8mb4', 'set names utf8', 'set default_collation_for_utf8mb4=utf8mb4_general_ci', 'set default_collation_for_utf8mb4=utf8mb4_general_ci;set names utf8mb4', 'set names utf8mb4 collate utf8mb4_general_ci', dan 'set names utf8mb4 COLLATE utf8mb4_bin'.

Sistem menjalankan perintah ini pada setiap koneksi baru, mengatur set karakter dan aturan pengurutan. Pastikan aplikasi Anda tidak mengganti aturan pengurutan tingkat sesi, karena pengaturan tingkat sesi akan mengambil prioritas.

Dapatkah saya mengubah parameter sql_log_bin?

Tidak. RDS for MySQL menerapkan sql_log_bin untuk semua sesi guna memastikan log biner dipertahankan, menjaga konsistensi data untuk replikasi.

Mengapa modifikasi parameter wait_timeout tidak berlaku?

Modifikasi parameter wait_timeout hanya berlaku untuk koneksi baru. Koneksi yang sudah ada harus diputus dan disambungkan ulang agar nilai baru berlaku.

Mengapa nilai wait_timeout yang dikembalikan oleh klien berbeda dengan nilai yang diatur di konsol?

Secara default, SHOW VARIABLES mengembalikan nilai parameter tingkat SESI, yang mungkin berbeda dari nilai tingkat GLOBAL. Pada koneksi interaktif (seperti klien command-line mysql), nilai tingkat sesi wait_timeout diganti oleh nilai inisialisasi interactive_timeout. Misalnya, jika Anda mengatur wait_timeout menjadi 86400 dan interactive_timeout tetap pada nilai default 7200 di konsol, SHOW VARIABLES LIKE 'wait_timeout' pada koneksi interaktif akan mengembalikan 7200, bukan 86400. Jalankan SHOW GLOBAL VARIABLES LIKE 'wait_timeout' untuk memeriksa nilai parameter global dan memastikan pengaturan telah berlaku.

Pada instans RDS, mengapa parameter performance_schema diaktifkan, tetapi tidak ada catatan yang ditemukan saat saya melakukan kueri ke tabel performance_schema.session_connect_attrs?

Atur parameter loose_performance_schema_session_connect_attrs_size ke nilai lebih besar dari 0 di konsol RDS.

Apa yang harus saya lakukan jika menerima error InvalidParameters.Prohibited saat mengatur parameter performance_schema menjadi ON?

Parameter performance_schema hanya menerima nilai 0 dan 1. Nilai seperti ON atau OFF tidak didukung. Atur parameter menjadi 1 untuk mengaktifkannya, atau 0 untuk menonaktifkannya. Jika Anda menerima error InvalidParameters.Prohibited setelah mengatur parameter menjadi ON, ubah nilainya menjadi 1 dan kirimkan perubahan lagi.

Bagaimana cara mengaktifkan parameter show_ipk_info untuk melihat informasi kunci primer implisit?

Beberapa parameter tidak dapat diubah di konsol dan hanya berlaku pada tingkat sesi. show_ipk_info adalah salah satu parameter tersebut. Parameter ini tidak tercantum pada tab Editable Parameters di konsol, dan tidak mendukung pengaturan pada tingkat global. Untuk melihat kunci primer implisit yang dibuat otomatis oleh RDS untuk suatu tabel, jalankan pernyataan berikut dalam sesi database:

SET show_ipk_info=on;

Setelah menjalankan pernyataan ini, Anda dapat menggunakan SHOW CREATE TABLE atau melakukan kueri ke tabel information_schema.columns untuk melihat kolom kunci primer implisit (__#alibaba_rds_row_id#__) yang dibuat otomatis oleh RDS. Pengaturan ini hanya berlaku untuk sesi saat ini. Anda harus menjalankan pernyataan tersebut lagi di setiap sesi baru.

Lampiran: Parameter yang disinkronkan

Parameter berikut secara otomatis disinkronkan dari instans utama ke semua instans read-only saat diubah.

lower_case_table_names

Catatan
Untuk RDS for MySQL 5.7, 8.0, dan 8.4, sensitivitas huruf besar/kecil nama tabel hanya dapat ditentukan saat Anda membuat instans, dan parameter lower_case_table_names tidak dapat diubah setelahnya. Hanya MySQL 5.6 yang mendukung pengubahan parameter ini pada instans utama, dengan perubahan disinkronkan ke instans read-only.
innodb_large_prefix
loose_validate_password_length
default_time_zone
rpl_semi_sync_slave_enabled
character_set_server
collation_server

Referensi API

API	Deskripsi
ModifyParameter	Memodifikasi parameter instans RDS.
DescribeParameterTemplates	Menanyakan templat parameter database.
DescribeParameters	Menanyakan konfigurasi parameter instans.