Gunakan klien atau CLI untuk menghubungkan ke instance ApsaraDB RDS for MySQL - ApsaraDB RDS

Setelah membuat instance ApsaraDB RDS for MySQL dan menyelesaikan konfigurasi yang diperlukan seperti pembuatan akun dan pengaturan daftar putih, Anda dapat menghubungkan ke instance RDS menggunakan klien atau CLI. Topik ini menjelaskan cara menghubungkan ke instance RDS melalui Internet atau jaringan internal serta memberikan panduan untuk menangani kesalahan umum terkait koneksi.

Prasyarat

Instance RDS telah dibuat, serta database dan akun telah dikonfigurasikan.
Daftar putih alamat IP telah dikonfigurasikan untuk instance RDS.

Saran

Untuk mengurangi latensi dan meningkatkan stabilitas, disarankan menghubungkan instance Elastic Compute Service (ECS) ke instance RDS melalui jaringan internal. Jika ingin menggunakan jaringan internal, pastikan kondisi berikut terpenuhi:
Instance ECS dan instance RDS harus dibuat menggunakan akun Alibaba Cloud yang sama, berada di wilayah dan virtual private cloud (VPC) yang sama, serta alamat IP privat dari instance ECS telah ditambahkan ke daftar putih alamat IP instance RDS.
Catatan
Alamat IP privat instance ECS dapat ditemukan pada halaman Instances.
Jika ingin menghubungkan ke instance RDS melalui Internet, gunakan titik akhir instance.
Catatan
- Jalankan perintah curl ipinfo.io/ip atau curl ifconfig.me untuk mendapatkan alamat IP publik perangkat lokal. Disarankan menggunakan perintah curl ipinfo.io/ip.
- Alamat IP publik mungkin berubah selama peningkatan instance atau perubahan spesifikasi. Jika alamat IP publik perangkat lokal telah ditambahkan ke daftar putih tetapi koneksi masih gagal, lihat solusi dalam Mengapa saya tidak dapat menghubungkan ke instance ApsaraDB RDS for MySQL atau ApsaraDB RDS for MariaDB saya dari server lokal melalui Internet?

Prosedur

Gunakan CLI untuk menghubungkan ke instance RDS

Contoh berikut menjelaskan cara menghubungkan ke instance RDS dari server Linux. Pastikan MySQL telah diinstal sebelum melakukan koneksi. Jalankan perintah berikut untuk menginstal MySQL:

Untuk sistem operasi CentOS, jalankan perintah sudo yum install mysql.
Untuk sistem operasi Ubuntu, jalankan perintah sudo apt-get update, lalu sudo apt install mysql-server.

Masuk ke server tempat Anda ingin menghubungkan ke instance RDS, misalnya instance ECS atau perangkat lokal.
Catatan
Untuk informasi lebih lanjut tentang cara masuk ke instance ECS, lihat bagian "Hubungkan ke instance" dalam Buat dan kelola instance ECS menggunakan konsol ECS (versi ekspres).

Jalankan perintah koneksi:

mysql -hEndpoint -PPort -uUsername -pPassword

Catatan

Anda dapat memasukkan kata sandi setelah menjalankan perintah.
Huruf kapital P menentukan nomor port, sedangkan huruf kecil p menentukan kata sandi.

Titik akhir dan nomor port: Masukkan titik akhir dan nomor port yang digunakan untuk menghubungkan ke instance RDS.

Skenario	Titik akhir yang harus diperoleh	Cara mendapatkan titik akhir
Anda ingin menghubungkan ke instance RDS dari instance ECS. Instance ECS dan instance RDS memenuhi syarat untuk komunikasi melalui jaringan internal.	Titik akhir internal dari instance RDS	Masuk ke konsol ApsaraDB RDS dan buka halaman Instances. Pilih wilayah tempat instance RDS berada, temukan instance RDS, dan klik ID instance. Di bagian Informasi Dasar halaman yang muncul, klik View Details di sebelah kanan parameter Tipe Jaringan untuk melihat titik akhir dan nomor port yang digunakan untuk menghubungkan ke instance RDS. Catatan Titik akhir publik hanya ditampilkan setelah diajukan dengan mengklik Apply for Public Endpoint. Anda dapat memodifikasi titik akhir baca/tulis cluster RDS di bagian Cluster Read/Write Connection dan memodifikasi titik akhir hanya-baca cluster RDS di bagian Cluster Read-only Connection.
Anda ingin menghubungkan ke instance RDS dari instance ECS. Instance ECS dan instance RDS tidak memenuhi syarat untuk komunikasi melalui jaringan internal.	Titik akhir publik dari instance RDS
Anda ingin menghubungkan ke instance RDS dari perangkat lokal.	Titik akhir publik dari instance RDS

Nama pengguna dan kata sandi: Dapatkan nama pengguna dan kata sandi akun yang digunakan untuk menghubungkan ke instance RDS dari halaman Akun halaman detail instance.

Gunakan MySQL Workbench untuk menghubungkan ke instance RDS

Anda dapat menggunakan klien MySQL serbaguna untuk menghubungkan ke instance RDS. Contoh berikut menjelaskan cara menggunakan MySQL Workbench 8.0.29 untuk menghubungkan ke instance RDS. Operasi serupa jika menggunakan klien lain.

Instal MySQL Workbench. Untuk informasi lebih lanjut, kunjungi halaman unduhan MySQL Workbench.
Mulai MySQL Workbench dan pilih Database > Connect to Database.

Masukkan informasi koneksi dan klik OK.

连接界面

Hostname dan Port: Masukkan titik akhir dan nomor port yang digunakan untuk menghubungkan ke instance RDS.

Skenario	Titik akhir yang harus diperoleh	Cara mendapatkan titik akhir
Anda ingin menghubungkan ke instance RDS dari instance ECS. Instance ECS dan instance RDS memenuhi syarat untuk komunikasi melalui jaringan internal.	Titik akhir internal dari instance RDS	Masuk ke konsol ApsaraDB RDS dan buka halaman Instances. Pilih wilayah tempat instance RDS berada, temukan instance RDS, dan klik ID instance. Di bagian Informasi Dasar halaman yang muncul, klik View Details di sebelah kanan parameter Tipe Jaringan untuk melihat titik akhir dan nomor port yang digunakan untuk menghubungkan ke instance RDS. Catatan Titik akhir publik hanya ditampilkan setelah diajukan dengan mengklik Apply for Public Endpoint. Anda dapat memodifikasi titik akhir baca/tulis cluster RDS di bagian Cluster Read/Write Connection dan memodifikasi titik akhir hanya-baca cluster RDS di bagian Cluster Read-only Connection.
Anda ingin menghubungkan ke instance RDS dari instance ECS. Instance ECS dan instance RDS tidak memenuhi syarat untuk komunikasi melalui jaringan internal.	Titik akhir publik dari instance RDS
Anda ingin menghubungkan ke instance RDS dari perangkat lokal.	Titik akhir publik dari instance RDS

Username dan Password: Dapatkan nama pengguna dan kata sandi akun yang digunakan untuk menghubungkan ke instance RDS dari halaman Accounts halaman detail instance.

Gunakan Navicat untuk menghubungkan ke instance RDS

Mulai klien Navicat.
Di bilah alat, klik Connection dan pilih tipe database yang akan dihubungkan.
Catatan
Jika klien Navicat Anda sudah usang, Alibaba Cloud tidak ditampilkan. Anda dapat memilih tipe database seperti MySQL atau PostgreSQL.

Masukkan informasi tentang instance RDS yang ingin Anda hubungkan. Tabel berikut menjelaskan parameter yang diperlukan.

连接设置

Parameter	Deskripsi
Connection Name	Masukkan nama kustom untuk koneksi.
Host	Masukkan titik akhir internal atau publik dari instance RDS. Jika klien Anda ditempatkan pada instance Elastic Compute Service (ECS) dan instance ECS dibuat menggunakan akun Alibaba Cloud yang sama serta berada di wilayah dan virtual private cloud (VPC) yang sama dengan instance RDS, gunakan titik akhir internal. Dalam situasi lain, gunakan titik akhir publik.
Port	Masukkan port internal atau publik dari instance RDS. Sebagai contoh, port default dari instance RDS for MySQL adalah 3306.
User Name	Masukkan nama pengguna akun yang digunakan untuk menghubungkan ke instance RDS.
Password	Kata sandi akun yang digunakan untuk menghubungkan ke instance RDS.

Klik OK.
Catatan
Jika mode daftar putih ditingkatkan diaktifkan untuk instance RDS Anda dan Anda ingin menghubungkan perangkat Anda ke instance melalui Internet, Anda harus menambahkan alamat IP publik perangkat ke daftar putih alamat IP jenis jaringan klasik.

Koneksi lintas wilayah atau lintas akun antara instance ECS dan instance RDS

Koneksi berbasis Internet: Anda dapat menggunakan titik akhir publik dari instance RDS untuk membangun koneksi lintas wilayah atau lintas akun berbasis Internet ke instance RDS. Tidak ada biaya untuk lalu lintas Internet masuk dan keluar yang dihasilkan pada instance RDS.
Koneksi berbasis jaringan internal: Jika instance ECS dan instance RDS berada di wilayah yang berbeda atau dalam akun Alibaba Cloud yang berbeda, Anda tidak dapat menghubungkan instance melalui jaringan internal karena VPC terisolasi satu sama lain. Namun, Anda dapat menggunakan koneksi peering VPC atau instance Cloud Enterprise Network (CEN) untuk menghubungkan dua VPC yang berbeda sehingga instance ECS dapat menghubungkan ke instance RDS lintas wilayah atau akun Alibaba Cloud.
- Koneksi peering VPC: Memungkinkan komunikasi antar-VPC lintas wilayah atau akun Alibaba Cloud dengan biaya rendah. Namun, konfigurasinya relatif kompleks dan cocok untuk skenario sederhana di mana sejumlah kecil VPC perlu dihubungkan.
- Instance CEN: Memungkinkan komunikasi antar-VPC lintas wilayah atau akun Alibaba Cloud dengan biaya tinggi. Namun, konfigurasinya mudah dan cocok untuk skenario kompleks di mana sejumlah besar VPC perlu dihubungkan.

Kesalahan koneksi umum

Perintah mysql tidak ditemukan

Kesalahan ini terjadi karena MySQL belum diinstal. Jalankan perintah berikut untuk menginstal MySQL:

Untuk sistem operasi CentOS, jalankan perintah sudo yum install mysql.
Untuk sistem operasi Ubuntu, jalankan perintah sudo apt-get update, lalu sudo apt install mysql-server.

Kesalahan koneksi SSL: SSL diperlukan tetapi server tidak mendukungnya

Anda menggunakan versi tertentu dari MySQL Workbench. Pada versi ini, koneksi TCP/IP standar memerlukan enkripsi SSL. Namun, server yang terhubung tidak mendukung enkripsi SSL. Dalam kasus ini, unduh versi MySQL Workbench yang sesuai untuk membangun koneksi reguler.

Kode kesalahan 10060: Tidak dapat menghubungkan ke server MySQL di 'rm-bpxxx.mysql.rds.aliyuncs.com'(10060)

Dalam banyak kasus, kesalahan ini terjadi karena alamat IP klien Anda tidak ditambahkan ke daftar putih instance RDS.
Solusi: Konfigurasikan daftar putih alamat IP untuk instance RDS Anda dan periksa apakah alamat IP klien telah ditambahkan ke daftar putih. Jika menggunakan klien lokal, jalankan perintah curl ipinfo.io/ip untuk mendapatkan alamat IP publik klien, lalu tambahkan alamat tersebut ke daftar putih.
Dalam beberapa kasus, kesalahan ini terjadi karena Anda menghubungkan ke instance RDS menggunakan titik akhir internal tetapi instance RDS dan instance ECS tidak memenuhi syarat untuk koneksi melalui jaringan internal.
Solusi: Ajukan titik akhir publik untuk instance RDS dan gunakan untuk menghubungkan ke instance RDS.

Kode kesalahan 113: Tidak dapat menghubungkan ke server MySQL di 'rm-bpxxx.mysql.rds.aliyuncs.com'(113)

Kesalahan ini terjadi karena terjadi konflik rute. Untuk informasi lebih lanjut, lihat Apa yang harus saya lakukan jika saya tidak dapat menghubungkan ke instance ApsaraDB RDS dan pesan kesalahan "Destination Host Unreachable" ditampilkan saat saya ping titik akhir internal instance?

Tidak Dapat Menghubungkan ke Server Database

Dalam banyak kasus, kesalahan ini terjadi karena daftar putih alamat IP yang Anda konfigurasikan tidak sesuai. Untuk informasi lebih lanjut, lihat Konfigurasikan daftar putih alamat IP.
Dalam beberapa kasus, kesalahan ini terjadi karena Anda menghubungkan ke instance RDS menggunakan titik akhir internal tetapi instance RDS dan instance ECS tidak memenuhi syarat untuk koneksi melalui jaringan internal. Dalam hal ini, ajukan titik akhir publik untuk instance RDS dan gunakan untuk menghubungkan ke instance RDS.

Upaya koneksi Anda gagal untuk pengguna 'xx' ke server MySQL

Dalam banyak kasus, kesalahan ini terjadi karena daftar putih alamat IP yang Anda konfigurasikan tidak sesuai. Untuk informasi lebih lanjut, lihat Konfigurasikan daftar putih alamat IP.
Dalam beberapa kasus, kesalahan ini terjadi karena Anda menghubungkan ke instance RDS menggunakan titik akhir internal tetapi instance RDS dan instance ECS tidak memenuhi syarat untuk koneksi melalui jaringan internal. Dalam hal ini, ajukan titik akhir publik untuk instance RDS dan gunakan untuk menghubungkan ke instance RDS.

Pesan kesalahan "Destination Host Unreachable" dilaporkan saat Anda ping titik akhir internal instance RDS

Akses ditolak untuk pengguna 'xxx'@'xxx'(menggunakan kata sandi:YA)

Kesalahan ini terjadi karena nama pengguna dan kata sandi yang Anda masukkan salah. Anda bisa mendapatkan nama pengguna dan kata sandi yang benar dari halaman Accounts halaman detail instance.

Host server MySQL tidak dikenal 'xxx'(11001)

Kesalahan ini terjadi karena titik akhir yang Anda masukkan tidak valid. Titik akhir yang valid berada dalam format rm-xxxxxx.mysql.rds.aliyuncs.com.

FAQ

Apakah instance RDS mendukung elastic IP addresses (EIPs)?
Tidak, instance RDS tidak mendukung EIPs.
Bagaimana cara menyelesaikan masalah bahwa saya gagal menggunakan Telnet untuk menghubungkan komputer saya ke instance RDS?
Jika Anda gagal menggunakan Telnet untuk menghubungkan komputer Anda ke instance RDS, periksa item berikut:
- Apakah port layanan instance RDS benar dan dapat diakses melalui Internet.
- Apakah aturan grup keamanan atau aturan firewall instance RDS mengizinkan permintaan akses dari alamat IP komputer Anda.
- Apakah parameter koneksi, seperti nama host dan nomor port, dikonfigurasi dengan benar.
- Apakah aturan firewall komputer Anda memblokir port yang digunakan untuk menghubungkan ke instance RDS.
- Apakah masalah tersebut merupakan masalah spesifik Telnet. Anda dapat menggunakan metode lain, seperti klien mysql atau alat manajemen database, untuk menghubungkan ke instance RDS untuk pemeriksaan.
Bagaimana cara mengizinkan pengguna menghubungkan ke database RDS for MySQL saya?
Lakukan langkah-langkah berikut untuk mengizinkan pengguna menghubungkan ke database RDS for MySQL Anda:
1. Buat akun standar dan berikan izin untuk mengakses instance RDS for MySQL.
2. Ajukan titik akhir publik untuk instance.
3. Konfigurasikan daftar putih alamat IP untuk instance. Jika pengguna menggunakan instance ECS untuk menghubungkan ke instance RDS Anda, tambahkan alamat IP internal atau ID grup keamanan instance ECS ke daftar putih. Jika pengguna menggunakan klien MySQL lokal, tambahkan alamat IP klien ke daftar putih.
4. Berikan informasi koneksi, termasuk titik akhir publik instance Anda, nama database, akun database yang dibuat, dan kata sandi akun, kepada pengguna.
5. Izinkan pengguna untuk menggunakan CLI untuk menghubungkan ke database Anda.

Referensi

Untuk informasi lebih lanjut tentang cara menangani kesalahan koneksi, lihat Apa yang harus saya lakukan jika saya gagal menghubungkan ke instance ApsaraDB RDS?
Untuk informasi lebih lanjut tentang cara menghubungkan ke instance RDS dengan cara yang lebih nyaman dan efisien, lihat Gunakan DMS untuk masuk ke instance ApsaraDB RDS for MySQL.
Untuk informasi lebih lanjut tentang cara menghubungkan ke instance RDS yang menjalankan mesin database yang berbeda, lihat topik berikut: