All Products
Search
Document Center

PolarDB:Konfigurasikan PolarProxy

Last Updated:Jun 13, 2026

Topik ini menjelaskan cara mengonfigurasi PolarProxy menggunakan titik akhir kluster PolarDB.

Prasyarat

Edisi produk harus berupa PolarDB for MySQL Cluster Edition. Untuk informasi selengkapnya mengenai edisi produk, lihat Enterprise Edition.

Catatan penggunaan

Anda hanya dapat mengonfigurasi query paralel dan mengatur tingkat paralelisme untuk PolarProxy pada kluster PolarDB for MySQL 8.0.

Prosedur

  1. Masuk ke PolarDB console. Di panel navigasi kiri, klik Clusters. Pilih region tempat kluster Anda ditempatkan, lalu klik ID kluster yang dituju.

  2. Pada halaman Basic Information, di bagian Database Connections, temukan titik akhir kluster yang dituju dan klik Configure di sebelah kanan nama titik akhir.

  3. Pada kotak dialog yang muncul, ubah pengaturan titik akhir kluster sesuai kebutuhan. Tabel berikut menjelaskan parameter-parameter tersebut.

    Tabel 1. Parameter konfigurasi

    Parameter

    Deskripsi

    Network Information

    Secara default, PolarDB menetapkan titik akhir pribadi untuk setiap titik akhir kluster. Untuk mengubah titik akhir pribadi atau mengajukan permohonan titik akhir publik, lihat Manage endpoints.

    Cluster Settings

    Read/Write

    Mode baca/tulis titik akhir kluster. Nilai yang valid: Read-only dan Read/Write (Automatic Read/Write Splitting).

    Catatan

    Anda dapat mengubah mode baca/tulis setelah membuat titik akhir kustom. Mode baru hanya berlaku untuk koneksi baru. Koneksi yang sudah ada tidak terpengaruh.

    Endpoint Name

    Masukkan nama untuk titik akhir kluster.

    Node Settings

    Available Nodes dan Selected Nodes

    Kotak Available Nodes mencantumkan node primary dan semua node read-only. Pilih node yang akan menangani permintaan baca dan pindahkan ke kotak Selected Nodes dengan mengklik ikon 1.

    Catatan

    Pemilihan node tidak memengaruhi mode baca/tulis:

    • Jika mode baca/tulis diatur ke Read/Write (Automatic Read/Write Splitting), permintaan tulis selalu dikirim ke node primary, terlepas dari apakah node tersebut berada di dalam kotak Selected Nodes.

    • Jika mode baca/tulis diatur ke Read-only, semua permintaan baca didistribusikan di antara node read-only yang dipilih. Permintaan tidak dikirim ke node primary, meskipun node tersebut termasuk dalam kotak Selected Nodes.

    • Jika mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting), kluster multi-primary (Limitless) menggunakan mekanisme routing berbasis database/tabel. Anda harus menambahkan node primary yang menyimpan database atau tabel target ke titik akhir baca/tulis, atau memilih semua node primary. Evaluasi dampak routing sebelum memilih node.

    Automatically Associate New Nodes

    Menentukan apakah node baru secara otomatis ditambahkan ke titik akhir ini.

    Load Balancing Settings

    Load Balancing Policy

    Kebijakan penjadwalan untuk mendistribusikan permintaan baca di beberapa node saat pemisahan baca/tulis diaktifkan. Nilai yang valid: Connections-based Load Balancing dan Active Request-based Load Balancing. Untuk informasi selengkapnya, lihat Load balancing policies.

    Primary Node Accepts Read Requests

    • Pilih No. Kueri hanya dikirim ke node read-only. Hal ini mengurangi beban pada node primary dan memastikan stabilitasnya.

    • Pilih Yes. Kueri dapat dikirim ke node primary maupun node read-only.

    Untuk informasi selengkapnya, lihat Primary node accepts read requests.

    Catatan

    Pengaturan ini hanya tersedia dalam mode Read/Write (Automatic Read/Write Splitting).

    Transaction Splitting

    Mengaktifkan atau menonaktifkan pemisahan transaksi. Untuk informasi selengkapnya, lihat Transaction splitting.

    Catatan

    Pengaturan ini hanya tersedia dalam mode Read/Write (Automatic Read/Write Splitting).

    On-demand connections

    Mengaktifkan atau menonaktifkan koneksi on-demand. Untuk informasi selengkapnya, lihat On-demand connections.

    Catatan

    Pengaturan ini hanya tersedia ketika Load balancing policy diatur ke Active Request-based Load Balancing.

    Consistency Settings

    Consistency Level

    • Jika mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting), Anda dapat memilih Eventual Consistency (Weak), Session Consistency (Medium), atau Global Consistency (Strong). Untuk informasi selengkapnya, lihat Consistency levels.

    • Jika mode baca/tulis adalah Read-only, tingkat konsistensi tetap pada Eventual Consistency (Weak).

    Penting
    • Pengaturan tingkat konsistensi hanya ditampilkan jika kluster memiliki setidaknya satu node read-only (RO). Jika tidak, bagian ini tidak akan muncul.

    • Mengaktifkan mode ini untuk satu titik akhir akan mengaktifkannya untuk semua titik akhir dalam kluster. Menonaktifkannya akan mengembalikan semua titik akhir ke tingkat konsistensi yang dikonfigurasi sebelumnya.

    • Pengaturan tingkat konsistensi hanya ditampilkan ketika kluster memiliki setidaknya satu node read-only (RO). Jika kluster tidak memiliki node read-only, bagian ini tidak ditampilkan.

    Global Consistency Timeout

    Periode timeout bagi node read-only untuk menunggu sinkronisasi data dari node primary. Nilai yang valid: 0 hingga 60.000. Nilai default: 20. Satuan: ms.

    Catatan

    Parameter ini hanya tersedia ketika Consistency Level diatur ke Global Consistency (Strong) dan Global Consistency Mode diatur ke Traditional Mode.

    Global Consistency Timeout Policy

    Kebijakan yang diterapkan PolarDB ketika node read-only mengalami timeout. Nilai yang valid:

    • Send Requests to Primary Node (Default)

    • SQL Exception: Wait replication complete timeout, please retry.

    Catatan

    Parameter ini hanya tersedia ketika Consistency Level diatur ke Global Consistency (Strong) dan Global Consistency Mode diatur ke Traditional Mode.

    Global consistency read timeout (high-performance mode)

    Periode timeout bagi node read-only untuk menunggu sinkronisasi data dari node primary. Nilai yang valid: 1 hingga 1.000.000. Nilai default: 100. Satuan: ms.

    Penting
    • Global consistency (high-performance mode) berlaku untuk semua titik akhir dalam kluster. Ketika Anda mengaktifkan mode ini untuk satu titik akhir, mode tersebut juga diaktifkan untuk semua titik akhir lainnya.

    • Parameter ini hanya tersedia ketika Consistency Level diatur ke Global Consistency (Strong) dan Global Consistency Mode diatur ke High-performance Mode.

    Global consistency read timeout policy (high-performance mode)

    Kebijakan yang diterapkan PolarDB setelah terjadi timeout pada node read-only. Nilai yang valid:

    • Send Requests to Primary Node (Default)

    • Return error messages due to timeout.

    • Downgrade the consistency level of a query to inconsistent read when a global consistent read in the query times out. No error message is returned to the client.

    Catatan

    Parameter ini hanya tersedia ketika Consistency Level diatur ke Global Consistency (Strong) dan Global Consistency Mode diatur ke High-performance Mode.

    Session Consistency Timeout

    Periode timeout bagi node read-only untuk menunggu sinkronisasi data dari node primary. Nilai yang valid: 0 hingga 60.000. Nilai default: 0. Satuan: ms.

    Penting
    • Parameter ini hanya tersedia ketika Consistency Level diatur ke Session Consistency (Medium).

    Session Consistency Timeout Policy

    Kebijakan yang diterapkan PolarDB setelah terjadi timeout pada node read-only. Nilai yang valid:

    • Send Requests to Primary Node (Default)

    • SQL Exception: Wait replication complete timeout, please retry.

    Catatan

    Parameter ini hanya tersedia ketika Consistency Level diatur ke Session Consistency (Medium).

    Connection Pool Settings

    Connection Pool

    Anda dapat memilih Off (default), Session-level, atau Transaction-level. Untuk informasi selengkapnya, lihat Connection pools.

    Catatan
    • Pengaturan ini hanya tersedia dalam mode Read/Write (Automatic Read/Write Splitting).

    • Perubahan ini hanya berlaku untuk koneksi baru. Untuk menerapkannya pada sesi yang sudah ada, restart aplikasi Anda atau buat ulang koneksi database-nya.

    HTAP Optimization

    Parallel Query

    Mengaktifkan atau menonaktifkan fitur query paralel dan mengatur tingkat paralelisme.

    Mengaktifkan elastic parallel query (ePQ) memanfaatkan kemampuan pemrosesan paralel CPU multi-core (sumber daya komputasi idle dalam kluster) untuk mempercepat kueri kompleks. Untuk informasi selengkapnya, lihat Elastic parallel query.

    Catatan

    Mulai 1 April 2023, elastic parallel query diaktifkan secara default dengan tingkat paralelisme 2 jika kluster memenuhi kondisi berikut:

    • Untuk kluster baru: Kluster memiliki 8 core CPU atau lebih.

    • Untuk kluster yang sudah ada: Titik akhir kluster kustom dibuat untuk kluster yang sudah ada dengan 8 core CPU atau lebih.

    Transactional/Analytical Processing Splitting

    Mengaktifkan atau menonaktifkan pemisahan pemrosesan transaksional/analitis. Untuk informasi selengkapnya, lihat Configure transactional/analytical processing splitting.

    Catatan

    PolarDB for MySQL 8.0.1 dengan versi mesin minor 8.0.1.1.22 atau lebih baru hanya mendukung pengaturan ini ketika titik akhir kluster berada dalam mode Read/Write (Automatic Read/Write Splitting) dan kotak Selected Nodes di bawah Node Settings berisi setidaknya satu node column-store read-only.

    Column store nodes handle OLTP requests.

    Menentukan apakah node column-store diizinkan menerima permintaan OLTP.

    Jika diaktifkan, node column-store menangani permintaan OLAP dan OLTP. Proksi database mengarahkan permintaan baca OLTP ke node column-store berdasarkan jumlah permintaan aktif, yang dapat meningkatkan beban pada node tersebut.

    Catatan

    Pengaturan ini hanya tersedia ketika Transactional/Analytical Processing Splitting diaktifkan.

    Security Protection

    Overload Protection

    Mengaktifkan atau menonaktifkan fitur overload protection. Untuk informasi selengkapnya, lihat Overload protection.

  4. Klik OK.

FAQ

Kesalahan koneksi setelah menghapus node read-only

  • Skenario: Anda ingin menghapus node read-only dari titik akhir kluster. Untuk melakukannya tanpa mengganggu koneksi aktif, Anda terlebih dahulu mengatur bobot pemisahan baca/tulis node read-only tersebut menjadi 0. Anda mengharapkan permintaan baca baru tidak lagi diarahkan ke node tersebut. Namun, setelah Anda menghapus node tersebut dari titik akhir kluster, aplikasi klien mengalami kesalahan koneksi.

  • Penyebab: Titik akhir kluster memiliki dua opsi Load Balancing Policy: Active Request-based Load Balancing dan Connections-based Load Balancing.

    • Active Request-based Load Balancing: Setelah bobot node read-only diatur ke 0, permintaan baru tidak lagi diarahkan ke node tersebut.

    • Connections-based Load Balancing: Penyeimbangan beban hanya terjadi saat koneksi dibuat. Koneksi yang sudah ada ke node tersebut akan terus mengirim permintaan ke node tersebut.

  • Solusi:

    1. Ubah Load Balancing Policy titik akhir kluster menjadi Active Request-based Load Balancing.

    2. Atur bobot pemisahan baca/tulis node read-only target menjadi 0.

    3. Hapus node read-only tersebut.

Referensi API

API

Deskripsi

DescribeDBClusterEndpoints

Menanyakan titik akhir kluster.

ModifyDBClusterEndpoint

Memodifikasi titik akhir kluster.

DeleteDBClusterEndpoint

Menghapus titik akhir kluster kustom.