All Products
Search
Document Center

ApsaraDB RDS:Menghubungkan ke instans PostgreSQL

Last Updated:May 19, 2026

Setelah membuat instans ApsaraDB RDS for PostgreSQL dan menyelesaikan konfigurasi yang diperlukan—seperti membuat akun dan mengatur daftar putih IP—Anda dapat menghubungkan ke instans tersebut. Topik ini menjelaskan cara menghubungkan menggunakan Data Management (DMS), klien pgAdmin, CLI PostgreSQL, atau aplikasi.

Prasyarat

  • Buat instans ApsaraDB RDS for PostgreSQL. Untuk informasi selengkapnya, lihat Buat instans ApsaraDB RDS for PostgreSQL.

  • Buat akun dan database. Untuk informasi selengkapnya, lihat Buat akun dan database.

  • Konfigurasikan daftar putih IP untuk mengizinkan akses dari instance ECS atau perangkat lokal Anda. Untuk informasi selengkapnya, lihat Konfigurasikan daftar putih IP.

    • Jika menghubungkan dari instance ECS melalui jaringan pribadi, instance ECS dan RDS harus berada dalam wilayah, akun Alibaba Cloud, dan VPC yang sama. Tambahkan alamat IP pribadi instance ECS ke daftar putih IP.

    • Jika menghubungkan dari perangkat lokal, tambahkan alamat IP publik perangkat tersebut ke daftar putih IP.

Prosedur

Data Management (DMS)

Data Management (DMS) adalah layanan manajemen data terpadu yang mengintegrasikan manajemen data, manajemen skema, otorisasi pengguna, audit keamanan, tren data, pelacakan data, grafik BI, optimasi kinerja, dan manajemen server. Untuk informasi selengkapnya tentang DMS, lihat Apa itu Data Management (DMS)?

  1. Masuk ke Konsol ApsaraDB RDS dan buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans RDS berada, lalu temukan instans RDS dan klik ID instans tersebut.

  2. Pada halaman Basic Information, klik Log On to Database.SQLQuery

  3. Pada halaman Log on to database instance di DMS, pilih Access Method dan Control Mode.

    Parameter

    Deskripsi

    Access Method

    Metode untuk mengakses instans ApsaraDB RDS menggunakan DMS. Topik ini menggunakan contoh Account + Password Login.

    • Account + Password Login: Login dengan username dan password akun database yang memiliki izin untuk database target.

    • Log on with KMS credential: DMS secara otomatis mengaktifkan secure hosting untuk instans tersebut. Anda harus memilih secara manual kredensial RDS yang dibuat di KMS untuk login.

    Catatan
    • Saat menggunakan metode akses Log on with KMS credential, DMS secara otomatis mengaktifkan secure hosting untuk instans tanpa biaya tambahan.

    • Anda juga dapat mengklik One-click enable secure hosting, memasukkan akun dan password, lalu mengaktifkan secure hosting untuk instans secara gratis. Hal ini memungkinkan login yang aman, terkontrol, dan tanpa password.

    Control Mode

    DMS menyediakan tiga control mode tingkat instans. Anda dapat memilih salah satu sesuai skenario bisnis Anda.

    • Flexible Management

    • Stable Change

    • Security Collaboration

  4. Setelah login dan merefresh halaman, instans serta database-nya akan muncul di panel Instances Connected di sebelah kiri.

    Catatan

    Jika Anda mengaktifkan secure hosting, instans yang telah login beserta database-nya akan muncul di panel Password-free instances di sebelah kiri.

    image

    • Di Konsol DMS, Anda hanya dapat beralih antar database dengan mengklik ganda database target. Perintah USE tidak didukung.

    • Jika instans tersedia tetapi Anda tidak menemukan database target setelah membukanya, kemungkinan penyebabnya adalah sebagai berikut:

      • Akun login tidak memiliki izin akses ke database target. Login menggunakan akun yang memiliki izin yang diperlukan.

      • Katalog tidak ditampilkan karena metadata belum disinkronkan. Untuk mengatasinya, arahkan kursor ke nama instans dan klik ikon image di sebelah kanannya. Hal ini akan merefresh daftar database dan menampilkan database target.

      Untuk menyinkronkan skema database dan tabel secara cepat, Anda dapat menggunakan fitur inisialisasi database kosong di DMS.

Catatan
  • Selain login ke DMS dari Konsol ApsaraDB RDS, Anda juga dapat login langsung ke Konsol DMS dan menambahkan instans ApsaraDB RDS Anda secara langsung sehingga dapat login ke database dengan cepat dari Konsol DMS. Untuk informasi selengkapnya, lihat Daftarkan instans database cloud.

  • Jika Anda mengatur ulang kata sandi akun, Anda harus login ke DMS lagi.

Klien pgAdmin

Klien pgAdmin adalah alat resmi yang direkomendasikan untuk menghubungkan ke database PostgreSQL. Bagian ini menggunakan contoh pgAdmin 4 v6.2.0 untuk menunjukkan cara menghubungkan ke instans ApsaraDB RDS for PostgreSQL. Saat Anda mengunduh dan menginstal PostgreSQL dari website resmi PostgreSQL, klien pgAdmin 4 akan terinstal secara otomatis.

Jika tidak ingin menginstal PostgreSQL, Anda dapat mengunduh klien pgAdmin versi standalone hanya untuk koneksi jarak jauh.

  1. Jalankan klien pgAdmin 4.

    Catatan

    Saat pertama kali login ke versi terbaru klien ini, Anda harus menetapkan Master Password untuk melindungi kata sandi dan kredensial lain yang tersimpan.

  2. Klik kanan Servers dan pilih Register > Server....

  3. Pada tab General, tetapkan nama untuk koneksi tersebut.

  4. Klik tab Connection dan masukkan informasi koneksi untuk instans Anda.

    Parameter

    Deskripsi

    Host name/address

    Titik akhir dan port instans ApsaraDB RDS for PostgreSQL.

    • Untuk menghubungkan melalui jaringan pribadi, masukkan titik akhir internal dan port instans.

    • Untuk menghubungkan melalui internet, masukkan titik akhir publik dan port instans.

    Anda dapat melihat informasi ini pada halaman Database Connection instans ApsaraDB RDS for PostgreSQL Anda.

    Untuk informasi selengkapnya, lihat Lihat dan ubah titik akhir serta port.

    Port

    Username

    Username dan password akun instans ApsaraDB RDS for PostgreSQL Anda.

    Untuk informasi cara membuat akun, lihat Buat akun dan database.

    Password

  5. Klik Save.

    Jika informasi koneksi benar, server berhasil ditambahkan.

    Penting

    Database postgres adalah database sistem default untuk instans ApsaraDB RDS. Jangan melakukan operasi apa pun di database ini.

CLI PostgreSQL

Saat Anda menginstal PostgreSQL dari website resmi PostgreSQL, CLI PostgreSQL juga akan terinstal.

Di terminal command-line, jalankan perintah berikut untuk menghubungkan ke database ApsaraDB RDS for PostgreSQL Anda.

psql -h <endpoint> -U <username> -p <port> [-d <database_name>]

psqlLog on

Parameter

Deskripsi

Endpoint

Titik akhir dan port instans ApsaraDB RDS for PostgreSQL.

  • Untuk menghubungkan melalui jaringan pribadi, masukkan titik akhir internal dan port instans.

  • Untuk menghubungkan melalui internet, masukkan titik akhir publik dan port instans.

Anda dapat melihat informasi ini pada halaman Database Connection instans ApsaraDB RDS for PostgreSQL Anda.

Untuk informasi selengkapnya, lihat Lihat dan ubah titik akhir serta port.

Port Number

Username

Akun untuk instans ApsaraDB RDS for PostgreSQL Anda.

Untuk informasi cara membuat akun, lihat Buat akun dan database.

Database Name

Opsional. Nama database yang akan dihubungkan. Database postgres adalah database sistem default untuk instans ApsaraDB RDS for PostgreSQL. Jangan melakukan operasi apa pun di database ini. Kami menyarankan Anda menentukan database lain yang telah Anda buat di instans tersebut.

Untuk informasi cara membuat dan melihat database, lihat Buat database.

Aplikasi

Catatan

Bagian ini memberikan contoh cara menghubungkan ke instans ApsaraDB RDS for PostgreSQL dari proyek Maven menggunakan JDBC. Proses koneksi serupa untuk bahasa pemrograman lainnya.

  1. Tambahkan dependensi ke file pom.xml.

    <dependency>
      <groupId>postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <version>8.2-504.jdbc3</version>
    </dependency>
  2. Kode berikut memberikan contoh cara menghubungkan ke instans:

    public class DatabaseConnection
    {
        public static void main( String[] args ){
            try {
                Class.forName("org.postgresql.Driver");
            } catch (ClassNotFoundException e) {
                e.printStackTrace();
            }
            // Titik akhir instans.
            String hostname = "pgm-bp1i3kkq7321o9****.pg.rds.aliyuncs.com";
            // Port instans.
            int port = 5432;
            // Nama database.
            String dbname = "postgres";
            // Username.
            String username = "username";
            // Password.
            String password = "password";
    
            String dbUrl = "jdbc:postgresql://" + hostname + ":" + port + "/" + dbname + "?binaryTransfer=true";
            Connection dbConnection;
            try {
                dbConnection = DriverManager.getConnection(dbUrl, username, password);
                Statement statement = dbConnection.createStatement();
                // Masukkan pernyataan SQL yang akan dieksekusi.
                String selectSql = "SELECT * FROM information_schema.sql_features LIMIT 10";
                ResultSet resultSet = statement.executeQuery(selectSql);
                while (resultSet.next()) {
                    System.out.println(resultSet.getString("feature_name"));
                }
            } catch (SQLException e) {
                e.printStackTrace();
            }
        }
    }

Tool BI pihak ketiga

ApsaraDB RDS for PostgreSQL mendukung koneksi dari tool business intelligence (BI) pihak ketiga. Anda dapat menggunakan tool ini untuk mendapatkan, membersihkan, memodelkan, dan memvisualisasikan data untuk analisis. Bagian ini menunjukkan cara menghubungkan ke instans ApsaraDB RDS for PostgreSQL menggunakan Microsoft Power BI sebagai contoh. Versi klien yang digunakan adalah Power BI 2.112.1161.0 64-bit.

  1. Unduh dan instal klien Power BI Desktop. Untuk informasi selengkapnya, lihat Dapatkan Power BI Desktop.

  2. Jalankan klien Power BI Desktop.

  3. Pada tab Homepage di bilah menu atas, klik Get data > More....Get data

  4. Pada kotak dialog Get Data, pilih Database > PostgreSQL, lalu klik Connection.PostgreSQLDatabase

  5. Pada kotak dialog PostgreSQL, tentukan Server dan Database, lalu klik Yes.Connection address

    Parameter

    Deskripsi

    Server

    Titik akhir dan port instans ApsaraDB RDS for PostgreSQL.

    Format: endpoint:port

    • Untuk menghubungkan melalui jaringan pribadi, masukkan titik akhir internal dan port instans.

    • Untuk menghubungkan melalui internet, masukkan titik akhir publik dan port instans.

    Anda dapat melihat informasi ini pada halaman Database Connection instans ApsaraDB RDS for PostgreSQL Anda.

    Untuk informasi selengkapnya, lihat Lihat dan ubah titik akhir serta port.

    Database

    Database postgres adalah database sistem default untuk instans ApsaraDB RDS for PostgreSQL. Jangan melakukan operasi apa pun di database ini. Kami menyarankan Anda menentukan database lain yang telah Anda buat di instans tersebut.

    Untuk informasi cara membuat dan melihat database, lihat Buat database.

  6. Tentukan Username dan Password, lalu klik Connection.Connect

    Catatan

    Untuk informasi cara membuat akun, lihat Buat akun dan database.

  7. Pada kotak dialog Encryption Support, klik Yes.Encryption Support

  8. Setelah koneksi berhasil, Anda dapat melihat informasi tabel di database dari jendela Navigator. Pilih tabel target, lalu pilih Load atau Transform Data sesuai kebutuhan bisnis Anda.Load or Transform Data

Enkripsi SSL

ApsaraDB RDS for PostgreSQL mendukung enkripsi SSL untuk melindungi data saat transit. Untuk detail konfigurasi spesifik, lihat Menghubungkan ke instans ApsaraDB RDS for PostgreSQL melalui koneksi terenkripsi SSL.

FAQ

  • Q: Bagaimana cara menghubungkan ke instans ApsaraDB RDS jika instance ECS dan ApsaraDB RDS saya berada di wilayah berbeda atau akun berbeda?

    A: Anda dapat menggunakan salah satu dari dua metode berikut:

  • Q: Bagaimana cara menghubungkan ke ApsaraDB RDS dari Function Compute untuk mengambil data?

    A: Anda dapat menginstal dependensi pihak ketiga untuk fungsi Anda dan menggunakan modul bawaan untuk mengambil data dari ApsaraDB RDS. Untuk informasi selengkapnya, lihat Instal dependensi pihak ketiga untuk fungsi.