全部产品
Search
文档中心

PolarDB:Konfigurasikan PolarProxy

更新时间:Jul 06, 2025

Topik ini menjelaskan cara mengonfigurasi PolarProxy untuk kluster PolarDB dengan mengonfigurasi titik akhir kluster.

Prasyarat

Kluster PolarDB for MySQL harus dari Edisi Kluster. Untuk informasi lebih lanjut tentang edisi kluster, lihat Edisi.

Catatan penggunaan

Anda dapat mengaktifkan fitur query paralel dan menentukan derajat paralelisme hanya ketika mengonfigurasi PolarProxy untuk kluster PolarDB for MySQL versi 8.0.

Prosedur

  1. Masuk ke Konsol PolarDB. Pada panel navigasi di sebelah kiri, klik Kluster. Di pojok kiri atas, pilih wilayah tempat kluster diterapkan. Temukan kluster dan klik ID-nya.

  2. Di bagian Database Connections pada halaman Basic Information kluster, temukan titik akhir kluster yang ingin dikonfigurasi untuk PolarProxy dan klik Configure di sebelah kanan nama titik akhir.

    7.png

  3. Di kotak dialog yang muncul, ubah konfigurasi titik akhir kluster sesuai kebutuhan bisnis Anda. Tabel berikut menjelaskan parameter yang dapat dikonfigurasi.

    Tabel 1. Parameter

    Parameter

    Deskripsi

    Network Information

    Secara default, PolarDB menyediakan titik akhir privat untuk setiap titik akhir kluster. Anda dapat mengubah titik akhir privat atau meminta titik akhir publik. Untuk informasi lebih lanjut, lihat Kelola titik akhir kluster.

    Cluster Settings

    Read/Write

    Mode baca/tulis titik akhir kluster. Anda dapat memilih Read-only atau Read / Write (Automatic Read / Write Splitting) berdasarkan kebutuhan bisnis Anda.

    Catatan

    Anda dapat mengubah mode baca/tulis titik akhir kluster kustom setelah membuat titik akhir kluster tersebut. Setelah Anda mengubah mode baca/tulis titik akhir kluster kustom, mode baru hanya berlaku untuk koneksi baru. Mode asli terus berlaku untuk koneksi yang ada.

    Endpoint Name

    Nama titik akhir kluster kustom.

    Node Settings

    Available Nodes dan Selected Nodes

    Pilih node yang ingin Anda asosiasikan dengan titik akhir kluster dari daftar Available Nodes di sebelah kiri. Daftar Node Tersedia berisi node utama dan semua node baca saja. Lalu, klik ikon 1 untuk menambahkan node yang dipilih ke daftar Selected Nodes di sebelah kanan.

    Catatan

    Jenis node yang Anda pilih tidak memengaruhi mode baca/tulis titik akhir.

    • Jika Anda menetapkan parameter Baca / Tulis ke Read / Write (Automatic Read / Write Splitting), permintaan tulis hanya dikirim ke node utama tanpa memperhatikan apakah node utama ditambahkan ke daftar Selected Nodes.

    • Jika Anda menetapkan parameter Baca / Tulis ke Read-only, semua permintaan baca diteruskan ke node baca saja dalam mode penyeimbangan beban. Permintaan baca tidak diteruskan ke node utama meskipun node utama ditambahkan ke daftar Selected Nodes.

    Automatically Associate New Nodes

    Menentukan apakah akan secara otomatis mengasosiasikan node baru dengan titik akhir kluster.

    Load Balancing Settings

    Load Balancing Policy

    Kebijakan untuk menyeimbangkan beban permintaan baca di antara node baca saja. Anda dapat memilih Connections-based Load Balancing dan Active Request-based Load Balancing berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut tentang kebijakan penyeimbangan beban, lihat Kebijakan penyeimbangan beban.

    Primary Node Accepts Read Requests

    • Jika Anda menetapkan parameter ini ke No, permintaan baca hanya dikirim ke node baca saja untuk mengurangi beban node utama.

    • Jika Anda menetapkan parameter ini ke Yes, permintaan baca dikirim ke node utama dan node baca saja.

    Untuk informasi lebih lanjut, lihat Node Utama Menerima Permintaan Baca.

    Catatan

    Parameter ini tersedia hanya jika Anda menetapkan parameter Baca/Tulis ke Read / Write (Automatic Read / Write Splitting).

    Transaction Splitting

    Menentukan apakah akan mengaktifkan fitur pemisahan transaksi. Untuk informasi lebih lanjut, lihat Pemisahan transaksi.

    Catatan

    Parameter ini tersedia hanya jika Anda menetapkan parameter Baca/Tulis ke Read / Write (Automatic Read / Write Splitting).

    On-demand Connections

    Menentukan apakah akan mengaktifkan koneksi sesuai permintaan. Untuk informasi lebih lanjut, lihat Koneksi sesuai permintaan.

    Catatan

    Parameter ini tersedia hanya jika Anda menetapkan parameter Load Balancing Policy ke Active Request-based Load Balancing.

    Consistency Settings

    Consistency Level

    • Jika Anda menetapkan parameter Baca/Tulis ke Read / Write (Automatic Read / Write Splitting), tingkat konsistensi berikut tersedia: Eventual Consistency (Weak), Session Consistency (Medium), dan Global Consistency (Strong). Untuk informasi lebih lanjut, lihat Tingkat konsistensi.

    • Jika Anda menetapkan parameter Baca / Tulis ke Read-only, tingkat konsistensi adalah Eventual Consistency (Weak) secara default dan tidak dapat diubah.

    Penting
    • Perubahan pada tingkat konsistensi segera berlaku untuk semua koneksi.

    • Konsistensi global (mode berperforma tinggi) berlaku untuk semua titik akhir kluster setelah diaktifkan. Jika Anda menonaktifkan mode ini, tingkat konsistensi semua titik akhir dikembalikan ke nilai sebelum mode diaktifkan.

    Global Consistency Timeout

    Maksimum periode waktu selama PolarProxy menunggu semua node baca saja untuk memperbarui ke LSN terbaru pada node utama setelah PolarProxy menerima permintaan baca. Nilai valid: 0 hingga 60.000. Nilai default: 20. Unit: milidetik.

    Catatan

    Parameter ini tersedia hanya jika Anda menetapkan parameter Consistency Level ke Global Consistency (Strong) dan parameter Global Consistency Mode ke Traditional Mode.

    Global Consistency Timeout Policy

    Kebijakan default yang ingin Anda terapkan jika konsistensi global gagal dicapai di antara node baca saja PolarDB dalam periode waktu habis yang ditentukan. Nilai valid:

    • Send Requests to Primary Node (Default)

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

    Catatan

    Parameter ini tersedia hanya jika Anda menetapkan parameter Consistency Level ke Global Consistency (Strong) dan parameter Global Consistency Mode ke Traditional Mode.

    Global Consistency Read Timeout (High-Performance Mode)

    Maksimum periode waktu selama PolarProxy menunggu semua node baca saja untuk menyinkronkan dengan LSN sesi terbaru setelah PolarProxy menerima permintaan baca. Rentang nilai: 1 hingga 1.000.000. Nilai default: 100. Unit: milidetik.

    Penting
    • Konsistensi global (mode berperforma tinggi) berlaku untuk semua titik akhir kluster setelah diaktifkan. Jika Anda mengaktifkan mode ini untuk satu titik akhir kluster, mode ini diaktifkan untuk semua titik akhir lainnya dari kluster.

    • Parameter ini tersedia hanya jika Anda menetapkan parameter Consistency Level ke Global Consistency (Strong) dan parameter Global Consistency Mode ke High-performance Mode.

    Global Consistency Read Timeout Policy (High-Performance Mode)

    Kebijakan default yang ingin Anda terapkan jika konsistensi global gagal dicapai di antara node baca saja PolarDB dalam periode waktu habis yang ditentukan. Nilai 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 tersedia hanya jika Anda menetapkan parameter Consistency Level ke Global Consistency (Strong) dan parameter Global Consistency Mode ke High-performance Mode.

    Session Consistency Timeout

    Maksimum periode waktu selama PolarProxy menunggu node baca saja dalam sesi untuk menyinkronkan dengan LSN sesi terbaru setelah PolarProxy menerima permintaan baca pada sesi. Nilai valid: 0 hingga 60.000. Nilai default: 0. Unit: milidetik.

    Penting
    • Parameter ini tersedia hanya jika Anda menetapkan parameter Consistency Level ke Session Consistency (Medium).

    • Konsistensi global (mode berperforma tinggi) berlaku untuk semua titik akhir kluster setelah diaktifkan. Jika Anda menonaktifkan mode ini, tingkat konsistensi semua titik akhir dikembalikan ke nilai sebelum mode diaktifkan.

    Session Consistency Timeout Policy

    Kebijakan default yang ingin Anda terapkan jika konsistensi sesi gagal dicapai di antara node baca saja PolarDB dalam periode waktu yang ditentukan. Nilai valid:

    • Send Requests to Primary Node (Default)

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

    Catatan

    Parameter ini tersedia hanya jika Anda menetapkan parameter Consistency Level ke Session Consistency (Medium).

    Connection Pool Settings

    Connection Pool

    Nilai valid: Off, Session-level, dan Transaction-level. Nilai default: Mati. Untuk informasi lebih lanjut tentang pool koneksi, lihat Pool koneksi.

    Catatan
    • Parameter ini tersedia hanya jika Anda menetapkan parameter Baca / Tulis ke Read / Write (Automatic Read / Write Splitting).

    • Modifikasi hanya berlaku untuk koneksi baru. Untuk memvalidasi modifikasi, Anda perlu me-restart aplikasi atau menghubungkan ulang ke database.

    HTAP Optimization

    Parallel Query

    Menentukan apakah akan mengaktifkan fitur query paralel dan menentukan derajat paralelisme.

    Fitur query paralel elastis (ePQ) dapat secara efektif menggunakan multi-core CPU dan sumber daya komputasi idle dalam kluster untuk mempercepat query kompleks. Untuk informasi lebih lanjut, lihat Ikhtisar ePQ.

    Catatan

    Mulai 1 April 2023, fitur ePQ diaktifkan secara otomatis untuk kluster jika kluster memenuhi kondisi berikut. Derajat paralelisme default adalah 2.

    • Untuk kluster baru, jumlah core CPU lebih besar dari atau sama dengan 8.

    • Untuk kluster yang ada, titik akhir kluster kustom dibuat, dan jumlah core CPU lebih besar dari atau sama dengan 8.

    Transactional/Analytical Processing Splitting

    Menentukan apakah akan mengaktifkan distribusi permintaan otomatis di antara node penyimpanan baris dan kolom. Untuk informasi lebih lanjut, lihat Distribusi permintaan otomatis di antara node penyimpanan baris dan kolom.

    Catatan

    Parameter ini tersedia hanya jika persyaratan berikut terpenuhi: Kluster menjalankan PolarDB for MySQL 8.0.1 dengan versi revisi 8.0.1.1.22 atau lebih baru. Titik akhir kluster berada dalam mode Read / Write (Automatic Read / Write Splitting). Daftar Selected Nodes di bagian Node Settings berisi setidaknya satu node penyimpanan kolom baca saja.

    Column store nodes handle OLTP requests

    Menentukan apakah mengizinkan node penyimpanan kolom untuk menangani permintaan pemrosesan transaksi online (OLTP).

    Jika node penyimpanan kolom diizinkan untuk menangani permintaan OLTP, node tersebut menerima permintaan pemrosesan analitik online (OLAP) dan OLTP. PolarProxy merutekan permintaan baca OLTP ke node penyimpanan kolom berdasarkan jumlah permintaan aktif. Ini dapat meningkatkan beban pada node penyimpanan kolom.

    Catatan

    Parameter ini tersedia hanya jika Anda mengaktifkan Transactional/Analytical Processing Splitting.

    Security Protection

    Overload Protection

    Menentukan apakah akan mengaktifkan fitur perlindungan beban berlebih. Untuk informasi lebih lanjut, lihat Perlindungan beban berlebih.

  4. Klik OK.

Operasi API Terkait

Operasi

Deskripsi

DescribeDBClusterEndpoints

Meminta titik akhir kluster dari kluster PolarDB.

ModifyDBClusterEndpoint

Memodifikasi konfigurasi titik akhir kluster PolarDB.

DeleteDBClusterEndpoint

Menghapus titik akhir kluster kustom dari kluster PolarDB.