All Products
Search
Document Center

PolarDB:Memulai Cepat

Last Updated:Jun 22, 2026

Topik ini menjelaskan cara memulai dengan cepat PolarDB for MySQL: membuat kluster, mengonfigurasi daftar putih, membuat akun database, dan menghubungkan ke kluster.

Tutorial

Jika Anda memiliki pertanyaan tentang langkah-langkah berikut, klik langkah tersebut untuk melihat instruksi lengkapnya.

1. Buat kluster

Buka halaman Quick Purchase PolarDB untuk membuat kluster PolarDB for MySQL dengan konfigurasi minimal. Atur parameter dalam tabel berikut dan gunakan nilai default untuk pengaturan lainnya. Untuk instruksi lengkap cara membuat kluster, lihat Buat kluster dengan konfigurasi kustom.

Parameter

Deskripsi

Billing Method

Pilih metode penagihan untuk kluster. Untuk informasi lebih lanjut, lihat Metode penagihan.

  • Subscription: Ini adalah model pembayaran di muka di mana Anda membayar sumber daya tetap saat membuat kluster. Langganan yang lebih lama memberikan diskon lebih besar. Model ini ideal untuk workload jangka panjang yang stabil.

  • pay-as-you-go: Ini adalah model pascabayar. Anda memilih sumber daya dengan spesifikasi tetap saat membuat kluster, tetapi tidak perlu membayar di muka. Tagihan dihitung berdasarkan penggunaan aktual. Model ini ideal untuk workload dengan permintaan fleksibel.

  • Serverless: Ini adalah model pay-as-you-go. Saat membuat kluster, Anda tidak perlu memilih sumber daya dengan spesifikasi tetap atau membayar kluster di muka. Model ini menyediakan kluster PolarDB dengan kemampuan skalabilitas elastis dinamis, sehingga secara otomatis menyesuaikan sumber daya berdasarkan perubahan workload bisnis. Model ini umumnya cocok untuk skenario dengan fluktuasi bisnis, workload tidak pasti, atau skenario bisnis yang tidak dapat diprediksi.

Region

Pilih wilayah tempat kluster ditempatkan.

Catatan

Kluster PolarDB dan Instance ECS yang ingin Anda hubungkan harus berada di wilayah yang sama agar dapat berkomunikasi melalui jaringan internal.

Database Engine

Pilih database engine untuk kluster.

  • MySQL 8.0.1

  • MySQL 8.0.2

Catatan

Quick Purchase hanya mendukung MySQL 8.0. Untuk membeli versi MySQL lainnya, klik tab Purchase di pojok kiri atas.

Service Edition

Pilih edisi database untuk kluster.

  • Enterprise Edition

  • Standard Edition

Catatan

Network Type

Konfigurasikan VPC dan vSwitch untuk kluster.

Catatan
  • Jika Anda memiliki VPC yang sudah ada dan memenuhi kebutuhan jaringan Anda, pilih VPC tersebut beserta vSwitch-nya. Misalnya, Anda dapat menggunakan VPC dari Instance ECS yang sudah ada.

  • Jika Anda tidak memiliki VPC yang sesuai, Anda dapat menggunakan VPC dan vSwitch default.

Deployment Mode (Opsional)

Pilih jumlah node dan mode ketersediaan tinggi untuk kluster. Untuk informasi lebih lanjut, lihat Mode ketersediaan tinggi (kluster hot standby).

  • Single-node: Hanya berisi satu node primer (node baca/tulis).

    • Number of Nodes: 1

    • High-availability mode: Single-AZ (hot standby cluster disabled)

  • Dual-node high-availability: Berisi satu node primer (node baca/tulis) dan satu node read-only.

    • Number of Nodes: 2

    • High-availability mode: Single-AZ (hot standby cluster disabled)

  • Cross-zone high-availability: Berisi satu node primer (node baca/tulis) dan satu node read-only. Data didistribusikan di beberapa zona ketersediaan. Zona ketersediaan primer dan sekunder masing-masing menyimpan salinan lengkap data.

    • Number of Nodes: 2

    • High-availability mode: Multi-AZ (hot standby cluster enabled)

Catatan

Opsi ini hanya tersedia untuk Subscription dan pay-as-you-go metode penagihan.

Node Specifications

Pilih jenis node komputasi untuk kluster berdasarkan kebutuhan aktual Anda. Jika Anda perlu membeli jenis lain, pilih tab Purchase di pojok kiri atas.

Storage Capacity (Opsional)

Konfigurasikan kapasitas penyimpanan kluster.

Catatan

Opsi ini wajib diisi hanya jika metode penagihan adalah Subscription atau pay-as-you-go dan edisi database adalah Standard Edition.

2. Konfigurasi daftar putih

Buka Konsol PolarDB. Pada daftar Clusters, klik ID kluster target untuk membuka halaman detailnya. Pilih Configuration and Management > Cluster Whitelists untuk menambahkan daftar putih alamat IP atau grup keamanan. Untuk informasi selengkapnya, lihat Mengonfigurasi daftar putih untuk kluster dan Mengonfigurasi grup keamanan.

Catatan
  • Jika Anda menggunakan Instance ECS untuk mengakses PolarDB, dan Instance ECS serta kluster PolarDB berada di VPC yang sama, Anda dapat menambahkan Blok CIDR VPC ke grup default.

  • Jika Anda menggunakan Instance ECS untuk mengakses PolarDB, tetapi Instance ECS dan kluster PolarDB tidak berada di VPC yang sama, Anda dapat menambahkan Alamat IP publik Instance ECS ke grup daftar putih IP baru atau menambahkan grup keamanan Instance ECS ke daftar putih kluster.

  • Jika Anda mengakses PolarDB dari lingkungan on-premises, tambahkan Alamat IP publik lingkungan on-premises Anda ke grup daftar putih IP baru.

    Untuk mengetahui Alamat IP publik lingkungan on-premises Anda, gunakan salah satu perintah berikut:

    • Untuk Linux: Buka terminal dan jalankan perintah curl ifconfig.me.

    • Untuk Windows: Buka Command Prompt dan jalankan perintah curl ip.me.

    • Untuk macOS: Buka terminal dan jalankan perintah curl ifconfig.me.

    Jika jaringan lokal Anda menggunakan proxy, alamat IP yang dikembalikan oleh perintah di atas mungkin bukan alamat IP publik sebenarnya Anda. Dalam kasus ini, Anda dapat menambahkan Blok CIDR 0.0.0.0/0 ke daftar putih kluster PolarDB. Setelah terhubung ke kluster, jalankan perintah SHOW PROCESSLIST; untuk mendapatkan alamat IP publik sebenarnya dan tambahkan ke daftar putih kluster. Kemudian, hapus Blok CIDR 0.0.0.0/0 dari daftar putih.

    xxx        | aurora                | 100.104.xxx.xxx:59236 | information_schema | Sleep   |            47 |          | NULL
    268459868  | polardb_mysql_account | 47.94.74.xxx:39160    | NULL               | Query   |             0 | starting | SHOW PROCESSLIST
  • Blok CIDR 0.0.0.0/0 mengizinkan akses dari alamat IP apa pun dan menimbulkan risiko keamanan signifikan. Tambahkan Blok CIDR ini hanya jika diperlukan.

3. Buat akun database

Buka Konsol PolarDB. Di daftar Clusters, klik ID kluster target untuk membuka halaman detailnya. Pilih Configuration and Management > Accounts untuk membuat akun database. Untuk informasi lebih lanjut, lihat Buat dan kelola akun database.

Catatan

Akun database dapat berupa Privileged Account atau Standard Account, masing-masing dengan hak istimewa berbeda. Buat jenis akun yang paling sesuai dengan kebutuhan Anda. Untuk informasi lebih lanjut, lihat Hak istimewa akun.

4. Dapatkan titik akhir kluster

Buka Konsol PolarDB. Di daftar Clusters, klik ID kluster target untuk membuka halaman detailnya. Pilih Database Connections untuk mendapatkan titik akhir kluster. Untuk informasi lebih lanjut, lihat Kelola titik akhir. Di halaman Database Connections, temukan bagian Cluster Endpoint (Recommended) dan klik Copy di sebelah titik akhir pribadi.

Catatan
  • Kami merekomendasikan menggunakan Cluster Endpoint. Port default adalah 3306.

  • Pilih titik akhir Internal Network atau Internet berdasarkan lingkungan akses Anda.

    • Jika Anda menggunakan ECS untuk mengakses PolarDB, dan ECS serta PolarDB berada di VPC yang sama, pilih Internal Network.

    • Jika Anda mengakses kluster PolarDB dari lingkungan on-premises, pilih Internet. Untuk mengajukan titik akhir publik, klik Application di sebelah kanan.

  • Titik akhir Internet menggunakan Internet. Untuk kinerja optimal, hindari mengakses kluster PolarDB Anda melalui Internet.

  • Anda tidak dapat menggunakan titik akhir Internal Network untuk menghubungkan host virtual atau server ringan ke kluster PolarDB.

5. Hubungkan ke kluster

Pilih metode koneksi yang sesuai dengan kebutuhan Anda:

Gunakan DMS untuk menghubungkan ke kluster

DMS adalah layanan manajemen data grafis dari Alibaba Cloud. Anda dapat langsung mengelola kluster PolarDB Anda di DMS tanpa perlu menginstal alat tambahan.

  1. Masuk ke Konsol PolarDB. Pada Cluster List, klik ID kluster target untuk membuka halaman detail kluster. Di sudut kanan atas halaman, klik Log on to Database.gambar

  2. Masukkan database account dan database password Anda untuk kluster PolarDB for MySQL, lalu klik Log on.image

  3. Setelah login, temukan kluster PolarDB for MySQL di daftar Logged-in Instances di panel navigasi kiri.image

Gunakan client untuk menghubungkan ke kluster

Anda dapat menggunakan client yang kompatibel dengan MySQL untuk menghubungkan ke kluster PolarDB. Contoh berikut menggunakan MySQL Workbench 8.0.29.

  1. Unduh dan instal MySQL Workbench.

  2. Buka MySQL Workbench dan pilih Database > Connect to Database.

  3. Masukkan informasi koneksi dan klik OK.

    Connection dialog

    Parameter

    Deskripsi

    Contoh

    Hostname

    Titik akhir database.

    pc-2***.rwlb.rds.aliyuncs.com

    Port

    Nomor port titik akhir database.

    Catatan

    Port default adalah 3306.

    3306

    Username

    Akun database.

    polardb_mysql_user

    Password

    Password akun database.

    Pass***233

Gunakan command line untuk menghubungkan ke kluster

Jika client MySQL telah diinstal di server Anda, jalankan perintah berikut untuk menghubungkan ke kluster PolarDB for MySQL.

Sintaks:

mysql -h<endpoint> -P<port> -u<database_username> -p<database_user_password>

Contoh:

mysql -h pc-2***.rwlb.rds.aliyuncs.com -P3306 -upolardb_mysql_user -pPass***233

Parameter

Deskripsi

Contoh

-h

Titik akhir database.

pc-2***.rwlb.rds.aliyuncs.com

-P

Nomor port titik akhir database.

Catatan
  • Port default adalah 3306.

  • Jika port adalah port default, Anda dapat menghilangkan parameter ini.

3306

-u

Akun database.

polardb_mysql_user

-p

Password akun database.

Catatan

Parameter ini wajib diisi.

  • Jika Anda menghilangkan parameter ini, Anda akan diminta memasukkan password setelah Enter password.

  • Jika Anda menyertakan parameter ini, jangan tambahkan spasi antara -p dan password.

Pass***233

Gunakan aplikasi untuk menghubungkan ke kluster

Menghubungkan ke kluster PolarDB for MySQL sama seperti menghubungkan ke database MySQL apa pun. Ganti endpoint, port, akun, dan password dengan nilai kluster PolarDB Anda. Contoh berdasarkan bahasa:

Java

Gunakan driver JDBC MySQL dalam proyek Maven untuk menghubungkan ke kluster PolarDB for MySQL.

  1. Tambahkan dependensi driver JDBC MySQL ke file pom.xml Anda:

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.27</version>
    </dependency>
  2. Hubungkan ke kluster. Ganti <HOST>, <USER>, <PASSWORD>, <DATABASE>, <YOUR_TABLE_NAME>, dan <YOUR_TABLE_COLUMN_NAME> dengan nilai aktual Anda.

    import java.sql.Connection;
    import java.sql.DriverManager;
    import java.sql.ResultSet;
    import java.sql.Statement;
    
    public class DatabaseConnection {
       public DatabaseConnection() {
       }
    
       public static void main(String[] args) {
          // The endpoint, port, and name of the database to connect to.
          String url = "jdbc:mysql://<HOST>:3306/<DATABASE>?useSSL=false&serverTimezone=UTC";
          // The database account.
          String user = "<USER>";
          // The password of the database account.
          String password = "<PASSWORD>";
    
          try {
             Class.forName("com.mysql.cj.jdbc.Driver");
             Connection conn = DriverManager.getConnection(url, user, password);
             Statement stmt = conn.createStatement();
             // The name of the data table to retrieve.
             ResultSet rs = stmt.executeQuery("SELECT * FROM `<YOUR_TABLE_NAME>`");
    
             while(rs.next()) {
                // The name of the column in the data table to retrieve.
                System.out.println(rs.getString("<YOUR_TABLE_COLUMN_NAME>"));
             }
    
             rs.close();
             stmt.close();
             conn.close();
          } catch (Exception var7) {
             var7.printStackTrace();
          }
    
       }
    }
Python

Gunakan library PyMySQL dengan Python 3 untuk menghubungkan ke kluster PolarDB for MySQL.

  1. Instal library PyMySQL:

    pip3 install PyMySQL
  2. Hubungkan ke kluster. Ganti <HOST>, <USER>, <PASSWORD>, <DATABASE>, dan <YOUR_TABLE_NAME> dengan nilai aktual Anda.

    import pymysql
    
    # Database connection parameters
    host = '<HOST>'  # The endpoint of the PolarDB cluster
    port = 3306  # The default port is 3306
    user = '<USER>'  # The database account
    password = '<PASSWORD>'  # The password of the database account
    database = '<DATABASE>'  # The name of the database to connect to
    
    try:
        # Create a database connection
        connection = pymysql.connect(
            host=host,
            port=port,
            user=user,
            passwd=password,
            db=database
        )
    
        # Get the cursor
        with connection.cursor() as cursor:
            # Execute an SQL query
            sql = "SELECT * FROM `<YOUR_TABLE_NAME>`"  # The name of the data table to retrieve
            cursor.execute(sql)
    
            # Get the query results
            results = cursor.fetchall()
            for row in results:
                print(row)
    
    finally:
        # Close the database connection
        if 'connection' in locals() and connection.open:
            connection.close()
    
Go

Gunakan paket database/sql dan driver go-sql-driver/mysql (Go 1.23.0) untuk menghubungkan ke kluster PolarDB for MySQL.

  1. Instal driver go-sql-driver/mysql:

    go get -u github.com/go-sql-driver/mysql
  2. Hubungkan ke kluster. Ganti <HOST>, <USER>, <PASSWORD>, <DATABASE>, dan <YOUR_TABLE_NAME> dengan nilai aktual Anda.

    package main
    
    import (
        "database/sql"
        "fmt"
        "log"
        _ "github.com/go-sql-driver/mysql"
    )
    
    func main() {
        // Database connection parameters
        dbHost := "<HOST>"       // The endpoint of the PolarDB cluster
        dbPort := "3306"         // The default port is 3306
        dbUser := "<USER>"       // The database account
        dbPass := "<PASSWORD>"   // The password of the database account
        dbName := "<DATABASE>"   // The name of the database to connect to
    
        // Build the Data Source Name (DSN)
        dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local", dbUser, dbPass, dbHost, dbPort, dbName)
    
        // Open a database connection
        db, err := sql.Open("mysql", dsn)
        if err != nil {
            log.Fatalf("Failed to connect to database: %v", err)
        }
        defer db.Close()
    
        // Test the connection
        err = db.Ping()
        if err != nil {
            log.Fatalf("Failed to ping database: %v", err)
        }
    
        // Create a cursor
        var result string
        err = db.QueryRow("SELECT VERSION()").Scan(&result)
        if err != nil {
            log.Fatalf("Failed to execute query: %v", err)
        }
    
        // Print the database version
        fmt.Printf("Connected to database, version: %s\n", result)
    
        // Execute an SQL query
        rows, err := db.Query("SELECT * FROM `<YOUR_TABLE_NAME>`") // The name of the data table to retrieve
        if err != nil {
            log.Fatalf("Failed to execute query: %v", err)
        }
        defer rows.Close()
    }

Manajemen kluster

Manajemen node

Spesifikasi kluster

Ketersediaan tinggi

Backup dan pemulihan

PolarProxy

Pemantauan dan optimasi

Manajemen versi

Manajemen log biner

FAQ

Koneksi ECS ke PolarDB gagal

Lakukan troubleshooting sebagai berikut:

  1. Periksa apakah kluster PolarDB berada dalam status running.

  2. Verifikasi bahwa titik akhir database, port, akun, dan password sudah benar. Dapatkan titik akhir dan port database.

  3. Uji konektivitas jaringan dari Instance ECS menggunakan ping <titik akhir database> atau telnet <titik akhir database> <port>.

    1. Jika Anda menggunakan titik akhir private network:

      1. Periksa apakah Instance ECS dan kluster PolarDB berada di VPC yang sama. Jika tidak berada di VPC yang sama, Anda tidak dapat menggunakan titik akhir private network. Gunakan salah satu solusi berikut untuk menempatkan Instance ECS dan kluster PolarDB dalam VPC yang sama:

      2. Periksa apakah Alamat IP pribadi, rentang alamat IP, atau grup keamanan Instance ECS telah ditambahkan ke daftar putih kluster.

    2. Jika Anda menggunakan titik akhir public network, periksa apakah Alamat IP publik atau grup keamanan Instance ECS telah ditambahkan ke daftar putih kluster.

Catatan

Host virtual dan server aplikasi sederhana tidak dapat menghubungkan ke PolarDB melalui titik akhir private network.

Koneksi on-premises ke PolarDB gagal

Lakukan troubleshooting sebagai berikut:

  1. Periksa apakah kluster PolarDB berada dalam status running.

  2. Verifikasi bahwa titik akhir database, port, akun, dan password sudah benar. Dapatkan titik akhir dan port database.

    Catatan

    Titik akhir database harus berupa titik akhir public network. Jika Anda menggunakan Instance ECS yang berada di VPC yang sama dengan kluster PolarDB, Anda dapat menggunakan titik akhir private network.

  3. Uji konektivitas jaringan dari lingkungan on-premises Anda menggunakan ping <titik akhir database> atau telnet <titik akhir database> <port>.

  4. Periksa apakah Alamat IP publik atau rentang alamat IP lingkungan on-premises Anda telah ditambahkan ke daftar putih kluster.

    Dapatkan Alamat IP publik Anda:

    • Sistem operasi Linux: Buka terminal dan jalankan perintah curl ifconfig.me.

    • Sistem operasi Windows: Buka command prompt dan jalankan perintah curl ip.me.

    • Sistem operasi macOS: Buka terminal dan jalankan perintah curl ifconfig.me.

    Jika lingkungan jaringan on-premises Anda menggunakan server proxy atau memiliki konfigurasi serupa lainnya, alamat IP yang diperoleh menggunakan metode di atas mungkin bukan alamat IP publik sebenarnya Anda. Anda dapat menambahkan rentang alamat IP 0.0.0.0/0 ke daftar putih kluster PolarDB. Setelah berhasil terhubung ke kluster, jalankan perintah SHOW PROCESSLIST; untuk mendapatkan alamat IP publik sebenarnya dan tambahkan ke daftar putih kluster. Kemudian, hapus rentang alamat IP 0.0.0.0/0 dari daftar putih.

    image

Tidak dapat menghubungkan ke kluster PolarDB dengan error "Access denied for user 'xxx'@'xxx' (using password: YES)"

Akun database atau kata sandi salah. Buka Konsol PolarDB dan verifikasi atau atur ulang kredensial di halaman Configurations and Management > Account Management.

Tidak dapat menghubungkan ke kluster PolarDB dengan error "Unknown MySQL server host 'xxx'"

Titik akhir database salah. Format yang benar adalah pc-xxxxxx.rwlb.rds.aliyuncs.com. Buka Konsol PolarDB, lalu verifikasi titik akhir pada bagian Basic Information > Database Connection.

Tidak dapat menghubungkan ke kluster PolarDB dengan error "Can't connect to MySQL server on 'xxx'" atau "Connection timed out"

Alamat IP publik atau rentang alamat IP lingkungan Anda kemungkinan tidak ada dalam daftar putih kluster PolarDB, atau alamat IP yang Anda masukkan salah.

Dapatkan Alamat IP publik Anda:

  • Sistem operasi Linux: Buka terminal dan jalankan perintah curl ifconfig.me.

  • Sistem operasi Windows: Buka command prompt dan jalankan perintah curl ip.me.

  • Sistem operasi macOS: Buka terminal dan jalankan perintah curl ifconfig.me.

Jika lingkungan jaringan on-premises Anda menggunakan server proxy atau memiliki konfigurasi serupa lainnya, alamat IP yang diperoleh menggunakan metode di atas mungkin bukan alamat IP publik sebenarnya Anda. Anda dapat menambahkan rentang alamat IP 0.0.0.0/0 ke daftar putih kluster PolarDB. Setelah berhasil terhubung ke kluster, jalankan perintah SHOW PROCESSLIST; untuk mendapatkan alamat IP publik sebenarnya dan tambahkan ke daftar putih kluster. Kemudian, hapus rentang alamat IP 0.0.0.0/0 dari daftar putih.

image