Untuk terkoneksi ke GDN, hubungkan aplikasi Anda ke titik akhir kluster terdekat berdasarkan wilayahnya. GDN secara otomatis melakukan pemisahan baca/tulis: permintaan baca biasanya diarahkan ke kluster lokal, sedangkan permintaan tulis diteruskan ke kluster utama.
Perutean permintaan
Konfigurasi database proxy setiap kluster menentukan perutean permintaan. Tidak diperlukan perubahan pada aplikasi—cukup terhubung ke titik akhir kluster, dan permintaan akan diarahkan secara otomatis:
-
Permintaan tulis (
INSERT,UPDATE,DELETE) dan permintaan dalam transaksi diarahkan ke node utama kluster utama. -
Permintaan baca secara default diarahkan ke node read-only kluster sekunder lokal. Dengan session consistency diaktifkan, beberapa permintaan baca mungkin diarahkan ke node utama kluster utama.
-
Hanya titik akhir kluster atau titik akhir kustom dengan Read-write mode yang diatur ke Read/Write (Automatic Read/Write Splitting) yang mendukung pemisahan baca/tulis GDN.
-
Primary address dan titik akhir kustom dengan Read-write mode yang diatur ke Read-only tidak mendukung pemisahan baca/tulis GDN.
-
Untuk memitigasi potensi dampak latensi replikasi antara kluster utama dan sekunder terhadap bisnis Anda, kami merekomendasikan agar saat mengonfigurasi titik akhir kluster kustom pada kluster sekunder, Anda mengatur Primary Node Accepts Read Requests ke No dan mengatur Consistency Level ke Eventual Consistency (Weak).
Lihat titik akhir kluster
-
Login ke Konsol PolarDB. Di panel navigasi sebelah kiri, klik Global Database Network (GDN).
-
Pada halaman Global Database Network (GDN), temukan GDN target dan klik Global Database Network ID-nya untuk membuka halaman detail.
-
Di bagian Clusters, temukan kluster sekunder target dan klik View di kolom Cluster Endpoint untuk melihat detail titik akhir kluster di kotak dialog yang muncul.
Catatan-
Anda hanya dapat melihat informasi titik akhir untuk kluster default, termasuk titik akhir Internal Network dan Internet.
-
Untuk melihat detail lebih banyak titik akhir, klik Visit the Overview page of the cluster. Anda akan diarahkan ke halaman detail kluster, tempat Anda dapat menemukan lebih banyak titik akhir di bagian Database Connections.
-
Terkoneksi ke kluster GDN
Anda dapat terkoneksi ke kluster database menggunakan berbagai metode. Bagian berikut menyediakan contoh:
Gunakan DMS untuk terkoneksi ke kluster
Data Management (DMS) menyediakan administrasi database, audit keamanan, dan optimasi performa. Kelola kluster PolarDB Anda langsung di DMS.
-
Login ke Konsol PolarDB. Di daftar kluster, klik ID kluster untuk membuka halaman Basic Information. Di pojok kanan atas, klik Log On To Database.

-
Di kotak dialog, masukkan akun database dan kata sandi, lalu klik Login.

-
Setelah login, pilih di panel navigasi sebelah kiri untuk mengelola kluster .

Gunakan client untuk terkoneksi ke kluster
Prosedur ini menggunakan pgAdmin 4 v9.0 untuk terkoneksi ke kluster PolarDB.
-
Unduh dan instal client pgAdmin 4.
-
Buka client pgAdmin 4, klik kanan Servers, lalu pilih .

-
Di tab General, atur nama koneksi. Di tab Connection, konfigurasikan parameter koneksi, lalu klik Save.


Parameter
Deskripsi
Host name/address
Titik akhir dan port kluster PolarDB.
-
Untuk mengakses kluster PolarDB dari Instance ECS, dan Instance ECS berada dalam VPC yang sama dengan kluster PolarDB, tentukan titik akhir Private dan port.
-
Untuk mengakses kluster PolarDB dari lingkungan on-premises Anda, tentukan titik akhir Public dan port.
-
Nomor port default adalah 5432.
Port
Username
Akun database dan password kluster PolarDB.
Password
-
-
Koneksi berhasil akan menampilkan halaman berikut.
Catatanpostgresadalah database sistem default. Jangan lakukan operasi apa pun pada database ini.
Gunakan psql untuk terkoneksi ke kluster
Unduh psql dari PostgreSQL Downloads untuk terkoneksi ke kluster PolarDB. Anda juga dapat menggunakan psql di PolarDB-Tools untuk terkoneksi ke kluster PolarDB.
-
Metode koneksi sama untuk Windows dan Linux.
-
Dokumentasi resmi psql mencakup penggunaan detail.
Sintaks
psql -h <host> -p <port> -U <username> -d <dbname>
|
Parameter |
Deskripsi |
|
|
Titik akhir kluster dan port kluster PolarDB.
|
|
|
|
|
|
Akun database kluster PolarDB. |
|
|
Contoh
psql -h pc-xxx.rwlb.rds.aliyuncs.com -p 5432 -U testusername -d postgres
Terkoneksi ke kluster dalam bahasa pemrograman
Terkoneksi ke kluster PolarDB for PostgreSQL mirip dengan terkoneksi ke database PostgreSQL biasa — cukup perbarui titik akhir, port, akun, dan kata sandi.
Java
Terkoneksi ke kluster PolarDB for PostgreSQL menggunakan driver JDBC PostgreSQL dalam proyek Java berbasis Maven.
-
Tambahkan dependensi driver JDBC PostgreSQL ke file pom.xml Anda. Contoh kode:
<dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <version>42.2.18</version> </dependency> -
Terkoneksi ke kluster. Ganti placeholder
<HOST>,<PORT>,<USER>,<PASSWORD>,<DATABASE>,<YOUR_TABLE_NAME>, dan<YOUR_TABLE_COLUMN_NAME>dengan parameter koneksi kluster aktual.import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.Statement; public class PolarDBConnection { public static void main(String[] args) { // URL, username, dan password database. String url = "jdbc:postgresql://<HOST>:<PORT>/<DATABASE>"; String user = "<USER>"; String password = "<PASSWORD>"; try { // Muat driver JDBC PostgreSQL. Class.forName("org.postgresql.Driver"); // Bangun koneksi. Connection conn = DriverManager.getConnection(url, user, password); // Buat objek Statement. Statement stmt = conn.createStatement(); // Jalankan kueri SQL. ResultSet rs = stmt.executeQuery("SELECT * FROM <YOUR_TABLE_NAME>"); // Proses set hasil. while (rs.next()) { System.out.println(rs.getString("<YOUR_TABLE_COLUMN_NAME>")); } // Tutup sumber daya. rs.close(); stmt.close(); conn.close(); } catch (Exception e) { e.printStackTrace(); } } }
Python
Terkoneksi ke kluster PolarDB for PostgreSQL menggunakan library psycopg2 dalam Python 3.
-
Instal library psycopg2.
pip3 install psycopg2-binary -
Terkoneksi ke kluster. Ganti placeholder
<HOST>,<PORT>,<USER>,<PASSWORD>,<DATABASE>, dan<YOUR_TABLE_NAME>dengan parameter koneksi kluster aktual.import psycopg2 try: # Parameter koneksi conn = psycopg2.connect( host="<HOST>", # Titik akhir kluster. database="<DATABASE>", # Nama database. user="<USER>", # Username. password="<PASSWORD>", # Password. port="<PORT>" # Nomor port. ) # Buat objek cursor. cursor = conn.cursor() # Jalankan kueri. cursor.execute("SELECT * FROM <YOUR_TABLE_NAME>") # Ambil semua hasil. records = cursor.fetchall() for record in records: print(record) except Exception as e: print("Error:", e) finally: # Tutup koneksi. if 'cursor' in locals(): cursor.close() if 'conn' in locals(): conn.close()
Go
Terkoneksi ke kluster PolarDB for PostgreSQL menggunakan paket database/sql dan driver lib/pq dalam Go 1.23.0.
-
Instal driver
lib/pq.go get -u github.com/lib/pq -
Terkoneksi ke kluster. Ganti placeholder
<HOST>,<PORT>,<USER>,<PASSWORD>,<DATABASE>, dan<YOUR_TABLE_NAME>dengan parameter koneksi kluster aktual.package main import ( "database/sql" "fmt" "log" _ "github.com/lib/pq" // Inisialisasi driver PostgreSQL. ) func main() { // Format string koneksi. connStr := "user=<USER> password=<PASSWORD> dbname=<DATABASE> host=<HOST> port=<PORT> sslmode=disable" // Buka koneksi database. db, err := sql.Open("postgres", connStr) if err != nil { log.Fatal(err) } defer db.Close() // Tutup koneksi saat program keluar. // Uji koneksi. err = db.Ping() if err != nil { log.Fatal(err) } fmt.Println("Connected to PostgreSQL!") // Jalankan kueri. rows, err := db.Query("SELECT * FROM <YOUR_TABLE_NAME>") if err != nil { log.Fatal(err) } defer rows.Close() }
API Terkait
|
API |
Deskripsi |
|
Mengkueri informasi titik akhir koneksi kluster PolarDB. |
|
|
Memodifikasi properti titik akhir kluster PolarDB, seperti mode baca/tulis, penambahan node otomatis, tingkat konsistensi, transaction splitting, apakah node utama menerima permintaan baca, dan pooling koneksi. |