Anda dapat terhubung ke instans PolarDB-X menggunakan Data Management (DMS), MySQL CLI, klien pihak ketiga yang kompatibel dengan MySQL, atau kode aplikasi Anda.
Prasyarat
Sebelum terhubung ke database PolarDB-X, lengkapi langkah-langkah berikut:
Terhubung ke database
Anda dapat terhubung ke instans database dengan beberapa cara, tergantung pada beban kerja Anda. Bagian berikut menunjukkan contoh umum.
DMS
Data Management (DMS) adalah tool manajemen data grafis yang disediakan oleh Alibaba Cloud. Tool ini mengintegrasikan serangkaian layanan, termasuk manajemen data, manajemen skema, otorisasi pengguna, audit keamanan, tren data, pelacakan data, grafik BI, optimasi performa, dan manajemen server. Anda dapat menggunakan DMS untuk mengelola instans PolarDB-X secara langsung tanpa memerlukan tool lain.
-
Buka Konsol PolarDB for Distributed. Pada daftar Instances, klik ID instans target untuk membuka halaman detailnya. Di pojok kanan atas halaman, klik Log On to Database.
-
Pada kotak dialog, masukkan Database Account dan Database Password untuk instans PolarDB-X, lalu klik Search.
Catatan-
Pertama kali login menggunakan DMS, mode kontrol secara default adalah Flexible Management. Setelah login, Anda dapat mengubah mode kontrol dengan mengedit instans. Untuk informasi selengkapnya, lihat Edit instance information dan Control modes.
-
Setelah mengonfigurasi parameter login, Anda dapat mengklik Test Connectivity di pojok kiri bawah. Jika koneksi gagal, tinjau pesan error dan periksa informasi yang Anda masukkan, seperti akun atau kata sandi.
-
Sistem secara otomatis mencoba menambahkan alamat IP server DMS ke daftar putih instans PolarDB-X. Jika upaya ini gagal, Anda harus menambahkan alamat IP tersebut secara manual.
-
-
Setelah login, instans PolarDB-X akan muncul di bagian Connected Instances pada panel navigasi kiri. Anda kemudian dapat mengelola instans tersebut.
GUI client
PolarDB-X mendukung koneksi dari klien pihak ketiga berikut. Anda dapat mengunduh klien ini dari situs web resminya.
-
MySQL Workbench (Direkomendasikan)
-
SQLyog
-
Sequel Pro
-
Navicat for MySQL
Klien GUI pihak ketiga mendukung operasi database dasar, termasuk CRUD dan DDL. Fitur lanjutan yang spesifik klien mungkin tidak didukung oleh PolarDB-X.
Langkah-langkah berikut menggunakan MySQL Workbench 8.0.29 sebagai contoh. Klien lain mengikuti prosedur serupa.
-
Instal MySQL Workbench. Untuk tautan unduhan resmi, lihat halaman unduhan MySQL Workbench.
-
Buka MySQL Workbench dan pilih .
-
Masukkan informasi koneksi dan klik OK.
Parameter
Deskripsi
Contoh
Hostname
pxc-xxx.polarx.rds.aliyuncs.com
Port
Nomor port yang sesuai dengan titik akhir database.
CatatanPort default adalah 3306.
3306
Username
polardb_x_user
Password
Kata sandi untuk akun database.
Pass***233
MySQL CLI
Jika klien MySQL telah diinstal pada server Anda, Anda dapat menggunakan command line untuk terhubung ke instans PolarDB-X.
Sintaks:
mysql -h<endpoint> -P<port> -u<database_username> -p<database_password> -D<database_name>
Contoh:
mysql -hpxc-xxx.polarx.rds.aliyuncs.com -P3306 -upolardb_mysql_user -pPass***233 -Dtest_db
|
Parameter |
Deskripsi |
Contoh |
|
-h |
pxc-xxx.polarx.rds.aliyuncs.com |
|
|
-P |
Nomor port yang sesuai dengan titik akhir database. Catatan
|
3306 |
|
-u |
polardb_x_user |
|
|
-p |
Kata sandi untuk akun database. Catatan
Parameter ini wajib.
|
Pass***233 |
|
-D |
Nama database yang ingin Anda hubungi. Catatan
Parameter ini opsional. |
test_db |
Aplikasi
Terhubung ke instans PolarDB-X dari aplikasi mirip dengan terhubung ke database MySQL standar, hanya memerlukan titik akhir database, port, akun, dan kata sandi. Contoh berikut menunjukkan cara mengakses instans PolarDB-X menggunakan bahasa pemrograman umum:
Java
Contoh ini menggunakan proyek Maven dan driver JDBC MySQL untuk terhubung ke instans PolarDB-X.
-
Pertama, Anda perlu menambahkan dependensi driver JDBC MySQL ke file
pom.xml. Berikut contoh kodenya:<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.27</version> </dependency> -
Terhubung ke instans. Ganti parameter
<HOST>, nomor port,<USER>,<PASSWORD>,<DATABASE>,<YOUR_TABLE_NAME>, dan<YOUR_TABLE_COLUMN_NAME>.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) { // Titik akhir instans PolarDB-X, port, dan nama database String url = "jdbc:mysql://<HOST>:3306/<DATABASE>?useSSL=false&serverTimezone=UTC"; // Akun database String user = "<USER>"; // Kata sandi database String password = "<PASSWORD>"; try { Class.forName("com.mysql.cj.jdbc.Driver"); Connection conn = DriverManager.getConnection(url, user, password); Statement stmt = conn.createStatement(); // Tabel untuk dikueri ResultSet rs = stmt.executeQuery("SELECT * FROM `<YOUR_TABLE_NAME>`"); while(rs.next()) { // Kolom untuk diambil System.out.println(rs.getString("<YOUR_TABLE_COLUMN_NAME>")); } rs.close(); stmt.close(); conn.close(); } catch (Exception var7) { var7.printStackTrace(); } } }
Python
Contoh ini menggunakan Python 3 dan library PyMySQL untuk terhubung ke instans PolarDB-X.
-
Instal library PyMySQL. Jika belum terinstal, jalankan perintah berikut:
pip3 install PyMySQL -
Terhubung ke instans. Ganti parameter
<HOST>, nomor port,<USER>,<PASSWORD>,<DATABASE>, dan<YOUR_TABLE_NAME>.import pymysql # Parameter koneksi host = '<HOST>' # Titik akhir instans PolarDB-X port = 3306 # Port default adalah 3306 user = '<USER>' # Akun database password = '<PASSWORD>' # Kata sandi database database = '<DATABASE>' # Nama database target try: # Buat koneksi database connection = pymysql.connect( host=host, port=port, user=user, passwd=password, db=database ) # Buat cursor with connection.cursor() as cursor: # Jalankan kueri SQL sql = "SELECT * FROM `<YOUR_TABLE_NAME>`" # Tabel untuk dikueri cursor.execute(sql) # Ambil hasil kueri results = cursor.fetchall() for row in results: print(row) finally: # Tutup koneksi database if 'connection' in locals() and connection.open: connection.close()
Go
Contoh ini menggunakan Go 1.23.0, paket database/sql, dan driver go-sql-driver/mysql untuk terhubung ke instans PolarDB-X.
-
Pertama, Anda perlu menginstal driver
go-sql-driver/mysql. Anda dapat menginstalnya dengan menjalankan perintah berikut:go get -u github.com/go-sql-driver/mysql -
Terhubung ke instans. Ganti parameter
<HOST>, nomor port,<USER>,<PASSWORD>,<DATABASE>, dan<YOUR_TABLE_NAME>.package main import ( "database/sql" "fmt" "log" _ "github.com/go-sql-driver/mysql" ) func main() { // Parameter koneksi dbHost := "<HOST>" // Titik akhir instans PolarDB-X dbPort := "3306" // Port default adalah 3306 dbUser := "<USER>" // Akun database dbPass := "<PASSWORD>" // Kata sandi database dbName := "<DATABASE>" // Nama database target // Bangun DSN (Data Source Name) dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local", dbUser, dbPass, dbHost, dbPort, dbName) // Buka koneksi database db, err := sql.Open("mysql", dsn) if err != nil { log.Fatalf("Gagal terhubung ke database: %v", err) } defer db.Close() // Ping server untuk menguji koneksi err = db.Ping() if err != nil { log.Fatalf("Gagal ping database: %v", err) } // Kueri versi server var result string err = db.QueryRow("SELECT VERSION()").Scan(&result) if err != nil { log.Fatalf("Gagal menjalankan kueri: %v", err) } // Cetak versi database fmt.Printf("Terhubung ke database, versi: %s\n", result) // Jalankan kueri SQL rows, err := db.Query("SELECT * FROM `<YOUR_TABLE_NAME>`") // Tabel untuk dikueri if err != nil { log.Fatalf("Gagal menjalankan kueri: %v", err) } defer rows.Close() // Proses hasil kueri for rows.Next() { var id int var name string if err := rows.Scan(&id, &name); err != nil { log.Fatalf("Gagal memindai baris: %v", err) } fmt.Printf("ID: %d, Nama: %s\n", id, name) } // Periksa kesalahan selama iterasi baris if err := rows.Err(); err != nil { log.Fatalf("Kesalahan selama iterasi: %v", err) } }