All Products
Search

This Product

    ApsaraDB RDS:Modify instance parameters

    Document Center

    ApsaraDB RDS:Modify instance parameters

    Last Updated:Jul 16, 2026

    Modifikasi pengaturan parameter dan lihat riwayat modifikasi untuk instans RDS for MySQL melalui konsol atau API. View instance parameters.

    Catatan penggunaan

    • Untuk memastikan stabilitas instans, hanya parameter yang tersedia di konsol yang dapat dimodifikasi. Perintah set global tidak didukung.

    • Saat memodifikasi parameter, periksa kolom Value Range pada halaman Editable Parameters. Anda juga dapat menggunakan expressions untuk secara otomatis menyesuaikan parameter terhadap perubahan konfigurasi instans.

    • Beberapa parameter yang dimodifikasi pada instans primary secara otomatis disinkronkan ke instans read-only. Appendix: Synchronized parameters.

    • 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 dimodifikasi setelah instans dibuat, dan nilainya tetap tidak berubah setelah upgrade.

      • MySQL 5.6:

        • Parameter ini dapat dimodifikasi setelah instans dibuat, tetapi instans akan direstart. Kami menyarankan Anda memodifikasi 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 modifikasi parameter ini. Anda harus memodifikasinya pada instans primary, dan perubahan tersebut akan disinkronkan ke instans read-only.

    Penting

    Modifikasi parameter mungkin memerlukan restart atau reconnect instans. Lakukan operasi ini selama jam sepi dan pastikan aplikasi Anda memiliki mekanisme reconnect 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 reconnect otomatis.

    • Parameter yang tidak memerlukan restart hanya berlaku untuk koneksi baru. Koneksi yang sudah ada harus direconnect.

    Modify instance parameters

    Parameter yang dapat dimodifikasi bervariasi tergantung versi engine MySQL. List of modifiable parameters for RDS for MySQL.

    Modify the parameters of a single instance

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

    2. Di bilah navigasi kiri, klik Parameters.

    3. Anda dapat melakukan operasi berikut:

      Modify single parameter

      1. Pada tab Editable Parameters, temukan parameter yang ingin Anda modifikasi dan ubah nilainya sesuai skenario:

        • Klik pencil 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.

      2. Klik OK.

      3. 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 opsi Take Effect Within the Maintenance Window atau Take Effect at Specified Time.

      4. (Opsional) Untuk membatalkan modifikasi parameter sebelum dikirim, klik Cancel Changes.

      Apply and export templates

      Apply a parameter template

      RDS menyediakan templat parameter sistem untuk skenario seperti high performance. Anda juga dapat membuat templat kustom untuk menerapkan pengaturan secara batch. Use a parameter template.

      1. Klik Apply Template.

      2. 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 terdaftar, kemungkinan berada di wilayah berbeda. Salin templat tersebut ke wilayah instans. Use a parameter template.

      Export a parameter template

      1. Klik Export as Template.

      2. Konfigurasikan parameter berikut.

        Parameter

        Description

        Template Name

        Nama templat. Panjang 8 hingga 64 karakter; boleh berisi huruf, angka, titik (.), dan garis bawah (_). Harus diawali huruf. Tidak boleh mengandung karakter Tionghoa.

        Description

        Deskripsi templat. Maksimal 200 karakter.

      3. Klik OK untuk membuat templat parameter baru di wilayah tersebut.

      Import and export parameters

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

      1. Klik Export Parameters untuk mengekspor file parameter dalam format TXT.

      2. Setelah mengedit file tersebut, klik Import Parameters dan tempel konten file ke dalam kotak dialog.

      3. Klik OK.

      4. 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 opsi Take Effect Within the Maintenance Window atau Take Effect at Specified Time.

      5. (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.

    Modify parameters for multiple instances

    1. Masuk ke ApsaraDB RDS console. Di panel navigasi kiri, klik Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada.

    2. 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 berwarna abu-abu dan tidak dapat diklik.

    3. Pada halaman Parameters yang muncul, klik ikon Edit di paling kanan nama parameter yang ingin dimodifikasi.

    4. Pada kotak value, pilih atau masukkan nilai baru, lalu klik OK.

    5. Pada jendela Parameters yang muncul, verifikasi bahwa perubahan sudah benar, lalu klik OK.

    View modification history

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

    2. Di bilah navigasi kiri, klik Parameters.

    3. Klik tab Edit History.

    4. 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 mengirim.

    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 primary serta instans secondary, bagaimana cara mengatur parameter untuk keduanya?

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

    Saya ingin memodifikasi 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 memodifikasi periode retensi log biner pada instans RDS for MySQL, Anda dapat set the binary log retention policy di konsol RDS.

    Catatan

    Untuk menghapus atau mengurangi cadangan log dan data pada instans RDS for MySQL, Delete or reduce backups.

    Bagaimana cara memodifikasi parameter lower_case_table_names?

    Untuk informasi lebih lanjut, lihat Notes on the lower_case_table_names parameter.

    Saat saya menggunakan perintah set global untuk memodifikasi 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 dimodifikasi.

    Bagaimana cara memodifikasi parameter collation_connection dan collation_database?

    Anda tidak dapat langsung memodifikasi 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 session, karena pengaturan tingkat session akan mengambil prioritas.

    Apakah saya dapat memodifikasi parameter sql_log_bin?

    Tidak. RDS for MySQL menerapkan sql_log_bin untuk semua session 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.

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

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

    Appendix: Synchronized parameters

    Parameter berikut secara otomatis disinkronkan dari instans primary ke semua instans read-only saat dimodifikasi.

    • 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 dimodifikasi setelahnya. Hanya MySQL 5.6 yang mendukung modifikasi parameter ini pada instans primary, dengan perubahan disinkronkan ke instans read-only.image

    • innodb_large_prefix

    • loose_validate_password_length

    • default_time_zone

    • rpl_semi_sync_slave_enabled

    • character_set_server

    • collation_server

    API reference

    API

    Description

    ModifyParameter

    Memodifikasi parameter instans RDS.

    DescribeParameterTemplates

    Menanyakan templat parameter database.

    DescribeParameters

    Menanyakan konfigurasi parameter instans.