Konfigurasikan proksi database menggunakan titik akhir kluster PolarDB - PolarDB

Konfigurasikan proksi database dengan menggunakan titik akhir kluster PolarDB.

Prasyarat

Edisi produk harus berupa PolarDB for MySQLCluster Edition. Untuk informasi lebih lanjut mengenai edisi produk, lihat Edisi Enterprise.

Catatan penggunaan

Hanya kluster PolarDB for MySQL 8.0 yang mendukung pengaktifan kueri 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 Connections, lalu klik Configure di sebelah kanannya.

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

Tabel 1. Parameter konfigurasi

Parameter		Deskripsi
Network Information		PolarDB menyediakan titik akhir pribadi untuk setiap titik akhir kluster secara default. Untuk mengubah titik akhir ini atau mengajukan permohonan titik akhir publik, lihat Manage endpoints.
Cluster Settings	Read/Write	Mode baca/tulis titik akhir kluster. Mode yang valid adalah Read-only dan Read/Write (Automatic Read/Write Splitting). Catatan Anda dapat mengubah mode baca/tulis setelah membuat titik akhir kustom. Setelah mode baca/tulis diubah, 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	Kotak Available Nodes di sebelah kiri mencakup node primary dan semua node read-only. Pilih node yang ingin Anda tambahkan ke titik akhir kluster untuk menangani permintaan baca, lalu klik ikon untuk memindahkannya ke kotak Selected Nodes di sebelah kanan. Catatan Pemilihan node tidak memengaruhi mode baca/tulis: Saat mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting), permintaan tulis hanya dikirim ke node primary, terlepas dari apakah node primary dipilih dalam Selected Nodes. Saat mode baca/tulis adalah Read-only, semua permintaan baca diteruskan ke node read-only melalui load balancing dan tidak diteruskan ke node primary. Bahkan jika node primary ditambahkan ke Selected Nodes, hal ini tidak berlaku. Saat mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting), karena kluster multi-primary (Limitless) menggunakan mekanisme routing database dan tabel, tambahkan node primary dari database dan tabel target ke titik akhir baca/tulis, atau pilih semua node primary. Evaluasi secara menyeluruh dampak routing sebelum memilih node.
Node Settings	Automatically Associate New Nodes	Menentukan apakah akan secara otomatis menambahkan node baru ke titik akhir ini.
Load Balancing Settings	Load Balancing Policy	Kebijakan penjadwalan yang digunakan untuk memproses permintaan baca di beberapa node selama pemisahan baca/tulis. Kebijakan yang valid adalah Connections-based Load Balancing dan Active Request-based Load Balancing. Untuk informasi lebih lanjut mengenai kebijakan penyeimbangan beban, lihat Load balancing policies.
	Primary Node Accepts Read Requests	Pilih No. Kueri SQL hanya dikirim ke node read-only, sehingga mengurangi beban pada node primary dan menjaga stabilitas node primary. Pilih Yes. Kueri SQL dapat dikirim ke node primary dan node read-only. Untuk informasi selengkapnya tentang apakah database utama menerima permintaan baca, lihat Node utama menerima permintaan baca. Catatan Pengaturan ini hanya didukung dalam mode Read/Write (Automatic Read/Write Splitting).
	Transaction Splitting	Aktifkan atau nonaktifkan pemisahan transaksi. Untuk informasi lebih lanjut mengenai pemisahan transaksi, lihat Transaction splitting. Catatan Pengaturan ini hanya didukung dalam mode Read/Write (Automatic Read/Write Splitting).
	On-demand connections	Aktifkan atau nonaktifkan on-demand connections. Untuk informasi lebih lanjut mengenai on-demand connections, lihat On-demand connections. Catatan Pengaturan ini hanya didukung ketika Load balancing policy adalah Active Request-based Load Balancing.
Consistency Settings	Consistency Level	Saat mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting), tingkat konsistensi yang tersedia adalah Eventual Consistency (Weak), Session Consistency (Medium), dan Global Consistency (Strong). Untuk informasi lebih lanjut, lihat Consistency levels. Saat mode baca/tulis adalah Read-only, tingkat konsistensi default adalah Eventual Consistency (Weak) dan tidak dapat diubah. Penting Pengaturan konsistensi hanya ditampilkan jika kluster berisi minimal satu node read-only (RO). Jika kluster tidak memiliki node read-only, bagian ini tidak ditampilkan. Perubahan pada 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 menyinkronkan data terbaru. Nilai yang valid: 0 hingga 60.000. Nilai default: 20. Satuan: ms. Catatan Pengaturan ini hanya didukung saat Consistency Level adalah Global Consistency (Strong) dan Global Consistency Mode adalah Traditional Mode.
	Global Consistency Timeout Policy	Kebijakan default yang diterapkan oleh PolarDB setelah node read-only mengalami timeout. Nilai yang valid: Send Requests to Primary Node (Default) SQL Exception: Wait replication complete timeout, please retry. Catatan Pengaturan ini hanya didukung saat Consistency Level adalah Global Consistency (Strong) dan Global Consistency Mode adalah Traditional Mode.
	Timeout for global consistency reads (high-performance mode)	Periode timeout bagi node read-only untuk menyinkronkan data terbaru. Nilai yang valid: 1 hingga 1.000.000. Nilai default: 100. Satuan: 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 ini juga diaktifkan untuk semua titik akhir lain dalam kluster. Pengaturan ini hanya didukung saat Consistency Level adalah Global Consistency (Strong) dan Global Consistency Mode adalah High-performance Mode.
	Policy for global consistency read timeouts (high-performance mode)	Kebijakan default yang diterapkan oleh PolarDB setelah node read-only mengalami timeout. 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 Pengaturan ini hanya didukung saat Consistency Level adalah Global Consistency (Strong) dan Global Consistency Mode adalah High-performance Mode.
	Session Consistency Timeout	Periode timeout bagi node read-only untuk menyinkronkan data terbaru. Nilai yang valid: 0 hingga 60.000. Nilai default: 0. Satuan: ms. Penting Pengaturan ini hanya didukung saat Consistency Level adalah 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 Timeout Policy	Kebijakan default yang diterapkan oleh PolarDB setelah node read-only mengalami timeout. Nilai yang valid: Send Requests to Primary Node (Default) SQL Exception: Wait replication complete timeout, please retry. Catatan Pengaturan ini hanya didukung saat Consistency Level adalah Session Consistency (Medium).
Connection Pool Settings	Connection Pool	Anda dapat memilih Off (default), Session-level, atau Transaction-level. Untuk informasi lebih lanjut mengenai kolam koneksi, lihat Connection pools. Catatan Pengaturan ini hanya didukung saat mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting). Perubahan konfigurasi kolam koneksi hanya berlaku untuk koneksi yang baru dibuat. Biasanya, agar perubahan berlaku, Anda perlu restart aplikasi atau membuat ulang koneksi ke database.
HTAP Optimization	Parallel Query	Aktifkan atau nonaktifkan kueri paralel dan atur tingkat paralelisme. Elastic Parallel Query (ePQ) memanfaatkan kemampuan pemrosesan paralel CPU multi-inti (sumber daya komputasi idle dalam kluster) untuk mempercepat kueri kompleks. Untuk informasi lebih lanjut, lihat Elastic Parallel Query. Catatan Mulai 1 April 2023, Elastic Parallel Query diaktifkan secara default dan tingkat paralelisme default bernilai 2 untuk kluster yang memenuhi kondisi berikut: Kluster yang baru dibuat: kluster memiliki minimal 8 core CPU. Kluster yang sudah ada: Anda membuat titik akhir kluster kustom dalam kluster tersebut, dan kluster memiliki minimal 8 core CPU.
	Transactional/Analytical Processing Splitting	Aktifkan atau nonaktifkan pengalihan trafik otomatis antara node penyimpanan baris dan node penyimpanan kolom. Untuk informasi lebih lanjut, lihat Configure automatic request distribution. Catatan PolarDB for MySQL 8.0.1 dengan versi mesin minor 8.0.1.1.22 atau lebih baru hanya mendukung pengaturan ini dalam mode Read/Write (Automatic Read/Write Splitting). Selain itu, Node Settings harus mencakup minimal satu node read-only penyimpanan kolom dalam Selected Nodes.
	Column store nodes handle OLTP requests.	Aktifkan atau nonaktifkan kemampuan node penyimpanan kolom untuk menangani permintaan OLTP. Setelah fitur ini diaktifkan, node penyimpanan kolom menangani permintaan OLAP dan OLTP. Proksi database mengarahkan permintaan baca OLTP ke node penyimpanan kolom berdasarkan jumlah permintaan aktif, yang dapat meningkatkan beban pada node penyimpanan kolom. Catatan Pengaturan ini hanya didukung saat Transactional/Analytical Processing Splitting diaktifkan.
Security Protection	Overload Protection	Aktifkan atau nonaktifkan perlindungan overload. Untuk informasi lebih lanjut, lihat Overload protection.

Klik OK.

FAQ

Mengapa menghapus node read-only dari titik akhir kluster menyebabkan error koneksi setelah bobotnya diatur menjadi 0?

Skenario: Anda ingin menghapus node read-only dari titik akhir kluster. Untuk menghindari gangguan pada koneksi yang ada ke node tersebut, Anda terlebih dahulu mengatur bobot pemisahan baca/tulis node read-only menjadi 0. Anda berharap permintaan baca selanjutnya tidak lagi dikirim ke node read-only tersebut setelah bobotnya diatur menjadi 0. Namun, setelah Anda menghapus node tersebut dari titik akhir kluster, aplikasi melaporkan error koneksi.
Penyebab: Titik akhir kluster memiliki dua opsi Load Balancing Policy, yaitu Active Request-based Load Balancing dan Connections-based Load Balancing:
- Active Request-based Load Balancing: Setelah bobot node read-only dikurangi menjadi 0, permintaan selanjutnya tidak lagi diarahkan ke node tersebut.
- Connections-based Load Balancing: Penyeimbangan beban hanya terjadi saat koneksi dibuat. Jika koneksi yang sudah ada terhubung ke node read-only, permintaan selanjutnya pada koneksi tersebut selalu dikirim ke node read-only 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	Melepaskan titik akhir kluster kustom.