Versionshinweise von Amazon Athena JDBC 3.x

Sicherheitsupdate — In dieser Version wird die im Paket enthaltene Netty Abhängigkeit von 4.1.133.Final auf 4.1.135.Final aktualisiert, was auch Sicherheitsupdates enthält. Um Ihre Verbindungen zu Athena sicher zu halten, empfehlen wir ein Upgrade auf diese Treiberversion.

Proxy-Unterstützung für die DataZone Amazon-Authentifizierung — Die Anmeldeinformationsanbieter für Amazon DataZone IAM und Amazon DataZone IAM Identity Center leiten ihre Netzwerkanrufe jetzt über den konfigurierten Proxy weiter. Dadurch werden Verbindungsfehler zu Amazon DataZone - und IAM Identity Center-Endpunkten in Umgebungen behoben, in denen ein Proxy die DNS-Auflösung übernimmt.

Vertrauenswürdige Identitätsverbreitung in AWS GovCloud (USA) — Der IAM Identity Center-Kontextanbieter leitet seine Partition jetzt vom ARN der aufgelösten Zugriffsrolle ab. Dadurch werden Authentifizierungsfehler bei der Verbreitung vertrauenswürdiger Identitäten in Regionen AWS GovCloud (USA) behoben.

Multi-catalog Surfen — Unterstützung für das Durchsuchen mehrerer Kataloge für Lakehouse-Funktionen hinzugefügt. Der Treiber kann jetzt alle Kataloge in Verbundkatalogumgebungen erkennen und eine Verbindung zu ihnen herstellen, was die Verwendung von S3-Tabellen und den Katalogverbund über Amazon Athena ermöglicht.

Browser SSO OIDC-Authentifizierungs-Plugin — Ein neues Authentifizierungs-Plugin für Identity Center wurde hinzugefügt. AWS Identity and Access Management Dieses Plugin ermöglicht eine nahtlose browserbasierte Single-Sign-On-Authentifizierung mithilfe des Autorisierungscodes mit PKCE-Flow. Weitere Informationen finden Sie unter SSO OIDC-Anmeldeinformationen für Browser.

SageMaker Authentifizierung — Unterstützung für die Verbindungsherstellung mithilfe der DataZoneProjectId Plug-ins SageMakerBrowserIdc und SageMakerIam zur Authentifizierung hinzugefügt. Sie können jetzt eine Verbindung zu Ihren SageMaker Projekten herstellen und mit den Daten Ihres bevorzugten Drittanbietertools arbeiten. Weitere Informationen erhalten Sie unter SageMaker Anbieter für Browser-IDC-Anmeldeinformationen und SageMaker Anbieter von IAM-Anmeldeinformationen.

Zwischenspeichern der Browserauthentifizierung — Den Plug-ins BrowserSaml und BrowserAzure AD-Authentifizierung wurde Unterstützung für In-Memory-Token-Caching hinzugefügt. Wenn auf gesetzt EnableTokenCaching isttrue, speichert der Treiber Authentifizierungstoken verbindungsübergreifend im Cache, wodurch die Anzahl der Aufforderungen zur Browserauthentifizierung reduziert wird.

AWS SDK-Versionsupdate — Wir haben die im Treiber verwendete AWS SDK-Version auf 2.46.3 aktualisiert und die Projektabhängigkeiten für Version 3.8.0 aktualisiert.

Verarbeitung von Datum und Uhrzeit — Der Treiber verarbeitet nun vorgregorianische Daten, Sommerzeitübergänge, Zeitzonenumrechnungen und die Genauigkeit von Datum, Uhrzeit und Zeitstempelwerten im Nanosekundenbereich korrekt.

Vorbereitete Anweisungen — Vorbereitete Anweisungen funktionieren jetzt korrekt, wenn Kommentare am Ende vorhanden sind.

Sonderzeichen in Tabellennamen — Die getColumns Methoden getTables und behandeln Tabellennamen, die Sonderzeichen wie+, oder . enthalten$, jetzt korrekt.

ResultSet.getObject— wirft ResultSet.getObject() jetzt SQLException statt NullPointerException oderClassCastException, entsprechend der JDBC-Spezifikation.

OutputLocation Kompatibilität — Der s3_staging_dir Verbindungsparameter aus dem 2.x-Treiber wird jetzt korrekt als Alias für erkannt. OutputLocation

Verbindungslebenszyklus — Der Treiber fährt interne Threadpools jetzt ordnungsgemäß herunter, wenn die Verbindung geschlossen wird oder wenn das Netzwerk-Timeout geändert wird, wodurch Threadlecks vermieden werden.

Browser OIDC Authentifizierungs-Plugin für vertrauenswürdige Identitätsverbreitung — Es wurde ein neues Authentifizierungs-Plugin hinzugefügt, das eine nahtlose browserbasierte Authentifizierung mit OpenID Connect (OIDC) -Identitätsanbietern ermöglicht. Dieses Plugin verarbeitet den kompletten OAuth 2.0-Fluss über Ihren Standardbrowser, ruft automatisch das JSON Web Token (JWT) ab und ist in die vertrauenswürdige Identitätsweitergabe integriert. Es wurde speziell für Einzelbenutzer-Desktop-Umgebungen entwickelt und bietet im Vergleich zur manuellen JWT-Verarbeitung ein optimiertes Authentifizierungserlebnis. Weitere Informationen zur Weitergabe vertrauenswürdiger Identitäten finden Sie unter Was ist Propagierung vertrauenswürdiger Identitäten? .

Verbesserte Unterstützung für Zeitstempelgenauigkeit — Der Treiber unterstützt jetzt vollständig die Genauigkeit von Millisekunden und Nanosekunden in Zeitstempelwerten, die von Athena-Abfragen über die Methode zurückgegeben werden. getTimestamp()

Verbesserte Verarbeitung komplexer Typen — Es wurden Probleme beim Analysieren verschachtelter Datentypen (Arrays, Strukturen und Maps) sowohl DatabaseMetaData#getColumns bei Vorgängen als auch bei allgemeinen Metadatenoperationen behoben, wodurch genaue Typinformationen für komplexe Datenstrukturen gewährleistet wurden.

Verbesserte Fehlerprotokollierung — Verbesserte Protokollierung für Fehler beim Abrufen von S3-Metadaten, wodurch klarere Fehlermeldungen und bessere Diagnoseinformationen bereitgestellt werden.

Authentifizierungs-Plugin für JWT Weitergabe von vertrauenswürdiger Identitäten – Es wurde ein neues Authentifizierungs-Plugin hinzugefügt, um die Integration von JWT Weitergabe von vertrauenswürdiger Identitäten mit JDBC-Treibern zu unterstützen. Mit diesem Authentifizierungstyp können Sie ein von einem externen Identitätsanbieter abgerufenes JSON-Webtoken (JWT) als Verbindungsparameter für die Authentifizierung bei Athena verwenden. Bei der Weitergabe vertrauenswürdiger Identitäten wird einer IAM-Rolle ein Identitätskontext hinzugefügt, um den Benutzer zu identifizieren, der Zugriff AWS auf Ressourcen anfordert. Informationen zur Aktivierung und Verwendung der Weitergabe von vertrauenswürdiger Identitäten finden Sie unter Was ist Weitergabe von vertrauenswürdiger Identitäten?.

Unterstützung für benutzerdefinierte SSO-OIDC- und SSO-Admin-Endpunkte – Unterstützung für benutzerdefinierte SSO-OIDC- und SSO-Admin-Endpunkte im JDBC-Treiber hinzugefügt. Mit dieser Erweiterung können Sie Ihre eigenen Endpunkte für SSO-Dienste angeben, wenn Sie JDBC hinter VPCs ausführen.

AWS SDK-Versionsupdate — Wir haben die im Treiber verwendete AWS SDK-Version auf 2.32.16 aktualisiert und die Projektabhängigkeiten für Version 3.6.0 aktualisiert.

Protokollierungsfunktionen – Verbesserte S3-Abruf-Protokollierung durch Erhöhung der Protokollebene auf INFO und Hinzufügen von Metriken für Zeilenanzahl, Offsets und Objektlänge. Verfolgung des Verbindungslebenszyklus implementiert und Gesamtleistung der Protokollierung optimiert.

Behandlung von Sonderzeichen – Die Behandlung von Sonderzeichen für LIKE-Muster in Schema- und Katalognamen wurde verbessert.

Verwaltung des Verbindungsstatus – Verbesserte Verwaltung des Verbindungsstatus zur Vermeidung potenzieller Fehler, indem API-Aufrufe nach dem Schließen der Verbindung verhindert und Sicherheitsprüfungen für Abfragevorgänge beim Herunterfahren hinzugefügt wurden.

DDL-Abfrage-Metadaten – NoSuchKeyFound-Problem bei der Verarbeitung von DDL-Abfrage-Metadaten behoben.

Konfigurationsparameter für Ergebnisse – Unterstützung für zwei neue Verbindungsparameter ExpectedBucketOwner und AclOption hinzugefügt. Weitere Informationen finden Sie unter Konfigurationsparameter Ergebnisse.

AWS SDK-Version — Die im Treiber verwendete AWS SDK-Version wurde auf 2.30.22 aktualisiert.

Ergebnis-Fetcher – Der Treiber wählt jetzt automatisch die schnellste Methode zum Herunterladen von Abfrageergebnissen aus. Dadurch entfällt in den meisten Situationen die Notwendigkeit, den Fetcher manuell zu konfigurieren. Weitere Informationen finden Sie unter Parameter zum Abrufen von Ergebnissen.

ResultSet— Der Treiber verarbeitet jetzt die Iteration über die Ergebnismengen von DDL-Anweisungen, die auf S3 keine Ergebnisobjekte erzeugen. Außerdem gibt er statt Null ein leeres ResultSet-Objekt zurück, wenn GetQueryResultsStream eine komplett leere Seite zurückgibt.

ResultsStream— Das Ergebnisstreaming wurde optimiert, indem unnötige Aufrufe zum Zählen der Anzahl der Zeilen in internen Puffern entfernt wurden.

getTables – Der GetTables-Aufruf wurde durch die Verarbeitung von Tabellentypen auf der Grundlage von ListTableMetadata und GetTableMetadata optimiert.

DataZone Authentifizierung — Unterstützung für die DataZone Authentifizierungs-Plugins hinzugefügt DataZoneIdC undDataZoneIAM. Weitere Informationen erhalten Sie unter SageMaker Anbieter für Browser-IDC-Anmeldeinformationen und SageMaker Anbieter von IAM-Anmeldeinformationen.

Netzwerk-Timeout – Das Netzwerk-Timeout kann jetzt mit dem NetworkTimeoutMillis-Verbindungsparameter festgelegt werden. Bisher konnte es nur für das Connection-Objekt selbst festgelegt werden. Weitere Informationen finden Sie unter Netzwerk-Timeout.

Behandlung leerer S3-Objekte – Der Treiber verarbeitet jetzt leere Objekte im S3-Fetcher, anstatt eine Amazon S3 Range Not Satisfable-Ausnahme auszulösen.

Protokollierung – Der Treiber protokolliert nicht mehr die Meldung Elemente, die zur Ausführung der Abfrage angefordert wurden [...], sondern das Abonnement wird gekündigt nach dem Verarbeiten der Abfrageergebnisse.

Leere Parameterzeichenfolgen – Der Treiber behandelt jetzt leere Zeichenfolgen in einem Verbindungsparameter als ob der Parameter nicht vorhanden wäre. Dies behebt Probleme, die auftraten, wenn einige BI-Tools versehentlich leere Zeichenfolgen übergaben, was zu unbeabsichtigten Authentifizierungsversuchen führte.

Datentypzuordnung – Die Kompatibilität mit der JDBC-Spezifikation wurde verbessert, indem geändert wurde, wie der Treiber die Datentypentinyint, smallint, row und struct Java-Objekten zuordnet.

AWS SDK-Versionsupdate — Die im Treiber verwendete AWS SDK-Version wurde auf 2.26.23 aktualisiert.

Kommentare – Ein Problem mit Zeilenkommentaren am Ende einer Aussage wurde behoben.

Datenbankauflistung – Es wurde ein Problem behoben, bei dem das Auflisten von Datenbanken in eine Endlosschleife geraten konnte, wenn die letzte von der paginierten ListDatabases API zurückgegebene Seite leer war.

Anbieter für JWT-Anmeldeinformationen – Unterstützung für benutzerdefinierte Sitzungsdauern hinzugefügt. Weitere Informationen finden Sie unter Rollensitzungsdauer.

Thread-Pool – Für asynchrone Aufgaben wurde ein ThreadPoolExecutor pro Verbindung erstellt, um die Nutzung des ForkJoin Pools zu vermeiden.

Anbieter von Anmeldeinformationen — Der Proxy-Host wird jetzt analysiert, um das Schema und den Host abzurufen, wenn der HTTP-Client für extern konfiguriert ist. IdPs

Standard-Anbieter für Anmeldeinformationen – Es wurde sichergestellt, dass der Standard-Anbieter für Anmeldeinformationen nicht durch den Client-Code geschlossen werden kann.

getColumns – Ein Problem mit ORDINAL_COLUMN Spalteneigenschaften in der DatabaseMetaData#getColumns-Methode wurde behoben.

ResultSet— Unterstützung für Infinity-Infinity, und NaN hinzugefügt. ResultSet. Es wurde eine Diskrepanz zwischen dem bei Katalogoperationen zurückgegebenen Spaltentyp und der Ergebnismenge einer abgeschlossenen Abfrage behoben.

Leistung bei Katalogoperationen – Die Leistung bei Katalogoperationen, die keine Platzhalterzeichen verwenden, wurde verbessert.

Änderung des minimalen Abfrageintervalls – Die Standardeinstellung für das minimale Abfrageintervall wurde geändert, um die Anzahl der API-Aufrufe zu reduzieren, die der Treiber an Athena tätigt. Abfrageabschlüsse werden trotzdem so schnell wie möglich erkannt.

Auffindbarkeit von BI-Tools – Der Treiber wurde für Business Intelligence-Tools leichter auffindbar gemacht.

Datentypzuordnung – Die Datentypzuordnung zu den Datentypen Athena binary, array und struct DDL wurde verbessert.

AWS SDK-Version — Die im Treiber verwendete AWS SDK-Version wurde auf 2.25.34 aktualisiert.

Tabellenlisten in Verbundkatalogen – Es wurde ein Problem behoben, das dazu führte, dass Verbundkataloge eine leere Tabellenliste zurückgaben.

getSchemas — Es wurde ein Problem behoben, das dazu führte, dass die JDBC DatabaseMetaData #getSchemas -Methode Datenbanken nur aus dem Standardkatalog und nicht aus allen Katalogen abrief.

getColumns — Es wurde ein Problem behoben, das dazu führte, dass ein Null-Katalog zurückgegeben wurde, wenn die JDBC DatabaseMetaData #getColumns -Methode mit einem Null-Katalognamen aufgerufen wurde.

Support hinzugefügt für Microsoft Active Directory Federation Services (AD FS). Windows-integrierte Authentifizierung und formularbasierte Authentifizierung.

Aus Gründen der Abwärtskompatibilität mit Version 2.x wird das awsathena JDBC-Subprotokoll jetzt akzeptiert, es wird jedoch eine Verfallswarnung ausgegeben. Verwenden Sie stattdessen das athena-JDBC-Subprotokoll.

AwsDataCatalog ist jetzt die Standardeinstellung für den Katalogparameter und default ist die Standardeinstellung für den Datenbankparameter. Diese Änderungen stellen sicher, dass korrekte Werte für den aktuellen Katalog und die aktuelle Datenbank anstelle von Null zurückgegeben werden.

Entspricht der JDBC-Spezifikation IS_AUTOINCREMENT und IS_GENERATEDCOLUMN geben jetzt eine leere Zeichenfolge anstelle von NO zurück.

Der int-Athena-Datentyp ist jetzt demselben JDBC-Typ wie Athena integer zugeordnet, anstatt other.

Wenn die Spaltenmetadaten von Athena die optionalen precision und scale-Felder nicht enthalten, gibt der Treiber jetzt Null für die entsprechenden Werte in einer ResultSet-Spalte zurück.

Die AWS SDK-Version wurde auf 2.21.39 aktualisiert.

Es wurde ein Problem mit GetQueryResultsStream behoben, das zu einer Ausnahme führte, wenn Klartextergebnisse von Athena eine Spaltenanzahl aufwiesen, die nicht mit der Spaltenanzahl in den Athena-Ergebnismetadaten übereinstimmte.