Catatan rilis Amazon Athena ODBC 2.x

• Memperbaiki masalah yang SQLColumns menyebabkan SQLTables dan menghilangkan tabel di luar 200 pertama dalam skema saat halaman hasil metadata kosong.

• Memperbaiki masalah yang menyebabkan pola filter string kosong dari ADO.NET aplikasi seperti Power BI mengembalikan nol baris alih-alih semua baris.

• Memperbaiki masalah yang SQLColumns menyebabkan kegagalan pada jenis kolom yang tidak dikenali driver, seperti uuid ataujson. Kolom-kolom ini sekarang dilaporkan sebagaiVARCHAR.

• Memperbaiki masalah yang menyebabkan koneksi yang menggunakan plugin SageMakerBrowserIdc otentikasi macet saat SSOEndpointOverride parameter SSOOIDCEndpointOverride atau disetel.

• Memperbaiki masalah yang menyebabkan koneksi melalui server proxy gagal dengan kesalahan resolusi DNS saat proxy melakukan resolusi DNS. Klien HTTP yang AWS dibuat SDK secara internal sekarang menggunakan konfigurasi proxy dari DSN Anda.

  catatan

  Pada Windows, driver sekarang memverifikasi sertifikat SSL terhadap penyimpanan sertifikat sistem Windows dan tidak menggunakan TrustedCerts parameter.

• Memperbaiki masalah yang menyebabkan verifikasi sertifikat TLS gagal pada beberapa distribusi Linux ketika TrustedCerts parameter tidak disetel. Driver sekarang menemukan bundel CA saat runtime dan menghormati variabel CURL_CA_BUNDLE dan SSL_CERT_FILE lingkungan.

• Memperbaiki masalah yang menyebabkan driver mengirim permintaan ke penyedia identitas tanpa User-Agent header.

  penting

  Tindakan diperlukan: Rilis ini mengubah nilai User-Agent header yang dikirim driver pada permintaan ke AWS layanan dan penyedia identitas, kecuali permintaan Windows Integrated Authentication, yang terus menggunakan User-Agent nilai browser. Jika Anda mencocokkan User-Agent nilai pengemudi dalam kondisi aws:UserAgent kebijakan IAM, filter log, atau aturan masuk penyedia identitas, perbarui agar sesuai. *lib/AmazonAthenaODBC#*

• Memperbaiki masalah yang menyebabkan beberapa permintaan otentikasi berbasis browser gagal karena Content-Length header yang hilang.

• Memperbaiki masalah yang menyebabkan parameter kueri terpotong saat Anda menggunakan SQL_C_WCHAR binding.

• File lisensi sekarang menyertakan referensi ke Ket AWS entuan Layanan.

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

• 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.

• Penginstal universal macOS — Driver macOS sekarang didistribusikan sebagai biner universal tunggal yang mendukung arsitektur ARM dan Intel, menyederhanakan instalasi di semua perangkat keras Mac.

• Migrasi klien HTTP — Menghapus ketergantungan libcurl dari binari ODBC dengan bermigrasi ke klien HTTP AWS SDK CRT. Klien CRT menggunakan tumpukan TLS asli platform dan penyimpanan kepercayaan sistem, meningkatkan keandalan koneksi dan menghilangkan dependensi transitif pada OpenSSL dan zlib.

• Menambahkan ExternalId dukungan untuk STS AssumeRole untuk asumsi peran lintas akun. ExternalIdDibaca dari konfigurasi AWS profil.

• Validasi sertifikat SSL diaktifkan secara default — Driver sekarang memberlakukan verifikasi sertifikat SSL saat menghubungkan ke penyedia identitas. Jika Anda menggunakan penyedia identitas lokal tanpa sertifikat SSL yang valid, Anda harus secara eksplisit SSL_Insecure=1 mengatur string koneksi Anda. Untuk informasi selengkapnya, lihat SSL tidak aman (iDP).

• Minimum TLS 1.2 diberlakukan — Pengemudi tidak lagi menerima koneksi TLS 1.0 atau TLS 1.1 ke penyedia identitas. Semua koneksi IdP sekarang memerlukan TLS 1.2 atau yang lebih baru.

• Alur otentikasi BrowsersSooIDC diperbarui - Plugin BrowsersSooIDC sekarang menggunakan Kode Otorisasi dengan PKCE alih-alih Otorisasi Kode Perangkat. Parameter opsional baru listen_port (default 7890) tersedia untuk server callback OAuth 2.0. Anda mungkin perlu mengizinkannya daftar port ini di jaringan Anda. Cakupan default telah berubah menjadisso:account:access. Untuk informasi selengkapnya, lihat Browser SSO OIDC.

• BrowsersSooIDC — Dimigrasi dari aliran Kode Perangkat ke Kode Otorisasi dengan PKCE untuk meningkatkan keamanan.

• BrowserAzureAD — Menambahkan PKCE (Proof Key for Code Exchange) ke aliran otorisasi OAuth 2.0 untuk mencegah serangan intersepsi kode otorisasi.

• BrowserSaml — Menambahkan perlindungan RelayState CSRF untuk mencegah serangan injeksi token SAML.

• Cache kredenSIAL — Mulai dari v2.1.0.0, kredenSIAL yang di-cache disimpan sebagai JSON plaintext di user-profile/.athena-odbc/ direktori dengan izin file terbatas pada pengguna pemilik, konsisten dengan bagaimana AWS CLI melindungi kredenSIAL yang disimpan secara lokal.

• Profil IAM - Menambahkan dukungan untuk EcsContainer dan sumber Environment kredensi selain yang sudah ada. Ec2InstanceMetadata

• Pengurai string koneksi - Menerapkan penanganan escape ODBC }} yang tepat.

• Kueri katalog - Menambahkan pengidentifikasi SQL yang lolos untuk nama skema dan pola tabel.

• Pencocokan pola ODBC — Diganti pencocokan berbasis regex dengan pencocokan wildcard LIKE ODBC langsung.

• XML parsing - Menambahkan batas kedalaman rekursi (level 100) dan batas ukuran (1MB) untuk token SAML.

• Otentikasi ADFS — Menambahkan batas ukuran respons (200KB) untuk respons server ADFS.

• Memperbaiki netralisasi yang tidak tepat dari elemen khusus dalam komponen otentikasi yang dapat memungkinkan eksekusi kode atau pengalihan aliran otentikasi melalui parameter koneksi yang dibuat. Mempengaruhi plugin BrowsersSooidc, BrowserAzure AD, dan BrowserSaml.

• Memperbaiki netralisasi yang tidak tepat dari elemen khusus dalam komponen pemrosesan kueri yang dapat memungkinkan penolakan layanan atau injeksi SQL melalui metadata tabel yang dibuat.

• Memperbaiki validasi sertifikat yang tidak tepat saat menghubungkan ke penyedia identitas.

• Memperbaiki kontrol keamanan otentikasi yang hilang dalam aliran otentikasi berbasis browser, termasuk PKCE untuk OAuth, perlindungan CSRF untuk SAML, caching kredensi aman, dan pengikatan port callback eksklusif.

• Memperbaiki konsumsi sumber daya yang tidak terkontrol dalam komponen parsing yang dapat memungkinkan penolakan layanan melalui pola input yang dibuat, respons server yang tidak terbatas, atau muatan XML yang sangat bersarang.

• Memperbaiki masalah di mana SQLColumns dan SQLTables tidak menghasilkan hasil saat menggunakan UseSingleCatalogAndSchema=1 katalog federasi lintas akun dalam mode Impor Power BI.

• Plugin otentikasi Propagasi Identitas Tepercaya Browser - Menambahkan plugin otentikasi baru untuk mendukung otentikasi OpenID Connect (OIDC) berbasis browser dengan propagasi identitas tepercaya. Plugin ini memberikan pengalaman otentikasi yang mulus dengan menangani aliran OAuth 2.0 lengkap melalui browser default Anda, secara otomatis mengambil Token Web JSON (JWT), dan mengintegrasikan dengan propagasi identitas tepercaya. Plugin ini dirancang khusus untuk lingkungan desktop pengguna tunggal. Untuk informasi tentang mengaktifkan dan menggunakan propagasi identitas tepercaya, lihat Apa itu propagasi identitas tepercaya? .

• Kerangka pencatatan yang disempurnakan — Secara signifikan meningkatkan mekanisme logging pengemudi dengan:

  • Memperkenalkan level log yang lebih terperinci di luar 0/1 opsi dasar

  • Menghapus pernyataan log yang berlebihan

  • Mengoptimalkan kerangka kerja logging untuk memasukkan informasi yang relevan secara diagnostik

  • Mengatasi masalah kinerja yang menyebabkan penundaan operasional

  • Mengurangi pembuatan file log yang berlebihan saat logging diaktifkan

• Pengoptimalan pengambil hasil — Memperbaiki masalah di mana batasan parameter ukuran pengambilan salah diterapkan pada pengambil hasil streaming dan non-streaming. Batasan sekarang diterapkan dengan benar hanya untuk pengambil hasil non-streaming.

Driver Amazon Athena ODBC v2.0.5.1 berisi perbaikan berikut untuk plugin otentikasi berbasis browser.

• Validasi yang diterapkan untuk URL login dan pemeriksaan skema.

• Peningkatan mekanisme peluncuran browser di Linux untuk memanfaatkan API sistem, menghasilkan peningkatan stabilitas dan keamanan.

• Plugin otentikasi JWT Trusted Identity Provider (TIP) - Menambahkan plugin otentikasi baru untuk mendukung integrasi JWT Trusted Identity Provider (TIP) dengan driver ODBC. 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 TIP, konteks identitas ditambahkan ke peran IAM untuk mengidentifikasi pengguna yang meminta akses ke AWS sumber daya. Untuk informasi tentang mengaktifkan dan menggunakan TIP, lihat Apa itu Propagasi Identitas Tepercaya? .

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

• AWS Pembaruan versi SDK - Kami telah memperbarui versi AWS SDK yang digunakan dalam driver ke 2.32.16 dan telah memperbarui dependensi proyek untuk rilis 2.0.5.0.

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

• Curl Library telah diperbarui ke 8.12.1.

• Konfigurasi proxy tetap untuk profil IAM saat menghubungkan ke STS. Perbaikan memungkinkan Profil IAM digunakan untuk otentikasi yang berhasil.

• Baca semua opsi konfigurasi tambahan untuk profil IAM dengan plugin otentikasi. Ini termasukUseProxyForIdP,SSL_Insecure,LakeformationEnabled, dan LoginToRP untuk menyelesaikan kesalahan konfigurasi untuk plugin yang terpengaruh.

• Memperbaiki fungsi putaran dengan memungkinkannya mengambil parameter ke-2 opsional. Ini berhasil memproses kueri yang berisi sintaks escape.

• Ukuran kolom tetap untuk TIME WITH TIME ZONE dan TIMESTAMP WITH TIME ZONE tipe data. Nilai dengan stempel waktu dan tipe data zona waktu tidak akan terpotong.

• Menambahkan dukungan MFA untuk plugin otentikasi Okta di platform Linux dan Mac.

• Baik per athena-odbc.dll pustakaan dan peng AmazonAthenaODBC-2.x.x.x.msi instal untuk Windows sekarang ditandatangani.

• Memperbarui cacert.pem file sertifikat CA yang diinstal dengan driver.

• Meningkatkan waktu yang diperlukan untuk membuat daftar tabel di bawah katalog Lambda. Untuk jenis LAMBDA katalog, driver ODBC sekarang dapat mengirimkan ku SHOW TABLES eri untuk mendapatkan daftar tabel yang tersedia. Untuk informasi selengkapnya, lihat Gunakan kueri untuk daftar tabel.

• Memperkenalkan parameter UseWCharForStringTypes koneksi untuk melaporkan tipe data string menggunakan SQL_WCHAR danSQL_WVARCHAR. Untuk informasi selengkapnya, lihat Gunakan WCHAR untuk jenis string.

• Memperbaiki peringatan kerusakan registri yang terjadi saat Get-OdbcDsn PowerShell alat digunakan.

• Memperbarui logika penguraian untuk menangani komentar di awal string kueri.

• Jenis data tanggal dan stempel waktu sekarang mengizinkan nol di bidang tahun.

• Menambahkan dua parameter koneksi, StringColumnLength danComplexTypeColumnLength, yang dapat Anda gunakan untuk mengubah panjang kolom default untuk string dan tipe data kompleks. Untuk informasi selengkapnya, lihat Panjang kolom string dan Panjang kolom tipe kompleks.

• Dukungan telah ditambahkan untuk sistem operasi Linux dan macOS (Intel dan ARM). Untuk informasi selengkapnya, lihat Linux dan macOS.

• AWS-SDK-CPP telah diperbarui ke versi tag 1.11.245.

• Pustaka curl telah diperbarui ke versi 8.6.0.

• Menyelesaikan masalah yang menyebabkan nilai yang salah dilaporkan dalam metadata set hasil untuk tipe data seperti string di kolom presisi.

• Peningkatan keamanan utas driver ODBC untuk semua antarmuka.

• Saat logging diaktifkan, nilai datetime sekarang direkam dengan presisi milidetik.

• Selama otentikasi dengan Browser SSO OIDC plugin, terminal sekarang terbuka untuk menampilkan kode perangkat kepada pengguna.

• Menyelesaikan masalah rilis memori yang terjadi saat mengurai hasil dari API streaming.

• Permintaan untuk antarmukaSQLTablePrivileges(),SQLSpecialColumns(),SQLProcedureColumns(), dan SQLProcedures() sekarang mengembalikan set hasil kosong.

• Fitur cache file ditambahkan untuk Browser Azure AD, Browser SSO OIDC, dan plugin otentikasi berbasis browser Okta.

  Alat BI seperti Power BI dan plugin berbasis browser menggunakan beberapa jendela browser. Parameter koneksi cache file baru memungkinkan kredenSIAL sementara untuk di-cache dan digunakan kembali antara beberapa proses yang dibuka oleh aplikasi BI.

• Aplikasi sekarang dapat menanyakan informasi tentang set hasil setelah pernyataan disiapkan.

• Koneksi default dan batas waktu permintaan telah ditingkatkan untuk digunakan dengan jaringan klien yang lebih lambat. Untuk informasi selengkapnya, lihat Batas waktu koneksi dan Batas waktu permintaan.

• Penggantian titik akhir telah ditambahkan untuk SSO dan SSO OIDC. Untuk informasi selengkapnya, lihat Pengganti titik akhir.

• Menambahkan parameter koneksi untuk meneruskan argumen URI untuk permintaan otentikasi ke Ping. Anda dapat menggunakan parameter ini untuk melewati batasan peran tunggal Formasi Danau. Untuk informasi selengkapnya, lihat Param URI Ping.

• Memperbaiki masalah luapan bilangan bulat yang terjadi saat menggunakan mekanisme pengikatan berbasis baris.

• Menghapus batas waktu dari daftar parameter koneksi yang diperlukan untuk plugin otentikasi Browser SSO OIDC.

• Menambahkan antarmuka yang hilang untuk SQLStatistics() SQLPrimaryKeys()SQLForeignKeys(),,SQLColumnPrivileges(), dan, dan menambahkan kemampuan untuk mengembalikan set hasil kosong berdasarkan permintaan.

• Menambahkan URI logging ke plugin otentikasi Okta.

• Menambahkan parameter peran yang disukai ke plugin penyedia kredenSIAL eksternal.

• Menambahkan penanganan untuk awalan profil dalam nama profil file AWS konfigurasi.

• Memperbaiki masalah Wilayah AWS penggunaan yang terjadi saat bekerja dengan Formasi Danau dan AWS STS klien.

• Memulihkan kunci partisi yang hilang ke daftar kolom tabel.

• Menambahkan jenis BrowserSSOOIDC otentikasi yang hilang ke AWS profil.