Catatan rilis Amazon Athena JDBC 3.x

Pembaruan keamanan - Rilis ini meningkatkan Netty ketergantungan yang dibundel dari 4.1.133.Final ke 4.1.135.Final, yang mencakup perbaikan keamanan. Untuk membantu menjaga koneksi Anda ke Athena tetap aman, kami sarankan untuk meningkatkan ke versi driver ini.

Dukungan proxy untuk DataZone otentikasi Amazon — Penyedia kreden DataZone tif Amazon IAM dan Amazon DataZone IAM Identity Center sekarang merutekan panggilan jaringan mereka melalui proxy yang dikonfigurasi. Ini menyelesaikan kegagalan koneksi ke titik akhir Amazon DataZone dan IAM Identity Center di lingkungan tempat proxy menangani resolusi DNS.

Propagasi identitas tepercaya di AWS GovCloud (AS) — Penyedia konteks Pusat Identitas IAM sekarang memperoleh partisinya dari peran akses terselesaikan ARN. Ini menyelesaikan kegagalan otentikasi untuk propagasi identitas tepercaya di Wil AWS GovCloud ayah (AS).

Multi-catalog browsing - Menambahkan dukungan penelusuran multi-katalog untuk fitur rumah danau. Driver sekarang dapat menemukan dan terhubung ke semua katalog di lingkungan katalog federasi, memungkinkan penggunaan Tabel S3 dan federasi katalog melalui Amazon Athena.

Plugin otentikasi SSO OIDC Browser - Menambahkan plugin otentikasi baru untuk AWS Identity and Access Management Identity Center. Plugin ini memungkinkan otentikasi masuk tunggal berbasis browser yang mulus menggunakan Kode Otorisasi dengan aliran PKCE. Untuk informasi selengkapnya, lihat Kredensi Browser SSO OIDC.

SageMaker otentikasi - Menambahkan dukungan untuk menghubungkan menggunakan DataZoneProjectId plugin SageMakerBrowserIdc dan SageMakerIam otentikasi. Anda sekarang dapat terhubung ke SageMaker proyek Anda dan bekerja dengan data dari alat pihak ketiga pilihan Anda. Untuk informasi selengkapnya, lihat SageMaker Penyedia KredenSIAL IDC Browser dan SageMaker Penyedia KredenSIAL IAM.

Caching otentikasi browser - Menambahkan dukungan caching token dalam memori ke plugin otentikasi BrowserSaml dan BrowserAzure AD. Ketika EnableTokenCaching disetel ketrue, driver menyimpan token otentikasi di seluruh koneksi, mengurangi jumlah prompt otentikasi browser.

AWS Pembaruan versi SDK - Kami telah memperbarui versi AWS SDK yang digunakan dalam driver ke 2.46.3 dan telah memperbarui dependensi proyek untuk rilis 3.8.0.

Penanganan tanggal dan waktu — Driver sekarang menangani tanggal pra-Gregorian dengan benar, transisi waktu musim panas, konversi zona waktu, dan presisi nanodetik dalam nilai tanggal, waktu, dan stempel waktu.

Pernyataan yang disiapkan — Pernyataan yang disiapkan sekarang berfungsi dengan benar ketika komentar baris terakhir hadir.

Karakter khusus dalam nama tabel — getColumns Metode getTables dan sekarang benar menangani nama tabel yang berisi karakter khusus seperti+,$, atau..

ResultSet.getObject— ResultSet.getObject() sekarang melempar al SQLException ih-alih NullPointerException atauClassCastException, sesuai dengan spesifikasi JDBC.

OutputLocation kompatibilitas — Parameter s3_staging_dir koneksi dari driver 2.x sekarang dikenali dengan benar sebagai alias untukOutputLocation.

Siklus hidup koneksi — Driver sekarang mematikan kumpulan utas internal dengan benar saat koneksi ditutup atau saat batas waktu jaringan diubah, mencegah kebocoran utas.

Browser OIDC Plugin otentikasi propagasi identitas tepercaya - Menambahkan plugin otentikasi baru yang memungkinkan otentikasi berbasis browser tanpa batas dengan penyedia identitas OpenID Connect (OIDC). Plugin ini menangani aliran OAuth 2.0 lengkap melalui browser default Anda, secara otomatis mengambil JSON Web Token (JWT), dan terintegrasi dengan propagasi identitas tepercaya. Dirancang khusus untuk lingkungan desktop pengguna tunggal, ini memberikan pengalaman otentikasi yang lebih efisien dibandingkan dengan penanganan JWT manual. Untuk informasi selengkapnya tentang propagasi identitas tepercaya, lihat Apa itu propagasi identitas tepercaya? .

Dukungan presisi stempel waktu yang ditingkatkan - Driver sekarang sepenuhnya mendukung presisi milidetik dan nanodetik dalam nilai stempel waktu yang dikembalikan dari kueri Athena melalui metode. getTimestamp()

Peningkatan penanganan tipe kompleks - Memperbaiki masalah dengan penguraian tipe data bersarang (array, struct, dan peta) di kedua operasi metadata DatabaseMetaData#getColumns dan umum, memastikan informasi tipe yang akurat untuk struktur data yang kompleks.

Peningkatan pencatatan kesalahan — Peningkatan pencatatan untuk kegagalan pengambilan metadata S3, memberikan pesan kesalahan yang lebih jelas dan informasi diagnostik yang lebih baik.

Plugin otentikasi propagasi identitas terpercaya JWT - Menambahkan plugin otentikasi baru untuk mendukung integrasi propagasi identitas tepercaya JWT dengan driver JDBC. Jenis otentikasi ini memungkinkan Anda untuk menggunakan token web JSON (JWT) yang diperoleh dari penyedia identitas eksternal sebagai parameter koneksi untuk mengotentikasi dengan Athena. Dengan propagasi identitas tepercaya, konteks identitas ditambahkan ke peran IAM untuk mengidentifikasi pengguna yang meminta akses ke AWS sumber daya. Untuk informasi tentang mengaktifkan dan menggunakan propagasi identitas tepercaya, lihat Apa itu propagasi identitas tepercaya? .

Dukungan titik akhir SSO OIDC dan SSO admin khusus - Menambahkan dukungan untuk titik akhir SSO OIDC dan SSO Admin kustom di driver JDBC. Peningkatan ini memungkinkan Anda menentukan titik akhir Anda sendiri untuk layanan SSO saat menjalankan JDBC di belakang VPC.

AWS Pembaruan versi SDK - Kami telah memperbarui versi AWS SDK yang digunakan di driver ke 2.32.16 dan telah memperbarui dependensi proyek untuk rilis 3.6.0.

Kemampuan logging — Peningkatan pencatatan pengambilan S3 dengan meningkatkan level log ke INFO dan menambahkan metrik untuk jumlah baris, offset, dan panjang objek. Melaksanakan pelacakan siklus hidup koneksi dan kinerja pencatatan keseluruhan yang dioptimalkan.

Penanganan karakter khusus - Peningkatan penanganan karakter khusus untuk LIKE pola dalam skema dan nama katalog.

Manajemen status koneksi — Peningkatan manajemen status koneksi untuk mencegah potensi kesalahan dengan mencegah panggilan API setelah penutupan koneksi dan menambahkan pemeriksaan keamanan untuk operasi kueri selama shutdown.

Metadata kueri DDL - Memperbaiki NoSuchKeyFound masalah dengan penanganan metadata kueri DDL.

Parameter konfigurasi hasil - Menambahkan dukungan untuk dua parameter koneksi baru ExpectedBucketOwner danAclOption. Untuk informasi selengkapnya, lihat Parameter konfigurasi hasil.

AWS Versi SDK - Versi AWS SDK yang digunakan dalam driver telah diperbarui ke 2.30.22.

Result Fetcher — Driver sekarang secara otomatis memilih metode tercepat untuk mengunduh hasil kueri. Ini menghilangkan kebutuhan untuk mengkonfigurasi fetcher secara manual di sebagian besar situasi. Untuk informasi selengkapnya, lihat Parameter pengambilan hasil.

ResultSet— Driver sekarang menangani iterasi pada kumpulan hasil pernyataan DDL yang tidak menghasilkan objek hasil di S3. Ini juga mengembalikan ResultSet objek kosong alih-alih null ketika GetQueryResultsStream mengembalikan halaman yang benar-benar kosong.

ResultsStream— Streaming hasil telah dioptimalkan dengan menghapus panggilan yang tidak perlu untuk menghitung jumlah baris dalam buffer internal.

GetTables — Pang GetTables gilan telah dioptimalkan dengan menangani jenis tabel berdasarkan ListTableMetadata dan GetTableMetadata tanggapan.

DataZone otentikasi - Menambahkan dukungan untuk plugin DataZone otentikasi DataZoneIdC danDataZoneIAM. Untuk informasi selengkapnya, lihat SageMaker Penyedia KredenSIAL IDC Browser dan SageMaker Penyedia KredenSIAL IAM.

Batas waktu jaringan — Batas waktu jaringan sekarang dapat diatur menggunakan parameter NetworkTimeoutMillis koneksi. Sebelumnya bisa diatur hanya pada Connection objek itu sendiri. Untuk informasi selengkapnya, lihat Batas waktu jaringan.

Penanganan objek kosong S3 — Driver sekarang menangani objek kosong di pengambil S3 alih-alih melemparkan pengecualian Amazon S3 R ange Not Satisfiable.

Logging — Driver tidak lagi mencatat pesan I tem yang diminta untuk eksekusi kueri [...], tetapi langganan dibatalkan setelah mengkonsumsi hasil kueri.

String parameter kosong - Driver sekarang menangani string kosong yang ada dalam parameter koneksi seolah-olah parameter tidak ada. Ini menyelesaikan masalah yang terjadi ketika beberapa alat BI secara tidak sengaja meneruskan string kosong yang menyebabkan upaya otentikasi yang tidak diinginkan.

Pemetaan tipe data - Meningkatkan kepatuhan dengan spesifikasi JDBC dengan mengubah cara driver memetakantinyint,, smallintrow, dan tipe struct data ke objek Java.

AWS Pembaruan versi SDK - Versi AWS SDK yang digunakan dalam driver telah diperbarui ke 2.26.23.

Komentar - Memperbaiki masalah dengan komentar baris di akhir pernyataan.

Daftar database - Memperbaiki masalah di mana database daftar dapat memasuki loop tak terbatas ketika halaman terakhir yang dikembalikan oleh ListDatabases API berpaginasi kosong.

Penyedia kredenSIAL JWT - Menambahkan dukungan untuk durasi sesi yang ditentukan pengguna. Untuk informasi selengkapnya, lihat Durasi sesi peran.

Kumpulan ut as — Dibuat satu ThreadPoolExecutor per koneksi untuk tugas asinkron untuk menghindari penggunaan kumpulan. ForkJoin

Penyedia kredensi — Host proxy sekarang diurai untuk mendapatkan skema dan host ketika klien HTTP dikonfigurasi untuk eksternal. IdPs

Penyedia kreden SIAL default — Memastikan penyedia kredenSIAL default tidak dapat ditutup oleh kode klien.

getColum ns - Memper ORDINAL_COLUMN baiki masalah properti kolom dalam DatabaseMetaData#getColumns metode.

ResultSet- Menambahkan dukungan untuk Infinity-Infinity,, dan NaN Memper ResultSet. baiki perbedaan antara jenis kolom yang dikembalikan dari operasi katalog dan kumpulan hasil dari kueri yang diselesaikan.

Kinerja operasi katalog — Kinerja telah ditingkatkan untuk operasi katalog yang tidak menggunakan karakter wildcard.

Perubahan interval polling minimum — Default interval polling minimum telah dimodifikasi untuk mengurangi jumlah panggilan API yang dilakukan driver ke Athena. Penyelesaian kueri masih terdeteksi sesegera mungkin.

Kemampuan penemuan alat BI — Driver telah dibuat lebih mudah ditemukan untuk alat intelijen bisnis.

Pemetaan tipe data - Pemetaan tipe data ke Athenabinary,array, dan tipe data struct DDL telah ditingkatkan.

AWS Versi SDK - Versi AWS SDK yang digunakan dalam driver telah diperbarui ke 2.25.34.

Daftar tabel katalog federasi — Memperbaiki masalah yang menyebabkan katalog federasi mengembalikan daftar tabel kosong.

GetSchemas — Memperbaiki masalah yang menyebabkan metode JDBC DatabaseMetaData #getSchemas mengambil database hanya dari katalog default, bukan dari semua katalog.

getColum ns — Memperbaiki masalah yang menyebabkan katalog null dikembalikan saat metode JDBC DatabaseMetaData #getColumns dipanggil dengan nama katalog null.

Dukungan ditambahkan untuk Microsoft Active Directory Federation Services (AD FS) Windows Otentikasi Terpadu dan otentikasi berbasis formulir.

Untuk kompatibilitas mundur dengan versi 2.x, sub-protokol awsathena JDBC sekarang diterima tetapi menghasilkan peringatan penghentian. Gunakan sub-protokol athena JDBC sebagai gantinya.

AwsDataCatalogsekarang default untuk parameter katalog, dan default merupakan default untuk parameter database. Perubahan ini memastikan bahwa nilai yang benar untuk katalog dan database saat ini dikembalikan, bukan null.

Sesuai dengan spesifikasi JDBC, IS_AUTOINCREMENT dan IS_GENERATEDCOLUMN sekarang mengembalikan string kosong alih-alih. NO

Tipe int data Athena sekarang dipetakan ke tipe JDBC yang sama dengan Athena, bukan integer ke. other

Ketika metadata kolom dari Athena tidak berisi opsional precision dan scale bidang, driver sekarang mengembalikan nol untuk nilai yang sesuai dalam ResultSet kolom.

Versi AWS SDK telah diperbarui ke 2.21.39.

Memperbaiki masalah GetQueryResultsStream yang menyebabkan pengecualian terjadi ketika hasil teks biasa dari Athena memiliki jumlah kolom yang tidak konsisten dengan jumlah kolom dalam metadata hasil Athena.