全部产品
Search
文档中心

PolarDB:Menghubungkan ke PolarDB Kluster

更新时间:Sep 26, 2025

Untuk menghubungkan aplikasi Anda ke PolarDB kluster, gunakan titik akhir yang mencakup alamat host dan port dalam string koneksi untuk skrip, utilitas, atau aplikasi apa pun. Untuk sebagian besar kasus penggunaan, kami merekomendasikan menggunakan titik akhir kluster untuk semua koneksi ke kluster Anda. Ini memastikan ketersediaan tinggi dan secara otomatis memanfaatkan node read-only untuk penskalaan. Untuk kasus penggunaan tertentu, PolarDB juga menyediakan titik akhir kustom dan utama. Panduan ini menjelaskan berbagai jenis titik akhir dan cara menggunakannya secara efektif.

Perbandingan antara titik akhir kluster dan titik akhir utama

Setiap kluster PolarDB memiliki tiga jenis titik akhir, masing-masing dirancang untuk kasus penggunaan tertentu. Titik Akhir Kluster dan Kustom didukung oleh PolarProxy yang dikelola, yang menyediakan fitur canggih seperti pemisahan baca/tulis, penyeimbangan beban, serta pooling koneksi.

Jenis

Deskripsi

Kasus penggunaan

Jenis jaringan yang didukung

Titik akhir kluster default (Direkomendasikan)

Sebuah titik akhir tunggal yang terhubung ke node utama saat ini dari kluster.

Disediakan oleh PolarProxy, mendukung pemisahan baca/tulis otomatis. Permintaan tulis diarahkan ke node utama dan permintaan baca diarahkan ke node read-only.

Bisnis yang memerlukan pemisahan baca/tulis dan dapat diskalakan dengan cepat secara real-time dengan menambahkan node read-only.

  • Jaringan pribadi

  • Jaringan publik

Titik akhir kustom

Sebuah titik akhir yang ditentukan pengguna yang terhubung ke subset node tertentu dalam kluster.

  • Anda dapat mengonfigurasi node mana (utama atau read-only) yang akan dilalui lalu lintas oleh titik akhir kustom, bersama dengan mode baca/tulisnya dan kebijakan penyeimbangan beban.

  • Titik akhir kustom harus disambungkan setidaknya ke satu node read-only. Permintaan yang dikirim ke titik akhir ini hanya diarahkan ke node read-only yang disambungkan.

Catatan

Titik akhir kustom node tunggal dimaksudkan hanya untuk tujuan pengembangan atau pengujian dan tidak boleh digunakan dalam produksi. Titik akhir ini tidak memberikan ketersediaan tinggi. Jika node yang mendasarinya gagal, titik akhir akan menjadi tidak tersedia hingga satu jam, menyebabkan pemadaman untuk aplikasi yang terhubung.

Mengisolasi akses node database untuk layanan yang berbeda. Sebagai contoh, jika node read-only 5 pada gambar sebelumnya gagal, hanya Layanan Z yang terpengaruh.

Dengan mengatur mode baca/tulis ke Read-only, Anda dapat mengonfigurasi titik akhir untuk mendukung hanya layanan read-only.

Titik akhir utama

Sebuah titik akhir utama tunggal yang terhubung ke node database tertentu, melewati PolarProxy.

  • Selalu terhubung ke node utama dan mendukung operasi baca dan tulis.

  • Jika node utama gagal, titik akhir utama secara otomatis beralih ke node utama baru.

Bisnis yang tidak memerlukan pemisahan baca/tulis.

Titik akhir pribadi dan publik

Titik akhir dapat dikonfigurasi menggunakan jenis jaringan yang berbeda guna mengontrol akses.

Jenis jaringan

Deskripsi

Kasus penggunaan

Jaringan pribadi (VPC)

  • Memberikan performa dan keamanan terbaik dengan menjaga lalu lintas tetap berada dalam Virtual Private Cloud (VPC) Anda. Ini adalah jenis jaringan yang direkomendasikan untuk aplikasi produksi.

  • Saat Anda membuat kluster, titik akhir pribadi dibuat secara default. Anda dapat memodifikasi titik akhir ini tetapi tidak dapat melepaskannya. Lihat Ubah titik akhir kluster untuk detailnya.

Contoh:

  • Jika instance ECS dan kluster database berada dalam VPC yang sama, instance ECS dapat mengakses kluster database melalui titik akhir pribadi.

  • Gunakan DMS untuk mengakses kluster database melalui VPC.

Jaringan publik

  • Mengizinkan koneksi melalui internet publik. Ini berguna untuk pengembangan, manajemen jarak jauh, atau menghubungkan dari layanan di luar VPC Anda, tetapi tidak menawarkan performa optimal dan memerlukan manajemen keamanan yang hati-hati.

  • Anda dapat meminta atau melepaskan titik akhir publik. Lihat Kelola titik akhir kluster untuk detailnya.

Sebagai contoh, akses kluster database melalui titik akhir publik untuk operasi pemeliharaan.

Mode baca/tulis untuk titik akhir kluster

Titik akhir kluster mendukung dua mode baca/tulis: Read/Write (Automatic Read/Write Splitting) dan Read-only. Tabel berikut menjelaskan perbedaan antara kedua mode tersebut.

Catatan

Untuk instruksi tentang cara mengatur mode baca/tulis untuk titik akhir kluster, lihat Konfigurasikan PolarProxy.

Item

Read/Write (Automatic Read/Write Splitting)

Read-only

Metode Pemilihan Node Layanan

Metode berikut didukung:

  • Pilih hanya node utama.

  • Pilih satu atau lebih node read-only.

  • Pilih node utama dan satu atau lebih node read-only.

Catatan

Dalam mode pemisahan baca/tulis:

  • Semua permintaan tulis dikirim ke node utama, terlepas dari apakah node utama ditambahkan sebagai node layanan.

  • Untuk permintaan baca, Anda dapat menggunakan pengaturan Primary Node Accepts Read Requests untuk menentukan apakah node utama memproses permintaan baca.

Hanya metode berikut yang didukung:

  • Pilih satu atau lebih node read-only.

Catatan

Dalam mode hanya-baca:

  • Semua permintaan baca diteruskan ke node read-only berdasarkan kebijakan penyeimbangan beban.

  • Tidak ada permintaan yang diteruskan ke node utama, meskipun ditambahkan sebagai node layanan.

  • Anda tidak dapat membuat titik akhir kluster hanya-baca yang hanya berisi node utama.

Load Balancing Policy

Mendukung kebijakan Active Request-based Load Balancing.

Lihat Kebijakan Penyeimbangan Beban.

Connections-based Load Balancing dan Active Request-based Load Balancing didukung.

Untuk informasi lebih lanjut, lihat Kebijakan Penyeimbangan Beban.

Primary Node Accepts Read Requests

Didukung. Lihat Fitur untuk detailnya.

Fitur ini tidak berlaku karena dirancang untuk mengurangi beban pada node utama. Node utama untuk titik akhir Read-only tidak memproses permintaan baca atau tulis apa pun.

Transaction Splitting

Didukung.

Lihat Pemisahan Transaksi.

Catatan

Konfigurasi ini didukung hanya jika Consistency Level diatur ke Session Consistency (Medium) atau Global Consistency (Strong).

Fitur ini tidak berlaku karena dirancang untuk mengurangi beban pada node utama. Node utama untuk titik akhir Read-only tidak memproses permintaan baca atau tulis apa pun.

Consistency Level

Mendukung Eventual Consistency (Weak), Session Consistency (Medium), dan Global Consistency (Strong). Lihat Tingkat Konsistensi.

Hanya Eventual Consistency (Weak) yang didukung karena titik akhir ini tidak melakukan operasi tulis.

Connection Pool

Mendukung kolam koneksi tingkat Session-level dan Transaction-level.

Untuk informasi lebih lanjut, lihat Kolam Koneksi.

Catatan
  • Kolam koneksi adalah fitur dari PolarDB PolarProxy dan tidak memengaruhi fitur kolam koneksi di klien Anda. Jika klien Anda menyediakan kolam koneksi, Anda dapat memilih Off untuk menonaktifkan fitur kolam koneksi PolarProxy.

  • Jika Anda menyetel fitur kolam koneksi proxy ke Off, koneksi Klien akan dirutekan melalui proxy ke semua node yang dikonfigurasi untuk Titik akhir, termasuk Node utama dan node read-only. Jumlah total koneksi bisnis yang tersedia kemudian dibatasi oleh jumlah koneksi maksimum Node utama.

Tidak didukung.

Catatan

PolarDB mendistribusikan koneksi secara merata di antara semua node read-only yang dikonfigurasikan untuk titik akhir kluster Read-only. Node utama tidak berpartisipasi dalam distribusi koneksi. Koneksi klien diarahkan melalui proxy ke node read-only tunggal. Total jumlah koneksi yang tersedia adalah jumlah dari koneksi maksimum untuk semua node read-only.

Security Protection

Didukung. Lihat Perlindungan Overload.

Tidak didukung.

FAQ

Bagaimana saya bisa menentukan dari informasi sesi apakah aplikasi saya terhubung ke titik akhir utama atau titik akhir kluster?

Anda dapat menentukan ini melalui dua cara:

  1. Dengan ID Sesi:
    Jika ID sesi kurang dari 16777215, koneksi tersebut menuju alamat utama. Jika tidak, koneksi tersebut menuju alamat kluster.

  2. Dengan kolom Vip di SQL Insight:
    Navigasikan ke tab Audit di dalam Penjelajah SQL. Jika kolom Vip berisi nilai, koneksi tersebut menuju alamat kluster atau alamat kustom. Jika kolom tersebut kosong, itu bisa berarti salah satu dari dua hal:

    • Koneksi tersebut menuju alamat utama.

    • Koneksi tersebut menuju alamat kluster, tetapi versi kernel database terlalu lama untuk mengeluarkan informasi Vip. Sebagai contoh, untuk MySQL 8.0.1, versi minor kernel harus 8.0.1.1.3 atau lebih baru.

    Dalam kasus terakhir, kami merekomendasikan untuk meningkatkan versi kernel database Anda agar dapat menggunakan kolom Vip untuk pemeriksaan ini secara andal.

Bagaimana saya bisa menentukan apakah sesi saat ini terhubung ke titik akhir kluster default atau titik akhir kustom?

Periksa kolom Vip di tab Audit Penjelajah SQL. Alamat IP yang ditampilkan pada kolom ini merupakan IP dari alamat kluster atau kustom.

Jika kolom ini kosong, kemungkinan disebabkan oleh versi kernel database yang terlalu lama untuk mengeluarkan informasi ini. Sebagai contoh, untuk MySQL 8.0.1, versi minor kernel harus 8.0.1.1.3 atau lebih baru. Dalam situasi ini, kami merekomendasikan agar Anda meningkatkan versi kernel database.

Bagaimana saya bisa langsung terhubung ke node read-only?

Anda dapat membuat titik akhir khusus untuk node read-only dengan menetapkan alamat kustom. Koneksi yang dibuat melalui titik akhir ini akan diarahkan secara eksklusif ke node read-only yang dipilih.

Langkah-langkah:

  1. Masuk ke Konsol PolarDB. Di halaman Informasi Dasar kluster Anda, temukan bagian Koneksi Database dan klik Buat Titik Akhir Kustom.

  2. Di kotak dialog Buat Titik Akhir Kustom, atur Mode Baca/Tulis ke Hanya-Baca, pilih node read-only yang diinginkan, dan klik OK.

  3. Setelah titik akhir kustom dibuat, Anda dapat menggunakan string koneksi untuk terhubung langsung ke node read-only yang ditentukan.