All Products
Search
Document Center

PolarDB:Terkoneksi ke jaringan basis data global

Last Updated:Aug 28, 2026

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.

Klik untuk melihat logika penerusan detail

Target Node

Permintaan yang diteruskan

Dikirim hanya ke node utama kluster utama

  • Operasi DML (seperti INSERT, UPDATE, dan DELETE)

  • Operasi DDL (seperti membuat atau menghapus tabel atau database, atau mengubah skema tabel)

  • Perintah SHOW

  • Perintah terkait transaksi seperti BEGIN dan COMMIT

  • Perintah LISTEN, UNLISTEN, dan NOTIFY

  • Perintah ANALYZE

  • Perintah protokol commit dua fase

  • Permintaan dalam transaksi (perilaku dapat bervariasi berdasarkan konfigurasi transaction splitting)

  • Definisi dan pemanggilan fungsi (perilaku dapat bervariasi berdasarkan konfigurasi aturan routing user-defined function)

  • Permintaan yang menggunakan tabel temporary

  • Multi Statements multi-pernyataan

  • Pernyataan PREPARE yang berisi permintaan tulis

Dikirim ke node read-only atau node utama

  • Permintaan baca di luar transaksi

  • Perintah EXPLAIN

  • Pernyataan PREPARE yang berisi permintaan baca

Selalu dikirim ke semua node

  • Perintah USE

  • Perintah DISCARD dan DEALLOCATE

Catatan
  • 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

  1. Login ke Konsol PolarDB. Di panel navigasi sebelah kiri, klik Global Database Network (GDN).

  2. Pada halaman Global Database Network (GDN), temukan GDN target dan klik Global Database Network ID-nya untuk membuka halaman detail.

  3. 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.

  1. Login ke Konsol PolarDB. Di daftar kluster, klik ID kluster untuk membuka halaman Basic Information. Di pojok kanan atas, klik Log On To Database.image

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

  3. Setelah login, pilih Database Instances > Instances Connected di panel navigasi sebelah kiri untuk mengelola kluster .image

Gunakan client untuk terkoneksi ke kluster

Prosedur ini menggunakan pgAdmin 4 v9.0 untuk terkoneksi ke kluster PolarDB.

  1. Unduh dan instal client pgAdmin 4.

  2. Buka client pgAdmin 4, klik kanan Servers, lalu pilih Register > Server....image

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

    image

    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

  4. Koneksi berhasil akan menampilkan halaman berikut.image

    Catatan

    postgres adalah 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.

Catatan
  • 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

host

Titik akhir kluster 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 kluster PolarDB.

dbname

Nama database.

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.

  1. 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>
  2. 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.

  1. Instal library psycopg2.

    pip3 install psycopg2-binary
  2. 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.

  1. Instal driver lib/pq.

    go get -u github.com/lib/pq
  2. 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

DescribeDBClusterEndpoints

Mengkueri informasi titik akhir koneksi kluster PolarDB.

ModifyDBClusterEndpoint

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.