Versionshinweise von Amazon Athena JDBC 3.x

Browser OIDC Trusted Identity Propagation Authentication Plugin — 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-Flow über Ihren Standardbrowser, ruft automatisch das JSON Web Token (JWT) ab und ist in die vertrauenswürdige Identitätsverbreitung integriert. Es wurde speziell für Desktop-Umgebungen mit Einzelbenutzern entwickelt und bietet im Vergleich zur manuellen JWT-Handhabung ein optimierteres Authentifizierungserlebnis. Weitere Informationen zur Verbreitung vertrauenswürdiger Identitäten finden Sie unter Was ist vertrauenswürdige Identitätsverbreitung? .

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

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

Verbesserte Fehlerprotokollierung — Die Protokollierung von Fehlern beim Abrufen von S3-Metadaten wurde verbessert und bietet klarere Fehlermeldungen und bessere Diagnoseinformationen.

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 dahinter ausführen. VPCs

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 der 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 Zeilenanzahl 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 DataZoneIdC und DataZoneIAM hinzugefügt. Weitere Informationen erhalten Sie unter DataZone Anbieter von IdC-Anmeldeinformationen und DataZone 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 Proxyhost 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 von 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 statt aus allen Katalogen abruft.

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.