Menghubungkan ke klaster DB Amazon Aurora - Amazon Aurora
Menghubungkan ke cluster Aurora DB dengan driver AWSMenghubungkan ke Aurora MySQLMenghubungkan ke Aurora PostgreSQLPemecahan masalah koneksi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menghubungkan ke klaster DB Amazon Aurora

Anda dapat menghubungkan ke klaster DB Aurora menggunakan alat yang sama yang Anda gunakan untuk menghubungkan ke basis data MySQL atau PostgreSQL. Anda menentukan string koneksi dengan skrip, utilitas, atau aplikasi apa pun yang terhubung ke instans DB MySQL atau PostgreSQL. Anda menggunakan kunci publik yang sama untuk koneksi Lapisan Soket Aman (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 klaster DB Aurora Serverless, Anda terhubung ke titik akhir basis data bukan instans DB. Anda dapat menemukan titik akhir basis data untuk klaster DB Aurora Serverless pada tab Konektivitas & keamanan di 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 VPC Amazon. Artinya, Anda mengakses titik akhir dari dalam VPC atau 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 masuk pada Grup keamanan untuk VPC untuk mengizinkan akses ke klaster DB Aurora spesifik. Untuk mempelajari lebih lanjut, termasuk cara mengonfigurasi VPC Anda untuk berbagai skenario klaster Aurora DB, lihat Amazon Virtual Private Cloud dan Amazon Aurora. VPCs

  • Akses cluster Aurora DB di luar VPC — Untuk mengakses cluster Aurora DB dari luar VPC, gunakan alamat titik akhir publik cluster DB.

Untuk informasi selengkapnya, lihat Pemecahan masalah kegagalan koneksi Aurora.

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) AWS Secrets Manager, dan 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 Pengemudi JDBC AWS Pengemudi Python AWS Driver ODBC untuk MySQL 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
Autentikasi IAM Ya Ya Ya Ya
Identitas Federasi (AD FS) Ya Ya Tidak Ya
Identitas Federasi (Okta) Ya Ya Ya Ya
Database Tanpa Batas Aurora PostgreSQL Ya (Aurora PostgreSQL saja) Tidak Tidak Ya (Aurora PostgreSQL saja)

Untuk informasi lebih lanjut tentang AWS driver, lihat driver bahasa yang sesuai untuk klaster Aurora MySQL atau Aurora PostgreSQL DB Anda.

Menghubungkan ke klaster DB Amazon Aurora MySQL

Untuk mengautentikasi ke cluster DB MySQL Aurora Anda, Anda dapat menggunakan nama pengguna MySQL dan otentikasi kata sandi atau otentikasi basis data (IAM). AWS Identity and Access Management Untuk informasi selengkapnya tentang menggunakan autentikasi nama pengguna dan kata sandi MySQL, lihat Access control and account management dalam dokumentasi MySQL. Untuk informasi selengkapnya tentang menggunakan autentikasi basis data IAM, lihat Autentikasi basis data IAM.

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

Saat Anda memiliki koneksi ke klaster DB Amazon Aurora dengan kompatibilitas MySQL 5.7, Anda dapat menjalankan perintah SQL yang kompatibel dengan MySQL versi 5.7. Untuk informasi selengkapnya tentang sintaksis SQL MySQL 5.7, lihat Panduan referensi MySQL 5.7. Untuk informasi tentang batasan yang berlaku untuk Aurora MySQL 5.7, lihat Aurora SQL Versi saya 2 kompatibel dengan My 5.7 SQL.

catatan

Untuk panduan berguna dan mendetail tentang menghubungkan ke klaster DB Amazon Aurora MySQL, Anda dapat melihat buku panduan Manajemen koneksi Aurora.

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

  • 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 klaster (titik akhir penulis), pilih Basis data di konsol Amazon RDS dan pilih nama klaster DB untuk menampilkan detail klaster DB.

Aurora MySQL writer endpoint detail panel menampilkan alamat koneksi untuk konektivitas database.

Utilitas koneksi untuk Aurora MySQL

Beberapa utilitas koneksi yang dapat Anda gunakan adalah sebagai berikut:

Menghubungkan ke Aurora MySQL dengan utilitas MySQL

Gunakan prosedur berikut: Prosedur ini mengasumsikan bahwa Anda mengonfigurasi klaster DB Anda di subnet privat di VPC Anda. 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 klaster DB menggunakan utilitas MySQL

  1. 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 ~]$

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

    Untuk parameter -h, ganti nama DNS titik akhir untuk instans primer 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

  3. 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)]>

  4. Masukkan perintah SQL Anda.

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

Amazon Web Services (AWS) JDBC Driver dirancang sebagai pembungkus JDBC tingkat lanjut. Pembungkus ini melengkapi dan memperluas fungsionalitas driver JDBC yang ada untuk membantu aplikasi memanfaatkan fitur database berkerumun seperti Aurora MySQL. Driver ini kompatibel dengan driver MySQL Connector/J driver and the community MariaDB Connector/J komunitas.

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

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

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

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

catatan

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

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

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 MySQL dengan Amazon Web Services () ODBC Driver untuk MySQL AWS

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

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

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

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

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 MySQL menggunakan SSL

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

Untuk terhubung menggunakan SSL, gunakan utilitas MySQL yang dijelaskan dalam prosedur berikut. Jika Anda menggunakan autentikasi basis data IAM, Anda harus menggunakan koneksi SSL. Untuk informasi, lihat Autentikasi basis data IAM.

catatan

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

Untuk terhubung ke klaster DB dengan SSL menggunakan utilitas MySQL

  1. Unduh kunci publik untuk sertifikat penandatanganan Amazon RDS.

    Untuk informasi tentang mengunduh sertifikat, lihat Menggunakan SSL/TLS untuk mengenkripsi koneksi ke .

  2. Ketikkan perintah berikut pada baris perintah untuk terhubung ke instans primer dari klaster DB dengan SSL menggunakan utilitas MySQL. Untuk parameter -h, ganti nama DNS titik akhir untuk instans primer Anda. Untuk parameter -u, ganti ID pengguna untuk akun pengguna basis data. Untuk parameter --ssl-ca, ganti nama file sertifikat SSL 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 output seperti yang 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 membuat string koneksi RDS for MySQL dan menemukan kunci publik untuk koneksi SSL, lihat Menghubungkan ke instans DB yang menjalankan mesin basis data MySQL.

Menghubungkan ke klaster DB Amazon Aurora PostgreSQL.

Anda dapat terhubung ke instans DB di klaster DB Amazon Aurora PostgreSQL menggunakan alat yang sama yang Anda gunakan untuk menghubungkan ke basis data PostgreSQL. Sebagai bagian dari hal ini, Anda menggunakan kunci publik yang sama untuk koneksi Lapisan Soket Aman (SSL). Anda dapat menggunakan informasi titik akhir dan port dari instans primer atau Replika Aurora di klaster DB Aurora PostgreSQL Anda dalam string koneksi skrip, utilitas, atau aplikasi apa pun yang terhubung ke instans DB PostgreSQL. Dalam string koneksi, tentukan alamat DNS dari instans primer atau titik akhir Replika Aurora sebagai parameter host. Tentukan nomor port dari titik akhir sebagai parameter port.

Saat Anda memiliki koneksi ke instans DB di klaster DB Amazon Aurora PostgreSQL, Anda dapat menjalankan perintah SQL apa pun yang kompatibel dengan PostgreSQL.

Dalam tampilan detail untuk klaster DB Aurora PostgreSQL, Anda dapat menemukan nama, status, jenis, dan nomor port titik akhir klaster. Anda menggunakan titik akhir dan nomor port di string koneksi PostgreSQL Anda. Misalnya, jika nilai titik akhir adalah mycluster.cluster-123456789012.us-east-1.rds.amazonaws.com, maka Anda menentukan 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 klaster (titik akhir penulis), pilih Basis data di konsol Amazon RDS dan pilih nama klaster DB untuk menampilkan detail klaster DB.

Titik akhir penulis Aurora PostgreSQL.

Utilitas koneksi untuk Aurora PostgreSQL

Beberapa utilitas koneksi yang dapat Anda gunakan adalah sebagai berikut:

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

Amazon Web Services (AWS) JDBC Driver dirancang sebagai pembungkus JDBC tingkat lanjut. Pembungkus ini melengkapi dan memperluas fungsionalitas driver JDBC yang ada untuk membantu aplikasi memanfaatkan fitur database berkerumun seperti Aurora PostgreSQL. Driver ini kompatibel dengan driver PgJDBC komunitas.

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

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

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

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 PostgreSQL dengan Amazon Web Services () Advanced NodeJS Wrapper AWS

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

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 Anda harus mengizinkan koneksi dari perangkat Anda atau dari EC2 instans Amazon dengan konfigurasi grup keamanan yang tepat di VPC. Untuk mengatasinya, modifikasi aturan masuk grup keamanan VPC Anda untuk mengizinkan koneksi. Sebagai contoh, lihat Tutorial: Buat VPC untuk digunakan dengan cluster DB (hanya) 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.

  • Konfigurasi IAM tidak lengkap atau salah – Jika Anda membuat instans DB Aurora Anda untuk menggunakan autentikasi berbasis IAM, pastikan bahwa autentikasi tersebut 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.