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.
|
|
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.
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.
Catatan
|
|
Network Type |
Konfigurasikan VPC dan vSwitch untuk kluster. Catatan
|
|
Deployment Mode (Opsional) |
Pilih jumlah node dan mode ketersediaan tinggi untuk kluster. Untuk informasi lebih lanjut, lihat Mode ketersediaan tinggi (kluster hot standby).
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.
-
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/0ke daftar putih kluster PolarDB. Setelah terhubung ke kluster, jalankan perintahSHOW PROCESSLIST;untuk mendapatkan alamat IP publik sebenarnya dan tambahkan ke daftar putih kluster. Kemudian, hapus Blok CIDR0.0.0.0/0dari 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/0mengizinkan 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.
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.
-
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.
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.

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

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

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.
Unduh dan instal MySQL Workbench.
Buka MySQL Workbench dan pilih Database > Connect to Database.
Masukkan informasi koneksi dan klik OK.

Parameter
Deskripsi
Contoh
Hostname
pc-2***.rwlb.rds.aliyuncs.com
Port
Nomor port titik akhir database.
CatatanPort default adalah 3306.
3306
Username
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***233Parameter | Deskripsi | Contoh |
-h | pc-2***.rwlb.rds.aliyuncs.com | |
-P | Nomor port titik akhir database. Catatan
| 3306 |
-u | polardb_mysql_user | |
-p | Password akun database. Catatan Parameter ini wajib diisi.
| 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.
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>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.
Instal library PyMySQL:
pip3 install PyMySQLHubungkan 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.
Instal driver
go-sql-driver/mysql:go get -u github.com/go-sql-driver/mysqlHubungkan 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:
Periksa apakah kluster PolarDB berada dalam status running.
Verifikasi bahwa titik akhir database, port, akun, dan password sudah benar. Dapatkan titik akhir dan port database.
Uji konektivitas jaringan dari Instance ECS menggunakan
ping <titik akhir database>atautelnet <titik akhir database> <port>.Jika Anda menggunakan titik akhir private network:
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:
Alihkan VPC Instance ECS.
Jika kluster Anda merupakan Edisi Kluster kluster, Anda dapat mengalihkan VPC kluster.
Gunakan Cloud Enterprise Network (CEN) untuk mengaktifkan komunikasi antar-VPC dalam wilayah yang sama.
Periksa apakah Alamat IP pribadi, rentang alamat IP, atau grup keamanan Instance ECS telah ditambahkan ke daftar putih kluster.
Jika Anda menggunakan titik akhir public network, periksa apakah Alamat IP publik atau grup keamanan Instance ECS telah ditambahkan ke daftar putih kluster.
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:
Periksa apakah kluster PolarDB berada dalam status running.
Verifikasi bahwa titik akhir database, port, akun, dan password sudah benar. Dapatkan titik akhir dan port database.
CatatanTitik 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.
Uji konektivitas jaringan dari lingkungan on-premises Anda menggunakan
ping <titik akhir database>atautelnet <titik akhir database> <port>.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/0ke daftar putih kluster PolarDB. Setelah berhasil terhubung ke kluster, jalankan perintahSHOW PROCESSLIST;untuk mendapatkan alamat IP publik sebenarnya dan tambahkan ke daftar putih kluster. Kemudian, hapus rentang alamat IP0.0.0.0/0dari daftar putih.
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.
