View a markdown version of this page

Mengakses Aurora DSQL dengan klien PostgreSQL-compatible - Amazon Aurora DSQL

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

Mengakses Aurora DSQL dengan klien PostgreSQL-compatible

Aurora DSQL menggunakan protokol kawat PostgreSQL. Anda dapat terhubung ke PostgreSQL menggunakan berbagai alat dan klien, seperti, psql, D AWS CloudShell Beaver, dan. DataGrip Tabel berikut merangkum bagaimana Aurora DSQL memetakan parameter koneksi PostgreSQL umum:

PostgreSQL Aurora DSQL Catatan
Peran (juga dikenal sebagai Pengguna atau Grup) Peran Database Aurora DSQL menciptakan peran untuk Anda bernamaadmin. Saat Anda membuat peran database kustom, Anda harus menggunakan admin peran tersebut untuk mengaitkannya dengan peran IAM untuk otentikasi saat menghubungkan ke cluster Anda. Untuk informasi selengkapnya, lihat Menggunakan peran database dan otentikasi IAM.
Host (juga dikenal sebagai hostname atau hostspec) Titik Akhir klaster Aurora DSQL Cluster wilayah tunggal menyediakan titik akhir terkelola tunggal dan secara otomatis mengarahkan lalu lintas jika tidak ada ketersediaan di dalam Wilayah.
Port N/A — gunakan default 5432 Ini adalah default PostgreSQL.
Database (dbname) menggunakan postgres Aurora DSQL membuat database ini untuk Anda saat Anda membuat cluster.
Modus SSL SSL selalu diaktifkan di sisi server Di Aurora DSQL, Aurora DSQL mendukung Mode require SSL. Koneksi tanpa SSL ditolak oleh Aurora DSQL.
Kata Sandi Token Otentikasi Aurora DSQL membutuhkan token otentikasi sementara alih-alih kata sandi berumur panjang. Untuk mempelajari selengkapnya, lihat Menghasilkan token otentikasi di Amazon Aurora DSQL.

Saat menghubungkan, Aurora DSQL memerlukan token otentikasi IAM yang ditandatangani sebagai pengganti kata sandi tradisional. Token sementara ini dihasilkan menggunakan AWS Signature Version 4 dan hanya digunakan selama pembuatan koneksi. Setelah terhubung, sesi tetap aktif sampai berakhir atau klien terputus.

Jika Anda mencoba membuka sesi baru dengan token kedaluwarsa, permintaan koneksi gagal dan token baru harus dibuat. Untuk informasi selengkapnya, lihat Menghasilkan token otentikasi di Amazon Aurora DSQL.

Parameter sesi yang didukung

Aurora DSQL secara otomatis mengoptimalkan penyimpanan, manajemen koneksi, dan pemrosesan transaksi, sehingga mendukung serangkaian parameter sesi yang terfokus. Aurora DSQL menerima parameter yang tercantum dalam tabel berikut. Parameter di luar set ini mengembalikan kesalahan berikut:

ERROR: setting configuration parameter "parameter_name" not supported

Aurora DSQL mendukung parameter sesi PostgreSQL berikut. Kecuali dinyatakan lain, Anda dapat mengatur ini menggunakan SETSET SESSION,, atau sebagai opsi string koneksi. Anda juga dapat menggunakan SET LOCAL untuk mengatur salah satu parameter ini selama satu transaksi. Gunakan RESET untuk mengembalikan parameter ke nilai defaultnya.

Parameter sesi yang didukung
Parameter Kategori Deskripsi
application_name Identifikasi klien Menetapkan nama aplikasi yang dilaporkan dalam metadata koneksi. Berguna untuk mengidentifikasi koneksi dalam pemantauan.
client_encoding Lokalisasi Mengatur pengkodean karakter sisi klien. Database digunakan secara UTF-8 internal.
datestyle Pemformatan keluaran Mengatur format tampilan untuk nilai tanggal dan waktu (misalnya,ISO, MDY).
extra_float_digits Pemformatan keluaran Menetapkan jumlah digit yang ditampilkan untuk nilai floating-point. Beberapa driver, seperti JDBC, menggunakan parameter ini.
intervalstyle Pemformatan keluaran Menetapkan format tampilan untuk nilai interval.
timezone Lokalisasi Menetapkan zona waktu untuk sesi. Aurora DSQL menyimpan semua tanggal dan waktu yang sadar zona waktu secara internal di UTC. Parameter ini mengontrol bagaimana Aurora DSQL menampilkan nilai ke klien.
search_path Resolusi skema Menetapkan urutan pencarian skema untuk nama objek yang tidak memenuhi syarat.
enable_bitmapscan Perencana kueri Mengaktifkan atau menonaktifkan penggunaan jenis rencana pemindaian bitmap oleh perencana kueri.
enable_hashjoin Perencana kueri Mengaktifkan atau menonaktifkan penggunaan jenis paket hash-join oleh perencana kueri.
enable_indexonlyscan Perencana kueri Mengaktifkan atau menonaktifkan penggunaan tipe rencana pemindaian indeks oleh perencana kueri.
enable_indexscan Perencana kueri Mengaktifkan atau menonaktifkan penggunaan jenis paket pemindaian indeks oleh perencana kueri.
enable_material Perencana kueri Mengaktifkan atau menonaktifkan penggunaan perwujudan perencana kueri.
enable_mergejoin Perencana kueri Mengaktifkan atau menonaktifkan penggunaan jenis rencana gabungan gabungan oleh perencana kueri.
enable_nestloop Perencana kueri Mengaktifkan atau menonaktifkan penggunaan rencana gabungan loop bersarang oleh perencana kueri.
dsql.enable_batched_nestloop Perencana kueri Mengaktifkan atau menonaktifkan penggunaan rencana gabungan loop bersarang berkelompok oleh perencana kueri.
enable_seqscan Perencana kueri Mengaktifkan atau menonaktifkan penggunaan jenis rencana pemindaian berurutan oleh perencana kueri.
disable_sync_create_index Aurora DSQL-specific Mengontrol apakah CREATE INDEX berjalan secara asinkron. Defaultnya adalahon, artinya Aurora DSQL membuat indeks secara asinkron. Setel off untuk membuat indeks secara sinkron pada tabel kosong.
role Identitas sesi Menetapkan peran saat ini. Di Aurora DSQL, Anda hanya dapat mengatur parameter ini menggunakan SET LOCAL dalam blok transaksi.

Aurora DSQL secara otomatis mengelola aspek-aspek berikut dari database Anda, jadi Anda tidak perlu mengkonfigurasi parameter sesi PostgreSQL yang sesuai:

  • Parameter koneksi dan jaringan — Aurora DSQL mengelola siklus hidup koneksi dan pengaturan TCP secara internal, termasuk, tcp_keepalives_idletcp_keepalives_interval, dan. tcp_keepalives_count

  • Parameter memori dan sumber daya — Aurora DSQL secara otomatis mengelola alokasi memori, termasuk work_mem danshared_buffers.

  • Parameter batas waktu — Aurora DSQL memberlakukan batas durasi transaksinya sendiri, termasuk,statement_timeout, lock_timeout dan. idle_in_transaction_session_timeout

  • Parameter replikasi dan WAL — Aurora DSQL menangani replikasi secara otomatis melalui arsitektur Multi-wilayah bawaan, termasuk wal_level dan. synchronous_commit

  • Parameter logging — Aurora DSQL mengelola logging secara internal, termasuk log_statement danclient_min_messages.

  • Parameter transaksi — Aurora DSQL menggunakan tingkat REPEATABLE READ isolasi tetap untuk semua transaksi. Jika pengemudi Anda perlu menentukan tingkat isolasi, gunakanBEGIN ISOLATION LEVEL REPEATABLE READ.

Akses Aurora DSQL menggunakan klien SQL

Aurora DSQL mendukung beberapa PostgreSQL-compatible klien untuk menghubungkan ke cluster Anda. Bagian berikut menjelaskan cara terhubung menggunakan PostgreSQL dengan AWS CloudShell atau baris perintah lokal Anda, serta GUI-based alat seperti DBeaver dan. JetBrains DataGrip Setiap klien memerlukan token otentikasi yang valid seperti yang dijelaskan di bagian sebelumnya.

Pemecahan masalah

Kedaluwarsa kredentif otentikasi untuk Klien SQL

Sesi yang telah ditetapkan tetap diautentikasi selama maksimal 1 jam atau sampai pemutusan eksplisit atau batas waktu sisi klien terjadi. Jika koneksi baru perlu dibuat, token otentikasi baru harus dibuat dan disediakan di bidang Kata Sandi koneksi. Mencoba membuka sesi baru (misalnya, untuk membuat daftar tabel baru, atau membuka konsol SQL baru) memaksa upaya otentikasi baru. Jika token otentikasi yang dikonfigurasi dalam pengaturan Koneksi tidak lagi valid, sesi baru itu akan gagal dan semua sesi yang dibuka sebelumnya akan menjadi tidak valid. Ingatlah hal ini saat memilih durasi token otentikasi IAM Anda dengan expires-in opsi, yang dapat diatur ke 15 menit secara default dan dapat diatur ke nilai maksimum tujuh hari.

Selain itu, lihat bagian Pem ecahan Masalah dari dokumentasi Aurora DSQL.