All Products
Search

This Product

    PolarDB:Atur parameter kluster dan parameter node

    Document Center

    PolarDB:Atur parameter kluster dan parameter node

    Last Updated:Jun 22, 2026

    Setelah membuat kluster PolarDB, Anda dapat menggunakan konsol untuk mengubah parameter kluster dan node serta mengekspor parameter kluster sebagai templat. Templat tersebut juga dapat diterapkan untuk mengubah parameter kluster lain di wilayah yang sama secara cepat. Topik ini menjelaskan cara mengubah parameter, mengekspornya sebagai templat, dan menerapkan templat tersebut.

    Informasi latar belakang

    Anda dapat mengonfigurasi parameter node PolarDB sesuai kebutuhan bisnis Anda.

    • Node baru yang ditambahkan ke kluster menggunakan parameter kluster secara default.

    • Jika node primary gagal:

      • Node primary asli menjadi node read-only, dan parameternya tetap tidak berubah.

      • Salah satu node read-only asli dipromosikan menjadi node primary, dan parameternya tetap tidak berubah.

    • Jika zona primary gagal, sebuah node di zona sekunder dipromosikan menjadi node primary dan menggunakan parameter kluster.

    Catatan penggunaan

    • Untuk kompatibilitas dengan file konfigurasi MySQL, semua parameter kluster di Konsol PolarDB menggunakan awalan loose_.

      Contohnya, loose_rds_audit_log_event_buffer_size dan rds_audit_log_event_buffer_size adalah parameter yang sama.

    • Hanya beberapa parameter node atau nilai parameter yang dapat diubah. Untuk informasi selengkapnya, lihat opsi yang didukung di konsol.

    • Untuk mengubah parameter node yang tidak dapat diubah di konsol, buka Quota Center. Temukan kuota bernama Set cluster and node parameters, klik Apply pada kolom Actions, lalu masukkan ID kluster dan parameter yang ingin Anda ubah di bidang Reason for Request.

      Catatan

      • Saat ini, hanya parameter berikut yang dapat diubah:

        • PolarDB for MySQL 5.6 dan 5.7: parameter node innodb_buffer_pool_size.

        • PolarDB for MySQL 8.0: parameter node innodb_buffer_pool_size, loose_oss_outfile_buffer_size, loose_max_oss_outfile_threads, dan loose_csv_oss_buff_size.

      • Jika Anda memiliki pertanyaan atau perlu mengubah parameter lain, hubungi kami.

    Mengubah nilai parameter

    Perubahan pada parameter kluster memengaruhi semua node dalam kluster. Perubahan pada parameter node hanya memengaruhi node yang ditentukan. Bagian ini memberikan contoh cara mengubah parameter kluster.

    1. Masuk ke Konsol PolarDB.

    2. Di pojok kiri atas, pilih wilayah tempat kluster ditempatkan.

    3. Temukan kluster target dan klik ID-nya.

    4. Di panel navigasi sebelah kiri, pilih Settings and Management > Parameters.

    5. Untuk mengubah parameter kluster, pilih Cluster dari daftar drop-down di pojok kiri atas.

      Untuk mengubah parameter node, pilih node dari daftar drop-down.

    6. Di pojok kiri atas halaman, klik Modify Parameter.

    7. Temukan parameter dan masukkan nilai baru.

      Catatan

      • Anda harus memasukkan nilai dalam rentang yang ditentukan di kolom Range to Be Modified. Jika tidak, terjadi error saat Anda mengklik Submit Changes.

      • Anda dapat mengklik ikon 参数图标 di samping nama parameter untuk melihat detailnya.

      • Untuk kompatibilitas, awalan loose_ digunakan untuk parameter di konsol. Contohnya, loose_rds_audit_log_event_buffer_size dan rds_audit_log_event_buffer_size adalah parameter yang sama.

    8. Di pojok kiri atas, klik Submit Changes.

    9. Pada halaman Save Changes, pilih node yang akan diperbarui dan klik OK.

      Tabel perubahan parameter dalam dialog mencakup kolom Parameter, New Value, Current Value, Default Value, dan Global Parameter. Anda dapat menyesuaikan parameter dengan cepat dengan mengklik Set All to Current Value atau Set All to Default Value. Saat Anda mengubah parameter global, semua node dipilih secara default.

      Catatan

      • Untuk parameter yang nilainya Force Restart adalah Yes, Anda harus me-restart semua node dalam kluster agar nilai parameter baru berlaku. Sebelum me-restart kluster, rencanakan downtime ini dan lanjutkan dengan hati-hati.

      • Jika kluster PolarDB for MySQL Anda versi 8.0, Anda juga dapat mengatur parameter innodb_fast_startup ke ON untuk mempercepat proses restart.

    Menerapkan templat parameter

    Setelah mengonfigurasi parameter, Anda dapat melakukan hal berikut:

    • Mengekspor parameter kluster sebagai templat parameter.

      1. Masuk ke Konsol PolarDB.

      2. Di pojok kiri atas konsol, pilih wilayah tempat kluster berada.

      3. Temukan kluster dan klik ID klusternya.

      4. Di panel navigasi sebelah kiri, klik Settings and Management > Parameters.

      5. Klik Export as Template.

        Catatan

        • Jika Anda ingin mengubah parameter dalam daftar saat ini, ubah terlebih dahulu, lalu klik Export as Template.

        • Templat parameter yang diekspor mencakup parameter yang Anda ubah secara manual dan parameter yang disesuaikan otomatis oleh kluster selama waktu proses.

      6. Pada dialog Apply Template, konfigurasikan parameter berikut.

        Parameter

        Deskripsi

        Template Name

        Nama templat, yang harus memenuhi persyaratan berikut:

        • Harus dimulai dengan huruf dan hanya boleh berisi huruf, angka, dan garis bawah (_).

        • Panjangnya harus antara 8 hingga 64 karakter.

        Description

        Masukkan deskripsi untuk templat. Panjang deskripsi boleh 0 hingga 200 karakter.

      7. Klik OK.

    • Menerapkan templat parameter ke kluster.

      1. Klik Apply Template.

      2. Pada dialog Apply Template, pilih nama templat parameter yang ingin digunakan dan klik OK.

        Catatan

        • Anda dapat melihat jumlah parameter dalam templat, apakah diperlukan restart, dan waktu pembaruan.

        • Jika templat parameter berisi parameter yang memerlukan restart kluster, lakukan operasi ini pada jam sepi dan pastikan aplikasi Anda memiliki mekanisme penyambungan ulang.

        • Anda juga dapat menerapkan templat parameter ke kluster di halaman templat parameter. Untuk informasi selengkapnya, lihat Apply a parameter template.

    Bandingkan parameter node

    Anda dapat menggunakan fitur Compare untuk membandingkan konfigurasi parameter antar node yang berbeda.

    1. Masuk ke Konsol PolarDB.

    2. Di pojok kiri atas, pilih wilayah tempat kluster ditempatkan.

    3. Temukan kluster target dan klik ID-nya.

    4. Di panel navigasi sebelah kiri, pilih Settings and Management > Parameters.

    5. Di pojok kiri atas halaman, klik Compare.

      Pada panel Compare, pilih node yang akan dibandingkan (misalnya, primary node dan read-only node).

    6. Tinjau hasil perbandingan, yang menunjukkan perbedaan seperti jumlah parameter yang berbeda dan apakah diperlukan restart.

    Referensi API

    API

    Deskripsi

    DescribeDBClusterParameters

    Menanyakan parameter suatu kluster.

    ModifyDBClusterParameters

    Mengubah parameter suatu kluster.

    ModifyDBClusterAndNodesParameters

    Mengubah parameter kluster dan menerapkan perubahan ke node tertentu.

    ModifyDBNodesParameters

    Mengubah parameter satu atau beberapa node tertentu.

    DescribeParameterTemplates

    Menanyakan daftar templat parameter default.