View a markdown version of this page

Mengakses Aurora DSQL dengan klien PostgreSQL-compatible - Amazon Aurora DSQL
Parameter sesiKlien SQLPemecahan masalah

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, AWS CloudShell seperti, psql, DBeaver, 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 bernama. admin Saat membuat peran basis data kustom, Anda harus menggunakan peran tersebut untuk mengaitkannya dengan admin peran IAM untuk mengautentikasi saat menghubungkan ke klaster Anda. Untuk informasi selengkapnya, lihat Menggunakan peran database dan otentikasi IAM.
Host (juga dikenal sebagai hostname atau hostspec) Titik Akhir klaster Aurora DSQL Kluster wilayah tunggal menyediakan satu titik akhir terkelola dan secara otomatis mengarahkan lalu lintas jika tidak tersedia di dalam Wilayah.
Port N/A — gunakan default 5432 Ini adalah PostgreSQL default.
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 SSL. require 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 menggunakan UTF-8 secara internal.
datestyle Pemformatan keluaran Menetapkan 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 Mengatur zona waktu untuk sesi tersebut. 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 perencana kueri jenis paket pemindaian bitmap.
enable_hashjoin Perencana kueri Mengaktifkan atau menonaktifkan penggunaan tipe paket hash-join oleh perencana kueri.
enable_indexonlyscan Perencana kueri Mengaktifkan atau menonaktifkan penggunaan perencana kueri jenis paket pemindaian hanya indeks.
enable_indexscan Perencana kueri Mengaktifkan atau menonaktifkan penggunaan tipe paket pemindaian indeks oleh perencana kueri.
enable_material Perencana kueri Mengaktifkan atau menonaktifkan penggunaan materialisasi perencana kueri.
enable_mergejoin Perencana kueri Mengaktifkan atau menonaktifkan penggunaan tipe paket gabungan gabungan oleh perencana kueri.
enable_nestloop Perencana kueri Mengaktifkan atau menonaktifkan penggunaan paket gabungan loop bersarang oleh perencana kueri.
enable_seqscan Perencana kueri Mengaktifkan atau menonaktifkan penggunaan tipe rencana pemindaian sekuensial 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, sehingga 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,, dan. tcp_keepalives_idle tcp_keepalives_interval tcp_keepalives_count

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

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

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

  • Parameter logging — Aurora DSQL mengelola logging secara internal, termasuk dan. log_statement client_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 menghubungkan menggunakan PostgreSQL AWS CloudShell dengan 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.

Topik

Pemecahan masalah

Kedaluwarsa kredensi otentikasi untuk Klien SQL

Sesi yang 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 ketika 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 Pemecahan Masalah dari dokumentasi Aurora DSQL.