Cara mengonfigurasi proksi database menggunakan titik akhir kluster PolarDB - PolarDB

Topik ini menjelaskan cara mengonfigurasi proksi database menggunakan titik akhir kluster PolarDB.

Prasyarat

Kluster harus berupa kluster PolarDB for MySQL Cluster Edition. Untuk informasi selengkapnya tentang edisi produk, lihat Enterprise Edition.

Catatan

Hanya kluster PolarDB for MySQL 8.0 yang mendukung pengaktifan query paralel dan pengaturan tingkat paralelisme saat Anda mengonfigurasi proksi database.

Prosedur

Masuk ke PolarDB console. Di panel navigasi sebelah kiri, klik Clusters. Pilih region tempat kluster berada, lalu klik ID kluster target untuk membuka halaman detail kluster.
Di halaman Basic Information kluster, temukan titik akhir kluster target di bagian Database Connection. Klik Configure di samping nama titik akhir.

Pada kotak dialog yang muncul, ubah konfigurasi titik akhir kluster sesuai kebutuhan. Tabel berikut menjelaskan item konfigurasi tersebut.

Tabel 1. Konfigurasi

Item konfigurasi		Deskripsi
Network Information		PolarDB menyediakan titik akhir pribadi untuk setiap titik akhir kluster secara default. Untuk mengubah titik akhir atau mengajukan permohonan titik akhir publik, lihat Manage endpoints.
Cluster Settings	Read/Write	Mode baca/tulis titik akhir kluster. Nilai yang valid adalah Read-only dan Read/Write (Automatic Read/Write Splitting). Catatan Anda dapat mengubah mode baca/tulis setelah membuat titik akhir kustom. Perubahan hanya berlaku untuk koneksi baru. Koneksi yang sudah ada tetap menggunakan mode semula.
Cluster Settings	Endpoint Name	Masukkan nama untuk titik akhir kluster.
Node Settings	Available Nodes dan Selected Nodes	Dari kotak Available Nodes di sebelah kiri—yang mencakup node primary dan semua node read-only—pilih node yang ingin Anda tambahkan ke titik akhir kluster untuk memproses permintaan baca. Klik ikon untuk memindahkannya ke kotak Selected Nodes di sebelah kanan. Catatan Pemilihan node tidak memengaruhi mode baca/tulis: Jika mode baca/tulis diatur ke Read/Write (Automatic Read/Write Splitting), permintaan tulis hanya dikirim ke node primary, terlepas dari apakah node primary berada di kotak Selected Nodes. Jika mode baca/tulis diatur ke Read-only, semua permintaan baca diteruskan ke node read-only berdasarkan kebijakan penyeimbangan beban dan tidak diteruskan ke node primary. Hal ini berlaku bahkan jika node primary berada di kotak Selected Nodes. Jika mode baca/tulis diatur ke Read/Write (Automatic Read/Write Splitting), karena Edisi Kluster Multi-master (Limitless) menggunakan mekanisme routing database dan tabel, Anda harus menambahkan node primary dari database dan tabel tujuan ke titik akhir baca/tulis, atau memilih semua node primary. Evaluasi dampak routing sebelum memilih node.
Node Settings	Automatically Associate New Nodes	Menentukan apakah node baru secara otomatis ditambahkan ke titik akhir ini.
Load Balancing Settings	Load Balancing Policy	Kebijakan penjadwalan yang digunakan untuk memproses permintaan baca di antara beberapa node saat pemisahan baca/tulis diaktifkan. Nilai yang valid adalah Connections-based Load Balancing dan Active Request-based Load Balancing. Untuk informasi selengkapnya tentang kebijakan penyeimbangan beban, lihat Load balancing policy.
	Primary Node Accepts Read Requests	Pilih No. Pernyataan SQL kueri hanya dikirim ke node read-only. Ini mengurangi beban pada node primary dan memastikan stabilitasnya. Pilih Yes. Pernyataan SQL kueri dapat dikirim ke node primary dan node read-only. Untuk informasi selengkapnya tentang apakah node primary menerima permintaan baca, lihat Primary node accepts read requests. Catatan Konfigurasi ini hanya didukung dalam mode Read/Write (Automatic Read/Write Splitting).
	Transaction Splitting	Aktifkan atau nonaktifkan pemisahan transaksi. Untuk informasi selengkapnya tentang pemisahan transaksi, lihat Transaction splitting. Catatan Konfigurasi ini hanya didukung dalam mode Read/Write (Automatic Read/Write Splitting).
	On-demand Connection Establishment	Aktifkan atau nonaktifkan fitur pembentukan koneksi on-demand. Untuk informasi selengkapnya tentang pembentukan koneksi on-demand, lihat On-demand Connection Establishment. Catatan Konfigurasi ini hanya didukung 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 mengatur tingkat konsistensi menjadi Eventual Consistency (Weak), Session Consistency (Medium), atau Global Consistency (Strong). Untuk informasi selengkapnya, lihat Consistency level. Jika mode baca/tulis adalah Read-only, tingkat konsistensinya adalah Eventual Consistency (Weak) dan tidak dapat diubah. Penting Perubahan tingkat konsistensi langsung berlaku untuk semua koneksi. Konsistensi global (mode kinerja tinggi) harus berlaku secara serentak pada semua titik akhir dalam kluster. Jika Anda memilih tingkat konsistensi selain konsistensi global (mode kinerja tinggi), semua titik akhir lain dalam kluster akan kembali ke status konsistensi sebelum konsistensi global (mode kinerja tinggi) diaktifkan.
	Global Consistency Timeout	Periode timeout bagi node read-only untuk menunggu sinkronisasi data terbaru. Nilainya berkisar antara 0 hingga 60000. Nilai default-nya adalah 20. Satuannya adalah ms. Catatan Konfigurasi ini hanya didukung ketika Consistency Level diatur ke Global Consistency (Strong) dan Global Consistency Mode diatur ke Traditional Mode.
	Global Consistency Timeout Policy	Kebijakan default yang digunakan oleh PolarDB setelah node read-only mengalami timeout. Nilai yang valid adalah: Send Requests to Primary Node (Default) SQL Exception: Wait replication complete timeout, please retry. Catatan Konfigurasi ini hanya didukung 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 terbaru. Nilainya berkisar antara 1 hingga 1.000.000. Nilai default-nya adalah 100. Satuannya adalah ms. Penting Konsistensi global (mode kinerja tinggi) harus berlaku secara serentak pada semua titik akhir dalam kluster. Jika Anda mengaktifkan konsistensi global (mode kinerja tinggi) untuk satu titik akhir, maka fitur tersebut juga diaktifkan untuk semua titik akhir lain dalam kluster. Konfigurasi ini hanya didukung 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 default yang digunakan oleh PolarDB setelah node read-only mengalami timeout. Nilai yang valid adalah: 0, send the request to the primary node (default) 1, report a timeout error and return an error message to the client 2, downgrade on timeout. If a global consistency read times out, the query is automatically downgraded to a regular request, and no error message is returned to the client Catatan Konfigurasi ini hanya didukung ketika Consistency Level diatur ke Global Consistency (Strong) dan Global Consistency Mode diatur ke High-performance Mode.
	Session Consistency Read Timeout	Periode timeout bagi node read-only untuk menunggu sinkronisasi data terbaru. Nilainya berkisar antara 0 hingga 60000. Nilai default-nya adalah 0. Satuannya adalah ms. Penting Konfigurasi ini hanya didukung ketika Consistency Level diatur ke Session Consistency (Medium). Konsistensi global (mode kinerja tinggi) harus berlaku secara serentak pada semua titik akhir dalam kluster. Jika Anda memilih tingkat konsistensi selain konsistensi global (mode kinerja tinggi), semua titik akhir lain dalam kluster akan kembali ke status konsistensi sebelum konsistensi global (mode kinerja tinggi) diaktifkan.
	Session Consistency Read Timeout Policy	Kebijakan default yang digunakan oleh PolarDB setelah node read-only mengalami timeout. Nilai yang valid adalah: 0, send the request to the primary node (default) 1, report an SQL error (wait replication complete timeout, please retry) Catatan Konfigurasi ini hanya didukung 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 tentang kolam koneksi, lihat Connection pool. Catatan Konfigurasi ini hanya didukung dalam mode Read/Write (Automatic Read/Write Splitting). Perubahan konfigurasi kolam koneksi hanya berlaku untuk koneksi baru. Biasanya, Anda perlu merestart aplikasi atau membangun ulang koneksi database agar perubahan berlaku.
HTAP Optimization	Parallel Query	Aktifkan atau nonaktifkan fitur query paralel dan atur tingkat paralelisme. Mengaktifkan elastic parallel query (ePQ) memungkinkan Anda 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 Sejak 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: Anda membuat titik akhir kluster kustom untuk kluster yang sudah ada dengan 8 core CPU atau lebih.
	Transactional/Analytical Processing Splitting	Aktifkan atau nonaktifkan distribusi permintaan otomatis antara penyimpanan baris dan kolom. Untuk informasi selengkapnya, lihat Configure automatic request distribution between row store and column store nodes. Catatan Konfigurasi ini hanya didukung untuk titik akhir kluster PolarDB for MySQL 8.0.1 dengan versi mesin minor 8.0.1.1.22 atau lebih baru. Titik akhir harus dalam mode Read/Write (Automatic Read/Write Splitting), dan Selected Nodes di bagian Node Settings harus mencakup minimal satu node read-only penyimpanan kolom.
	Column Store Node Accepts OLTP Requests	Aktifkan atau nonaktifkan kemampuan node penyimpanan kolom untuk menerima permintaan OLTP. Setelah Anda mengaktifkan fitur ini, node penyimpanan kolom akan menerima permintaan OLAP dan OLTP. Proksi database akan mengarahkan permintaan baca OLTP ke node penyimpanan kolom berdasarkan jumlah permintaan aktif. Hal ini dapat meningkatkan beban pada node penyimpanan kolom. Catatan Konfigurasi ini hanya didukung ketika Transactional/Analytical Processing Splitting diaktifkan.
Security Protection	Overload Protection	Aktifkan atau nonaktifkan fitur perlindungan overload. Untuk informasi selengkapnya, lihat Overload protection.

Klik OK.

FAQ

Mengapa terjadi error koneksi setelah saya mengatur bobot node read-only dalam titik akhir kluster menjadi 0 lalu menghapus node tersebut?

Scenario: Anda perlu menghapus node read-only dari titik akhir kluster. Untuk menghindari gangguan koneksi ke node tersebut, Anda terlebih dahulu mengatur bobot pemisahan baca/tulis node read-only menjadi 0. Anda berharap permintaan baca selanjutnya tidak dikirim ke node ini. Namun, setelah menghapus node dari titik akhir kluster, terjadi error koneksi di sisi client.
Cause: Titik akhir kluster memiliki dua Load Balancing Policy: Active Request-based Load Balancing dan Connections-based Load Balancing:
- Active Request-based Load Balancing: Setelah Anda mengurangi bobot node read-only menjadi 0, permintaan selanjutnya tidak lagi diarahkan ke node tersebut.
- Connections-based Load Balancing: Penyeimbangan beban hanya dilakukan saat koneksi dibentuk. Jika koneksi yang sudah ada dibentuk dengan node read-only, permintaan selanjutnya pada koneksi tersebut selalu dikirim ke node read-only tersebut.
Solution:
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.

Operasi API terkait

API	Deskripsi
Query the endpoint information of a PolarDB cluster	Kueri titik akhir kluster.
Modify the attributes of a PolarDB cluster endpoint	Ubah titik akhir kluster.
Release a custom PolarDB cluster endpoint	Lepaskan titik akhir kluster kustom.