全部产品
Search

搜索本产品

    ApsaraDB RDS：Atur parameter instans

    文档中心

    ApsaraDB RDS：Atur parameter instans

    更新时间：Nov 10, 2025

    Di ApsaraDB RDS untuk MySQL, Anda dapat memodifikasi konfigurasi parameter dan mengkueri riwayat modifikasi parameter melalui konsol atau menggunakan API. Hal ini memungkinkan Anda menyesuaikan parameter instans sesuai kebutuhan bisnis. Untuk mengkueri konfigurasi parameter suatu instans, lihat Lihat parameter instans.

    Peringatan

    • Untuk menjaga stabilitas instans, Anda hanya dapat mengubah parameter yang tersedia di Konsol ApsaraDB RDS. Anda tidak dapat menggunakan perintah set global untuk mengubah parameter. Parameter yang tidak ditampilkan atau tidak dapat diedit di konsol tidak dapat diubah.

    • Saat mengubah nilai parameter, lihat kolom Modifiable Parameter Values pada halaman Modifiable Parameters di konsol. Anda juga dapat menetapkan parameter instans sebagai ekspresi agar parameter tersebut dapat menyesuaikan secara otomatis dengan perubahan konfigurasi instans.

    • Beberapa parameter secara otomatis disinkronkan ke semua instans hanya baca dari instans utama setelah diubah pada instans utama. Untuk daftar parameter ini, lihat Lampiran: Daftar parameter yang secara otomatis disinkronkan ke instans hanya baca.

    • Catatan tentang pengubahan parameter lower_case_table_names:

      • Untuk MySQL 8.0: Anda harus menentukan apakah nama tabel peka huruf besar/kecil saat membuat instans. Nilai default adalah 1, yang menunjukkan bahwa nama tabel tidak peka huruf besar/kecil. Anda tidak dapat mengubah parameter ini setelah instans dibuat.

      • Untuk MySQL 5.7 dan 5.6:

        • Parameter ini dapat diubah setelah instans dibuat, tetapi pengubahan memerlukan restart instans. Kami sarankan Anda mengubah parameter ini selama jam sepi.

        • Jika Anda ingin mengubah nilai parameter dari 0 menjadi 1, Anda harus mengonversi nama tabel huruf besar dalam instans menjadi huruf kecil terlebih dahulu. Jika tidak, tabel yang sudah ada dengan nama huruf besar akan menjadi tidak dapat diakses.

        • Anda tidak dapat mengubah parameter ini pada instans hanya baca. Anda harus mengubah parameter ini pada instans utama. Perubahan tersebut kemudian disinkronkan ke instans hanya baca.

    Penting

    Mengubah dan menerapkan parameter mungkin memerlukan restart instans atau penyambungan ulang database. Lakukan operasi ini selama jam sepi dan pastikan aplikasi Anda memiliki mekanisme penyambungan ulang.

    • Beberapa parameter memerlukan restart instans agar perubahan berlaku. Untuk informasi lebih lanjut, lihat kolom Restart Required pada halaman Modifiable Parameters di konsol. Merestart instans menyebabkan gangguan koneksi selama sekitar 30 detik. Pastikan aplikasi Anda dikonfigurasi dengan mekanisme penyambungan ulang otomatis.

    • Untuk pengubahan parameter yang tidak memerlukan restart instans, perubahan hanya berlaku untuk koneksi database baru. Agar perubahan berlaku pada koneksi database yang sudah ada, Anda harus memutuskan dan menyambungkan kembali ke database.

    Modifikasi parameter instans

    Parameter instans yang dapat dimodifikasi bervariasi berdasarkan versi mesin MySQL. Untuk informasi lebih lanjut, lihat Daftar parameter yang tersedia untuk ApsaraDB RDS for MySQL.

    Modifikasi parameter dari satu instans

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

    2. Di panel navigasi di sebelah kiri, klik Parameter Settings.

    3. Anda dapat melakukan operasi berikut:

      Modifikasi parameter tunggal

      1. Pada tab Modifiable Parameters, temukan parameter yang ingin Anda modifikasi dan ubah nilainya dengan salah satu cara berikut:

        • Klik ikon pencil di kolom Running Parameter Value dan masukkan nilai berdasarkan rentang nilai valid.

        • Pilih nilai dari daftar drop-down di kolom Running Parameter Value.

      2. Klik OK.

      3. Klik Submit Parameters. Di kotak dialog yang muncul, pilih Take Effect Immediately, Take Effect During Maintenance Window, atau Take Effect At A Specified Time.

        Catatan

        Pada tab Parameter Modification Scheduled Tasks, Anda dapat melihat tugas modifikasi parameter yang Anda pilih Take Effect During Maintenance Window atau Take Effect At A Specified Time.

      4. (Opsional) Sebelum Anda mengirimkan modifikasi parameter, Anda dapat mengklik Revoke untuk membatalkannya.

      Terapkan dan ekspor template parameter

      Terapkan template parameter

      ApsaraDB RDS menyediakan berbagai template parameter sistem untuk memenuhi kebutuhan skenario bisnis yang berbeda, seperti skenario yang memerlukan performa tinggi. Anda juga dapat membuat template parameter kustom untuk mengonfigurasi beberapa parameter sekaligus. Untuk informasi lebih lanjut, lihat Gunakan template parameter.

      1. Klik Apply Template.

      2. Pilih template parameter dan klik OK.

        Catatan

        • Anda dapat melihat jumlah parameter dalam template dan memeriksa apakah instans harus di-restart agar nilai parameter baru diterapkan. Untuk melihat lebih banyak detail tentang perubahan parameter, klik View Changed Parameters.

        • Jika Anda tidak dapat menemukan template parameter yang diinginkan, periksa apakah template dan instans berada di wilayah yang sama. Jika mereka berada di wilayah yang berbeda, Anda dapat menyalin template parameter ke wilayah tempat instans berada. Untuk informasi lebih lanjut, lihat Gunakan template parameter.

      Ekspor template parameter

      1. Klik Export As Template.

      2. Konfigurasikan parameter berikut.

        Parameter

        Deskripsi

        Template Name

        Nama template. Nama tersebut harus dimulai dengan huruf dan dapat berisi huruf, angka, titik (.), dan garis bawah (_). Nama tersebut tidak boleh berisi karakter Cina dan harus memiliki panjang 8 hingga 64 karakter.

        Description

        Deskripsi template. Ini membantu Anda mengelola template. Deskripsi tersebut dapat memiliki panjang hingga 200 karakter.

      3. Klik OK. Template parameter baru dibuat di wilayah saat ini.

      Impor dan ekspor parameter (format TXT)

      Untuk memodifikasi beberapa parameter sekaligus atau mendapatkan konfigurasi parameter dari sebuah instans, Anda dapat mengekspor parameter ke file TXT lokal. File ini berisi semua nilai parameter dari instans. Setelah Anda memodifikasi parameter dalam file, Anda dapat mengimpor file tersebut ke instans ApsaraDB RDS untuk menerapkan perubahan.

      1. Klik Export Parameters untuk mengekspor konfigurasi parameter ke file TXT lokal.

      2. Setelah Anda memodifikasi file konfigurasi parameter, klik Import Parameters dan tempelkan isi file ke dalam kotak dialog.

      3. Klik OK.

      4. Klik Submit Parameters. Di kotak dialog yang muncul, pilih waktu efektif. Anda dapat memilih Take Effect Immediately, Take Effect During Maintenance Window, atau Take Effect At A Specified Time.

        Catatan

        Pada tab Parameter Modification Scheduled Tasks, Anda dapat melihat tugas modifikasi parameter yang Anda pilih Take Effect During Maintenance Window atau Take Effect At A Specified Time.

      5. (Opsional) Sebelum Anda mengirimkan perubahan, Anda dapat mengklik Revoke untuk membatalkannya.

        Penting

        Jika pesan kesalahan Operasi gagal. Format parameter yang ditentukan tidak valid. muncul, periksa apakah nilai yang Anda masukkan untuk parameter berada dalam rentang valid yang ditentukan di kolom Parameter Value Range.

    Modifikasi parameter dari beberapa instans secara batch

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

    2. Pilih kotak centang instans target dan klik Change Parameters di bagian bawah halaman.

      Catatan

      Instans yang ingin Anda modifikasi secara batch harus menggunakan versi mesin database yang sama dan edisi RDS yang sama. Jika tidak, tombol Change Parameters akan dinonaktifkan.

    3. Di kotak dialog Parameter Settings, klik ikon Edit di sebelah nama parameter yang ingin Anda modifikasi.

    4. Di bidang Configuration Value, pilih atau masukkan nilai baru dan klik OK.

    5. Di kotak dialog Parameter Settings, konfirmasikan perubahan dan klik OK.

    Sejarah modifikasi parameter kueri

    1. Pergi ke halaman Instans. Di bilah navigasi atas, pilih wilayah tempat Instans RDS berada. Kemudian, temukan Instans RDS dan klik ID dari instans tersebut.

    2. Di panel navigasi di sebelah kiri, klik Parameter Settings.

    3. Klik tab Parameter Modification History.

    4. Pilih rentang waktu dan klik OK.

    FAQ

    Apakah modifikasi parameter berlaku segera? Apakah diperlukan restart instans?

    Beberapa modifikasi parameter berlaku dalam waktu sekitar 5 menit dan tidak memerlukan restart instans. Modifikasi parameter lainnya memerlukan restart instans agar dapat berlaku. Untuk informasi lebih lanjut, lihat kolom Restart Required pada halaman Modifiable Parameters di Konsol ApsaraDB RDS. Sebelum Anda mengirimkan perubahan, Anda harus memastikan apakah restart diperlukan.

    Mengapa tidak ada tanggapan setelah saya memodifikasi parameter?

    Tugas modifikasi parameter hanya akan dieksekusi setelah Anda mengatur nilai parameter dan mengklik Submit Parameters.

    Jika instansi hanya baca adalah instansi high-availability (HA) yang memiliki node utama dan node sekunder, bagaimana cara saya mengatur parameter untuk kedua node ini?

    Anda hanya perlu mengatur parameter pada node utama dari instansi hanya baca. Nilai parameter secara otomatis disinkronkan ke node sekunder. Anda tidak dapat langsung memodifikasi parameter node sekunder.

    Saya ingin memodifikasi parameter expire_logs_days atau binlog_expire_logs_seconds, tetapi saya tidak dapat menemukannya di Konsol ApsaraDB 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, tetapi ApsaraDB RDS for MySQL tidtidak menggunakan parameter ini untuk tujuan tersebut. Untuk memodifikasi periode retensi log biner untuk instansi ApsaraDB RDS for MySQL, Anda dapat mengatur kebijakan retensi log biner di Konsol ApsaraDB RDS.

    Catatan

    Untuk informasi lebih lanjut tentang cara menghapus atau mengurangi cadangan log dan data untuk instansi ApsaraDB RDS for MySQL, lihat Hapus atau kurangi cadangan.

    Bagaimana cara saya memodifikasi parameter lower_case_table_names?

    Untuk informasi lebih lanjut, lihat Catatan tentang modifikasi parameter lower_case_table_names.

    Apa yang harus saya lakukan jika kesalahan Access denied; you need (at least one of) the SUPER or SYSTEM_VARIABLES_ADMIN privilege(s) for this operation dilaporkan ketika saya menggunakan perintah set global untuk memodifikasi parameter?

    ApsaraDB RDS for MySQL tidak mendukung modifikasi parameter menggunakan perintah set global. Anda hanya dapat memodifikasi parameter yang tersedia di Konsol ApsaraDB RDS. Parameter yang tidak ditampilkan atau tidak dapat diedit di konsol tidak dapat dimodifikasi.

    Bagaimana cara saya memodifikasi parameter collation_connection dan collation_database?

    ApsaraDB RDS for MySQL tidak mengizinkan Anda untuk langsung memodifikasi parameter collation_connection dan collation_database. Namun, Anda dapat memodifikasinya di Konsol ApsaraDB RDS dengan mengatur parameter init_connect ke nilai yang didukung, seperti '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', atau 'set names utf8mb4 COLLATE utf8mb4_bin'.

    Setelah Anda mengonfigurasi parameter, sistem secara otomatis menjalankan perintah yang ditentukan setiap kali koneksi baru dibuat. Ini memodifikasi set karakter dan aturan pengurutan. Namun, pastikan bahwa aplikasi Anda tidak secara terpisah menyesuaikan aturan pengurutan sesi. Jika tidak, pengaturan aturan pengurutan tingkat sesi berikutnya dalam aplikasi akan menimpa konfigurasi saat ini.

    Apakah saya dapat memodifikasi parameter sql_log_bin?

    Tidak. ApsaraDB RDS for MySQL menerapkan sql_log_bin untuk semua sesi secara default untuk memastikan bahwa catatan log biner dari setiap sesi disimpan ke disk. Ini menjamin konsistensi data untuk replikasi utama/sekunder.

    Mengapa perubahan pada parameter wait_timeout tidak berlaku?

    Perubahan pada parameter wait_timeout hanya berlaku untuk koneksi baru. Agar perubahan berlaku pada koneksi yang ada, Anda harus memutuskan dan kemudian menyambungkan kembali ke database.

    Lampiran: Daftar parameter yang disinkronkan secara otomatis ke instansi hanya baca

    Jika Anda memodifikasi parameter berikut pada instans utama ApsaraDB RDS for MySQL, modifikasi tersebut akan disinkronkan secara otomatis ke semua instansi hanya baca dari instans utama.

    • lower_case_table_names

      Catatan

      Untuk ApsaraDB RDS for MySQL 8.0, Anda dapat menentukan apakah nama tabel peka terhadap huruf besar/kecil hanya saat membuat instans. Setelah instans dibuat, Anda tidak dapat memodifikasi parameter lower_case_table_names.image

    • innodb_large_prefix

    • loose_validate_password_length

    • default_time_zone

    • rpl_semi_sync_slave_enabled

    • character_set_server

    • collation_server

    Operasi API terkait

    API

    Deskripsi

    Modifikasi parameter instans

    Panggil operasi ModifyParameter untuk memodifikasi parameter dari sebuah instans RDS.

    Kueri nilai valid dan nilai default dari sebuah parameter

    Panggil operasi DescribeParameterTemplates untuk melihat template parameter database.

    Kueri konfigurasi parameter

    Panggil operasi DescribeParameters untuk menanyakan konfigurasi parameter saat ini dari sebuah instans.