Menghubungkan ke cluster Aurora DB dengan driver AWS Menghubungkan ke Aurora My SQL Menghubungkan ke Aurora Postgre SQL Pemecahan masalah koneksi

Menghubungkan ke klaster DB Amazon Aurora

Anda dapat terhubung ke cluster Aurora DB menggunakan alat yang sama yang Anda gunakan untuk terhubung ke database My SQL atau SQL Postgre. Anda menentukan string koneksi dengan skrip, utilitas, atau aplikasi apa pun yang terhubung ke instance My SQL atau Postgre SQL DB. Anda menggunakan kunci publik yang sama untuk koneksi Secure Sockets Layer (SSL).

Dalam string koneksi, Anda biasanya menggunakan informasi host dan port dari titik akhir khusus yang terkait dengan klaster DB. Dengan titik akhir ini, Anda dapat menggunakan parameter koneksi yang sama terlepas dari berapa banyak instans DB yang ada di klaster. Anda juga menggunakan informasi host dan port dari instans DB tertentu di klaster DB Aurora Anda untuk tugas-tugas khusus, seperti pemecahan masalah.

catatan

Untuk Aurora Serverless Cluster DB, Anda terhubung ke endpoint database daripada ke instance DB. Anda dapat menemukan titik akhir database untuk Aurora Serverless Cluster DB pada tab Konektivitas & keamanan pada file AWS Management Console. Untuk informasi selengkapnya, lihat Menggunakan Amazon Aurora Serverless v1.

Terlepas dari mesin DB Aurora dan alat-alat khusus yang Anda gunakan untuk menangani klaster atau instans DB, titik akhir harus dapat diakses. Cluster Aurora DB hanya dapat dibuat di cloud pribadi virtual (VPC) berdasarkan layanan AmazonVPC. Itu berarti Anda mengakses titik akhir baik dari dalam VPC atau di luar VPC menggunakan salah satu pendekatan berikut.

Akses cluster Aurora DB di dalam VPC — Aktifkan akses ke cluster Aurora DB melalui. VPC Anda melakukannya dengan mengedit aturan Inbound pada grup Keamanan untuk mengizinkan akses VPC ke cluster Aurora DB spesifik Anda. Untuk mempelajari lebih lanjut, termasuk cara VPC mengonfigurasi skenario klaster Aurora DB yang berbeda, lihat Amazon Virtual Private Cloud VPCs dan Amazon Aurora.
Akses cluster Aurora DB di luar VPC — Untuk mengakses cluster Aurora DB dari luarVPC, gunakan alamat titik akhir publik cluster DB.

Untuk informasi selengkapnya, lihat Pemecahan masalah kegagalan koneksi Aurora.

Daftar Isi

Menghubungkan ke cluster Aurora DB dengan driver AWS

AWS Rangkaian driver telah dirancang untuk memberikan dukungan untuk waktu peralihan dan failover yang lebih cepat, dan otentikasi dengan, AWS Identity and Access Management (IAM), dan AWS Secrets Manager Federated Identity. AWS Driver mengandalkan pemantauan status cluster DB dan menyadari topologi cluster untuk menentukan penulis baru. Pendekatan ini mengurangi waktu peralihan dan failover menjadi satu digit detik, dibandingkan dengan puluhan detik untuk driver open-source.

Tabel berikut mencantumkan fitur yang didukung untuk masing-masing driver. Ketika fitur layanan baru diperkenalkan, tujuan dari AWS rangkaian driver adalah untuk memiliki dukungan bawaan untuk fitur layanan ini.

Fitur	AWS JDBCSopir	AWS Pengemudi Python	AWS ODBCSopir untuk Saya SQL	AWS Pembungkus NodeJS Tingkat Lanjut
Dukungan Failover	Ya	Ya	Ya	Ya
Pemantauan failover yang ditingkatkan	Ya	Ya	Ya	Ya
Membaca/menulis pemisahan	Ya	Ya	Tidak	Ya
Pelacak koneksi Aurora	Ya	Ya	Tidak	Ya
Koneksi metadata driver	Ya	N/A	N/A	N/A
Telemetri	Ya	Ya	Tidak	Ya
Secrets Manager	Ya	Ya	Ya	Ya
IAMotentikasi	Ya	Ya	Ya	Ya
Identitas Federasi (AD FS)	Ya	Ya	Tidak	Ya
Identitas Federasi (Okta)	Ya	Ya	Ya	Ya
Basis Data Tanpa Batas Aurora Postgre SQL	Ya (hanya Aurora SQL Postgre)	Tidak	Tidak	Ya (hanya Aurora SQL Postgre)

Untuk informasi lebih lanjut tentang AWS driver, lihat driver bahasa yang sesuai untuk klaster Aurora My atau Aurora SQL Postgre DB Anda. SQL

Menghubungkan ke cluster Amazon Aurora My DB SQL

Untuk mengautentikasi ke cluster Aurora SQL My DB Anda, Anda dapat menggunakan otentikasi nama pengguna dan kata sandi SQL saya AWS Identity and Access Management atau IAM () otentikasi basis data. Untuk informasi selengkapnya tentang penggunaan autentikasi nama SQL pengguna dan kata sandi saya, lihat Kontrol akses dan manajemen akun di SQL dokumentasi Saya. Untuk informasi selengkapnya tentang menggunakan otentikasi IAM database, lihatAutentikasi basis data IAM.

Ketika Anda memiliki koneksi ke cluster Amazon Aurora DB Anda dengan kompatibilitas My SQL 8.0, Anda dapat menjalankan SQL perintah yang kompatibel dengan My SQL versi 8.0. Versi minimum yang kompatibel adalah My SQL 8.0.23. Untuk informasi selengkapnya tentang SQL sintaks My SQL 8.0, lihat manual referensi My SQL 8.0. Untuk informasi tentang batasan yang berlaku untuk Aurora My SQL versi 3, lihat. Membandingkan Aurora MySQL versi 3 dan MySQL 8.0 Community Edition

Ketika Anda memiliki koneksi ke cluster Amazon Aurora DB Anda dengan kompatibilitas My SQL 5.7, Anda dapat menjalankan SQL perintah yang kompatibel dengan My SQL versi 5.7. Untuk informasi selengkapnya tentang SQL sintaks SQL 5.7 Saya, lihat manual referensi SQL5.7 Saya. Untuk informasi tentang batasan yang berlaku untuk Aurora My SQL 5.7, lihat. Aurora SQL Versi saya 2 kompatibel dengan My 5.7 SQL

catatan

Untuk panduan yang bermanfaat dan terperinci tentang menghubungkan ke cluster Amazon Aurora My SQL DB, Anda dapat melihat buku pegangan manajemen koneksi Aurora.

Dalam tampilan detail untuk cluster DB Anda, Anda dapat menemukan titik akhir cluster, yang dapat Anda gunakan dalam string SQL koneksi Saya. Titik akhir terdiri dari nama domain dan port untuk klaster DB Anda. Misalnya, jika nilai endpoint adalahmycluster.cluster-123456789012.us-east-1.rds.amazonaws.com:3306, maka Anda menentukan nilai berikut dalam string SQL koneksi saya:

Untuk host atau nama host, tentukan mycluster.cluster-123456789012.us-east-1.rds.amazonaws.com
Untuk port, tentukan 3306 atau nilai port yang Anda gunakan saat Anda membuat klaster DB

Titik akhir klaster menghubungkan Anda ke instans primer untuk klaster DB. Anda dapat melakukan operasi baca dan tulis menggunakan titik akhir klaster. Klaster DB Anda juga dapat memiliki hingga 15 Replika Aurora yang mendukung akses hanya baca ke data di klaster DB Anda. Instans primer dan setiap Replika Aurora memiliki titik akhir unik yang tidak bergantung pada titik akhir klaster dan memungkinkan Anda terhubung ke instans DB tertentu dalam klaster secara langsung. Titik akhir klaster selalu mengarah ke instans primer. Jika instans primer gagal dan diganti, maka titik akhir klaster mengarah ke instans primer baru.

Untuk melihat titik akhir cluster (titik akhir penulis), pilih Database di RDS konsol Amazon dan pilih nama cluster DB untuk menampilkan detail cluster DB.

Topik

Utilitas koneksi untuk Aurora My SQL
Menghubungkan ke Aurora My SQL dengan utilitas Saya SQL
Menghubungkan ke Aurora My SQL dengan Driver Amazon Web Services ()AWS JDBC
Menghubungkan ke Aurora My SQL dengan Driver AWS Python Amazon Web Services ()
Menghubungkan ke Aurora My SQL dengan ODBC Driver Amazon Web Services (AWS) untuk Saya SQL
Menghubungkan ke Aurora My SQL dengan Amazon Web Services (AWS) Advanced NodeJS Wrapper
Menghubungkan ke Aurora My menggunakan SQL SSL

Utilitas koneksi untuk Aurora My SQL

Beberapa utilitas koneksi yang dapat Anda gunakan adalah sebagai berikut:

Baris perintah - Anda dapat terhubung ke cluster Amazon Aurora DB dengan menggunakan alat seperti utilitas baris SQL perintah Saya. Untuk informasi selengkapnya tentang penggunaan SQL utilitas Saya, lihat mysql — klien SQL baris perintah Saya dalam dokumentasi Saya. SQL
GUI— Anda dapat menggunakan utilitas My SQL Workbench untuk terhubung dengan menggunakan antarmuka UI. Untuk informasi selengkapnya, lihat halaman Unduh SQL meja kerja saya.
AWS driver:

Menghubungkan ke Aurora My SQL dengan utilitas Saya SQL

Gunakan prosedur berikut: Ini mengasumsikan bahwa Anda mengkonfigurasi cluster DB Anda di subnet pribadi di. VPC Anda terhubung menggunakan EC2 instans Amazon yang Anda konfigurasikan sesuai dengan tutorial diTutorial: Membuat server web dan klaster DB Amazon Aurora.

catatan

Prosedur ini tidak memerlukan penginstalan server web dalam tutorial tersebut, tetapi memerlukan penginstalan MariaDB 10.5.

Untuk terhubung ke cluster DB menggunakan SQL utilitas Saya

Masuk ke EC2 instance yang Anda gunakan untuk terhubung ke cluster DB Anda.

Anda akan melihat output seperti yang berikut ini.


Last login: Thu Jun 23 13:32:52 2022 from xxx.xxx.xxx.xxx

       __|  __|_  )
       _|  (     /   Amazon Linux 2 AMI
      ___|\___|___|

https://aws.amazon.com/amazon-linux-2/
[ec2-user@ip-10-0-xxx.xxx ~]$

Ketikkan perintah berikut pada baris perintah untuk terhubung ke instans DB primer dari klaster DB Anda.

Untuk -h parameter, gantikan DNS nama endpoint untuk instance utama Anda. Untuk parameter -u, ganti ID pengguna untuk akun pengguna basis data.
```
mysql -h primary-instance-endpoint.AWS_account.AWS_Region.rds.amazonaws.com -P 3306 -u database_user -p
```
Contoh:
```
mysql -h my-aurora-cluster-instance.c1xy5example.123456789012.eu-central-1.rds.amazonaws.com -P 3306 -u admin -p
```

Masukkan kata sandi untuk pengguna basis data.

Anda akan melihat output seperti yang berikut ini.


Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MySQL connection id is 1770
Server version: 8.0.23 Source distribution

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MySQL [(none)]>

Masukkan SQL perintah Anda.

Menghubungkan ke Aurora My SQL dengan Driver Amazon Web Services ()AWS JDBC

JDBCDriver Amazon Web Services (AWS) dirancang sebagai JDBC pembungkus canggih. Pembungkus ini melengkapi dan memperluas fungsionalitas JDBC driver yang ada untuk membantu aplikasi memanfaatkan fitur database berkerumun seperti Aurora My. SQL Driver drop-in kompatibel dengan komunitas SQL Connector/J driver and the community MariaDB Connector/J Driver saya.

Untuk menginstal AWS JDBC Driver, tambahkan file AWS JDBC Driver .jar (terletak di aplikasiCLASSPATH), dan simpan referensi ke driver komunitas masing-masing. Perbarui URL awalan koneksi masing-masing sebagai berikut:

jdbc:mysql:// untuk jdbc:aws-wrapper:mysql://
jdbc:mariadb:// untuk jdbc:aws-wrapper:mariadb://

Untuk informasi selengkapnya tentang AWS JDBC Driver dan petunjuk lengkap untuk menggunakannya, lihat GitHub repositori JDBC Driver Amazon Web Services (AWS).

catatan

Versi 3.0.3 dari utilitas MariaDB Connector/J menjatuhkan dukungan untuk cluster Aurora DB, jadi kami sangat menyarankan pindah ke Driver. AWS JDBC

Menghubungkan ke Aurora My SQL dengan Driver AWS Python Amazon Web Services ()

Driver Python Amazon Web Services (AWS) dirancang sebagai pembungkus Python tingkat lanjut. Pembungkus ini melengkapi dan memperluas fungsionalitas driver Psycopg open-source. Driver AWS Python mendukung Python versi 3.8 dan lebih tinggi. Anda dapat menginstal aws-advanced-python-wrapper paket menggunakan pip perintah, bersama dengan paket psycopg open-source.

Untuk informasi selengkapnya tentang Driver AWS Python dan petunjuk lengkap untuk menggunakannya, lihat repositori Amazon Web Services ()AWS Python Driver. GitHub

Menghubungkan ke Aurora My SQL dengan ODBC Driver Amazon Web Services (AWS) untuk Saya SQL

AWS ODBCDriver for My SQL adalah driver klien yang dirancang untuk ketersediaan tinggi Aurora My. SQL Driver dapat ada di samping My SQL ODBC Connector/driver dan kompatibel dengan alur kerja yang sama.

Untuk informasi selengkapnya tentang AWS ODBC Driver for My SQL dan petunjuk lengkap untuk menginstal dan menggunakannya, lihat ODBCDriver Amazon Web Services (AWS) untuk SQL GitHub repositori Saya.

Menghubungkan ke Aurora My SQL dengan Amazon Web Services (AWS) Advanced NodeJS Wrapper

AWS Advanced NodeJS Wrapper melengkapi dan memperluas fungsionalitas driver NodeJS yang ada. Ini membantu aplikasi memanfaatkan fitur database berkerumun seperti Aurora My. SQL

Untuk informasi selengkapnya tentang AWS Advanced NodeJS Wrapper dan petunjuk lengkap untuk menggunakannya, lihat repositori Amazon Web Services (AWS) Advanced NodeJS Wrapper. GitHub

Menghubungkan ke Aurora My menggunakan SQL SSL

Anda dapat menggunakan SSL enkripsi pada koneksi ke instans Aurora My SQL DB. Untuk informasi, lihat Koneksi TLS ke cluster DB MySQL Aurora.

Untuk terhubung menggunakanSSL, gunakan SQL utilitas Saya seperti yang dijelaskan dalam prosedur berikut. Jika Anda menggunakan otentikasi IAM database, Anda harus menggunakan SSL koneksi. Untuk informasi, lihat Autentikasi basis data IAM.

catatan

Untuk terhubung ke titik akhir cluster menggunakanSSL, utilitas koneksi klien Anda harus mendukung Nama Alternatif Subjek (SAN). Jika utilitas koneksi klien Anda tidak mendukungSAN, Anda dapat terhubung langsung ke instance di cluster Aurora DB Anda. Untuk informasi selengkapnya tentang titik akhir Aurora, lihat Koneksi titik akhir Amazon Aurora.

Untuk terhubung ke cluster DB dengan SSL menggunakan SQL utilitas Saya

Unduh kunci publik untuk sertifikat RDS penandatanganan Amazon.

Untuk informasi tentang mengunduh sertifikat, lihat .
Ketik perintah berikut pada prompt perintah untuk terhubung ke instance utama cluster DB dengan SSL menggunakan SQL utilitas Saya. Untuk -h parameter, gantikan DNS nama endpoint untuk instance utama Anda. Untuk parameter -u, ganti ID pengguna untuk akun pengguna basis data. Untuk --ssl-ca parameter, ganti nama file SSL sertifikat yang sesuai. Ketikkan kata sandi pengguna master saat diminta.

mysql -h mycluster-primary.123456789012.us-east-1.rds.amazonaws.com -u admin_user -p --ssl-ca=[full path]global-bundle.pem --ssl-verify-server-cert

Anda akan melihat keluaran yang mirip dengan berikut ini.


Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 350
Server version: 8.0.26-log MySQL Community Server (GPL)

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql>

Untuk petunjuk umum tentang membangun RDS string SQL koneksi Saya dan menemukan kunci publik untuk SSL koneksi, lihat Menghubungkan ke instans DB yang menjalankan mesin SQL database Saya.

Menghubungkan ke cluster DB Amazon Aurora Postgre SQL

Anda dapat terhubung ke instans DB di klaster Amazon Aurora Postgre SQL DB menggunakan alat yang sama yang Anda gunakan untuk menyambung ke database Postgre. SQL Sebagai bagian dari ini, Anda menggunakan kunci publik yang sama untuk koneksi Secure Sockets Layer (SSL). Anda dapat menggunakan informasi titik akhir dan port dari instance utama atau Aurora Replicas di cluster Aurora SQL Postgre DB Anda dalam string koneksi skrip, utilitas, atau aplikasi apa pun yang terhubung ke instans Postgre DB. SQL Dalam string koneksi, tentukan DNS alamat dari instance utama atau titik akhir Aurora Replica sebagai parameter host. Tentukan nomor port dari titik akhir sebagai parameter port.

Ketika Anda memiliki koneksi ke instans DB di cluster Amazon Aurora Postgre SQL DB Anda, Anda dapat menjalankan SQL perintah apa pun yang kompatibel dengan Postgre. SQL

Dalam tampilan detail untuk cluster Aurora Postgre SQL DB Anda, Anda dapat menemukan nama titik akhir cluster, status, jenis, dan nomor port. Anda menggunakan titik akhir dan nomor port dalam string koneksi Postgre SQL Anda. Misalnya, jika nilai endpoint adalahmycluster.cluster-123456789012.us-east-1.rds.amazonaws.com, maka Anda menentukan nilai-nilai berikut dalam string koneksi PostgreSQL:

Untuk host atau nama host, tentukan mycluster.cluster-123456789012.us-east-1.rds.amazonaws.com
Untuk port, tentukan 5432 atau nilai port yang Anda gunakan saat Anda membuat klaster DB

Titik akhir klaster menghubungkan Anda ke instans primer untuk klaster DB. Anda dapat melakukan operasi baca dan tulis menggunakan titik akhir klaster. Klaster DB Anda juga dapat memiliki hingga 15 Replika Aurora yang mendukung akses hanya baca ke data di klaster DB Anda. Setiap instans DB dalam klaster Aurora (yaitu, instans primer dan setiap Replika Aurora) memiliki titik akhir unik yang independen dari titik akhir klaster. Titik akhir unik ini memungkinkan Anda terhubung ke instans DB tertentu dalam klaster secara langsung. Titik akhir klaster selalu mengarah ke instans primer. Jika instans primer gagal dan diganti, titik akhir klaster mengarah ke instans primer baru.

Untuk melihat titik akhir cluster (titik akhir penulis), pilih Database di RDS konsol Amazon dan pilih nama cluster DB untuk menampilkan detail cluster DB.

Utilitas koneksi untuk Aurora Postgre SQL

Beberapa utilitas koneksi yang dapat Anda gunakan adalah sebagai berikut:

Baris perintah - Anda dapat terhubung ke cluster Aurora Postgre SQL DB dengan menggunakan alat seperti psql, terminal interaktif Postgre. SQL Untuk informasi lebih lanjut tentang penggunaan terminal SQL interaktif Postgre, lihat psql di dokumentasi Postgre. SQL
GUI— Anda dapat menggunakan pgAdmin utilitas untuk terhubung ke cluster Aurora Postgre SQL DB dengan menggunakan antarmuka UI. Untuk informasi selengkapnya, lihat halaman Unduh dari pgAdmin situs web.
AWS driver:

Menghubungkan ke Aurora Postgre SQL dengan Driver Amazon Web Services ()AWS JDBC

JDBCDriver Amazon Web Services (AWS) dirancang sebagai JDBC pembungkus canggih. Pembungkus ini melengkapi dan memperluas fungsionalitas JDBC driver yang ada untuk membantu aplikasi memanfaatkan fitur database berkerumun seperti Aurora Postgre. SQL Driver ini kompatibel dengan JDBC driver pg komunitas.

Untuk menginstal AWS JDBC Driver, tambahkan file AWS JDBC Driver .jar (terletak di aplikasiCLASSPATH), dan simpan referensi ke driver JDBC komunitas pg. Perbarui URL awalan koneksi dari jdbc:postgresql:// kejdbc:aws-wrapper:postgresql://.

Untuk informasi selengkapnya tentang AWS JDBC Driver dan petunjuk lengkap untuk menggunakannya, lihat GitHub repositori JDBC Driver Amazon Web Services (AWS).

Menghubungkan ke Aurora Postgre SQL dengan Driver Python Amazon Web Services ()AWS

Untuk informasi selengkapnya tentang Driver AWS Python dan petunjuk lengkap untuk menggunakannya, lihat repositori Amazon Web Services ()AWS Python Driver. GitHub

Menghubungkan ke Aurora Postgre SQL dengan Amazon Web Services ()AWS Advanced NodeJS Wrapper

AWS Advanced NodeJS Wrapper melengkapi dan memperluas fungsionalitas driver NodeJS yang ada. Ini membantu aplikasi memanfaatkan fitur database berkerumun seperti Aurora Postgre. SQL

Untuk informasi selengkapnya tentang AWS Advanced NodeJS Wrapper dan petunjuk lengkap untuk menggunakannya, lihat repositori Amazon Web Services (AWS) Advanced NodeJS Wrapper. GitHub

Pemecahan masalah kegagalan koneksi Aurora

Penyebab umum kegagalan koneksi ke klaster DB Aurora baru adalah sebagai berikut:

Grup keamanan di VPC tidak mengizinkan akses — VPC Kebutuhan Anda untuk mengizinkan koneksi dari perangkat Anda atau dari EC2 instans Amazon dengan konfigurasi yang tepat dari grup keamanan diVPC. Untuk mengatasinya, ubah aturan Inbound grup Keamanan Anda VPC untuk mengizinkan koneksi. Sebagai contoh, lihat Tutorial: Membuat VPC untuk digunakan dengan klaster DB (khusus IPv4).
Port diblokir oleh aturan firewall – Periksa nilai port yang dikonfigurasi untuk klaster DB Aurora Anda. Jika aturan firewall memblokir port tersebut, Anda dapat membuat ulang instans menggunakan port yang berbeda.
IAMKonfigurasi tidak lengkap atau salah — Jika Anda membuat instans Aurora DB Anda untuk IAM menggunakan otentikasi berbasis —, pastikan itu dikonfigurasi dengan benar. Untuk informasi selengkapnya, lihat Autentikasi basis data IAM.

Untuk informasi selengkapnya tentang pemecahan masalah koneksi Aurora DB, lihat Tidak dapat terhubung ke instans DB Amazon RDS.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Menciptakan sumber daya dengan AWS CloudFormation

Grup parameter