Topik ini menjelaskan cara mengonfigurasi proksi database. Anda dapat mengaktifkan fitur seperti pemisahan baca/tulis, pemisahan transaksi, dan tingkat konsistensi yang berbeda dengan membuat atau memodifikasi titik akhir kluster.
Buat titik akhir kluster kustom
Masuk ke PolarDB console. Di panel navigasi sebelah kiri, klik Clusters. Pilih region kluster tersebut lalu klik ID kluster untuk membuka halaman detail kluster.
Pada halaman Basic Information, temukan bagian Database Connections dan klik Create Custom Cluster Endpoint.
Pada kotak dialog Create Custom Cluster Endpoint, atur parameter berikut.
Item Konfigurasi
Deskripsi
Network Information
PolarDB menyediakan titik akhir pribadi untuk setiap cluster endpoint secara default. Untuk mengubah titik akhir atau mengajukan permohonan titik akhir publik, lihat Modify an endpoint dan Apply for an endpoint.
Cluster Settings
Read/Write
Mode baca/tulis untuk titik akhir ini. Opsi yang tersedia adalah Read-only dan Read/Write (Automatic Read/Write Splitting).
CatatanAnda dapat mengubah mode baca/tulis setelah membuat titik akhir kustom. Perubahan hanya berlaku untuk koneksi baru. Koneksi yang sudah ada tetap menggunakan mode aslinya.
Endpoint Name
Masukkan nama untuk cluster endpoint.
Node Settings
Available Nodes dan Selected Nodes
Dari kotak Available Nodes di sebelah kiri, pilih node yang ingin Anda tambahkan ke titik akhir ini untuk memproses permintaan baca. Klik ikon
untuk memindahkannya ke kotak Selected Nodes di sebelah kanan.CatatanAvailable Nodes mencakup node primary dan semua node read-only.
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 Anda memilihnya atau tidak.
PolarDB memungkinkan Anda membuat cluster endpoint dengan satu node tunggal. Namun, jika mode baca/tulis adalah Read-only, Anda tidak dapat membuat cluster endpoint berbasis node tunggal yang hanya berisi node primary.
Automatically Associate New Nodes
Menentukan apakah node baru akan ditambahkan secara otomatis ke titik akhir.
Load Balancing Settings
Load Balancing Policy
Jika mode baca/tulis adalah Read-only, ini merupakan kebijakan penjadwalan untuk memproses permintaan baca di beberapa node. Opsi yang tersedia adalah Load balancing based on the number of connections dan Load balancing based on the number of active requests.
Jika mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting), ini merupakan kebijakan penjadwalan untuk memproses permintaan baca di beberapa node. Nilai default-nya adalah Load balancing based on the number of active requests. Pengaturan ini tidak dapat diubah.
Primary Node Accepts Read Requests
Jika Anda mengaktifkan fitur ini, pernyataan SQL kueri hanya dikirim ke node read-only. Hal ini mengurangi beban pada node primary dan menjamin stabilitasnya. Untuk informasi lebih lanjut tentang perlindungan node primary, lihat Read/write splitting.
CatatanPengaturan ini hanya tersedia ketika mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting).
Transaction Splitting
Aktifkan atau nonaktifkan pemisahan transaksi. Untuk informasi lebih lanjut tentang pemisahan transaksi, lihat Transaction splitting.
CatatanPengaturan ini hanya tersedia ketika mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting).
Consistency Settings
Consistency Level
Jika mode baca/tulis adalah Read/Write (Automatic Read/Write Splitting), opsi yang tersedia adalah Eventual Consistency (Weak), Session Consistency (Medium), dan Global Consistency (Strong). Untuk informasi lebih lanjut, lihat Consistency level.
Jika mode baca/tulis adalah Read-only, tingkat konsistensi default-nya adalah Eventual Consistency (Weak). Pengaturan ini tidak dapat diubah.
CatatanPerubahan pada tingkat konsistensi berlaku langsung untuk semua koneksi.
Global Consistency (Strong) didukung untuk PolarDB for PostgreSQL dan PolarDB for PostgreSQL (compatible with Oracle 2.0). Versi mesin minor harus 2.0.14.11.22.0 atau lebih baru. Untuk informasi lebih lanjut tentang fitur ini, lihat Global consistency.
Global Consistency Timeout
Periode timeout bagi node read-only untuk menunggu sinkronisasi data guna memastikan konsistensi. Nilainya berkisar antara 1 hingga 1.000.000. Satuan: ms. Nilai default-nya adalah 100.
CatatanPengaturan ini hanya tersedia ketika Consistency Level diatur ke Global Consistency (Strong).
Global Consistency Timeout Policy
Kebijakan yang dieksekusi ketika node read-only mengalami timeout. Nilai yang valid adalah:
Send Requests to Primary Node (Default).
Return Error Messages Due to Timeout
Automatic Downgrade to Inconsistent Read Due to Timeout
CatatanPengaturan ini hanya tersedia ketika Consistency Level diatur ke Global Consistency (Strong).
Connection Pool Settings
Connection Pool
Anda dapat memilih Off (default) atau Transaction-level. Anda dapat menggunakan fitur pooling koneksi tingkat transaksi untuk mengurangi beban database akibat banyak koneksi. Untuk informasi lebih lanjut, lihat Transaction-level connection pooling.
Klik OK.
Modifikasi titik akhir kluster
Masuk ke PolarDB console. Di panel navigasi sebelah kiri, klik Clusters. Pilih region kluster tersebut lalu klik ID kluster untuk membuka halaman detail kluster.
Pada halaman Basic Information, arahkan ke bagian Database Connections. Temukan titik akhir kluster yang ingin Anda modifikasi lalu klik Configure.
Pada kotak dialog Modify Endpoint Settings, Anda dapat mengatur parameter terkait.
Klik OK.
Melepaskan titik akhir kluster kustom
Anda hanya dapat menghapus titik akhir kluster kustom. Titik akhir kluster default tidak dapat dihapus.
Setelah titik akhir kluster kustom dihapus, titik tersebut tidak dapat dipulihkan. Anda harus segera memperbarui titik akhir di client Anda.
Masuk ke PolarDB console. Di panel navigasi sebelah kiri, klik Clusters. Pilih region kluster tersebut lalu klik ID kluster untuk membuka halaman detail kluster.
Pada halaman Basic Information, arahkan ke bagian Database Connections. Temukan titik akhir kluster kustom yang ingin Anda hapus lalu klik Release.
Pada kotak dialog yang muncul, klik OK.
Operasi API terkait
API | Deskripsi |
Buat titik akhir kluster kustom. | |
Kueri titik akhir kluster. | |
Melepaskan titik akhir klaster kustom. |