Versionshinweise von Amazon Athena ODBC 2.x

• Es wurde ein Problem behoben, das dazu führteSQLTables, dass Tabellen über die ersten 200 in einem Schema weggelassen wurden, wenn eine Metadaten-Ergebnisseite leer war. SQLColumns

• Es wurde ein Problem behoben, das dazu führte, dass leere Zeichenkettenfiltermuster in ADO.NET Anwendungen z. Power BI B. null Zeilen statt aller Zeilen zurückgaben.

• Es wurde ein Problem behoben, das SQLColumns dazu führte, dass Spaltentypen fehlschlugen, die der Treiber nicht erkennt, wie z. B. uuid oderjson. Diese Spalten werden jetzt als gemeldetVARCHAR.

• Es wurde ein Problem behoben, das dazu führte, dass Verbindungen, die das SageMakerBrowserIdc Authentifizierungs-Plugin verwenden, hängen blieben, wenn der SSOEndpointOverride Parameter SSOOIDCEndpointOverride or gesetzt wurde.

• Es wurde ein Problem behoben, das dazu führte, dass Verbindungen über einen Proxyserver mit DNS-Auflösungsfehlern fehlschlugen, wenn der Proxy die DNS-Auflösung durchführte. HTTP-Clients, die das AWS SDK intern erstellt, verwenden jetzt die Proxykonfiguration von Ihrem DSN.

  Anmerkung

  Unter Windows überprüft der Treiber jetzt SSL-Zertifikate anhand des Windows-Systemzertifikatspeichers und verwendet den TrustedCerts Parameter nicht.

• Es wurde ein Problem behoben, das dazu führte, dass die TLS-Zertifikatsüberprüfung auf einigen Linux-Distributionen fehlschlug, wenn der TrustedCerts Parameter nicht gesetzt war. Der Treiber findet jetzt das CA-Paket zur Laufzeit und berücksichtigt die Umgebungsvariablen CURL_CA_BUNDLE undSSL_CERT_FILE.

• Es wurde ein Problem behoben, das dazu führte, dass der Treiber Anfragen ohne Header an Identitätsanbieter sendete. User-Agent

  Wichtig

  Aktion erforderlich: In dieser Version wird der User-Agent Header-Wert geändert, den der Treiber bei Anfragen an AWS Dienste und Identitätsanbieter sendet, mit Ausnahme von Anforderungen der integrierten Windows-Authentifizierung, die weiterhin einen User-Agent Browserwert verwenden. Wenn Sie den User-Agent Treiberwert in den aws:UserAgent IAM-Richtlinienbedingungen, Protokollfiltern oder Anmelderegeln des Identitätsanbieters übereinstimmen, aktualisieren Sie sie entsprechend. *lib/AmazonAthenaODBC#*

• Es wurde ein Problem behoben, das dazu führte, dass einige browserbasierte Authentifizierungsanfragen aufgrund eines fehlenden Headers fehlschlugen. Content-Length

• Es wurde ein Problem behoben, das dazu führte, dass Abfrageparameter bei der Verwendung SQL_C_WCHAR von Bindungen gekürzt wurden.

• Die Lizenzdatei enthält jetzt einen Verweis auf die AWS Servicebedingungen.

• SageMaker Authentifizierung — Unterstützung für die Authentifizierungs-Plugins hinzugefügt und. SageMaker SageMakerBrowserIdc SageMakerIam 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 IDC-Browser und SageMaker ICH BIN.

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

• macOS Universal Installer — Der macOS-Treiber wird jetzt als eine einzige universelle Binärdatei vertrieben, die sowohl ARM- als auch Intel-Architekturen unterstützt, was die Installation auf der gesamten Mac-Hardware vereinfacht.

• HTTP-Client-Migration — Durch die Migration zum SDK CRT-HTTP-Client wurde die Libcurl-Abhängigkeit von den ODBC-Binärdateien entfernt. AWS Der CRT-Client verwendet den nativen TLS-Stack und den System Trust Store der Plattform, wodurch die Verbindungszuverlässigkeit verbessert und transitive Abhängigkeiten von OpenSSL und zlib vermieden werden.

• ExternalIdUnterstützung für STS für die kontoübergreifende Rollenübernahme AssumeRole wurde hinzugefügt. Das ExternalId wird aus der AWS Profilkonfiguration gelesen.

• SSL-Zertifikatsvalidierung standardmäßig aktiviert — Der Treiber erzwingt jetzt die SSL-Zertifikatsüberprüfung, wenn eine Verbindung zu Identitätsanbietern hergestellt wird. Wenn Sie einen lokalen Identitätsanbieter ohne gültiges SSL-Zertifikat verwenden, müssen Sie dies SSL_Insecure=1 in Ihrer Verbindungszeichenfolge explizit angeben. Weitere Informationen finden Sie unter SSL unsicher (IdP).

• TLS 1.2 ist erforderlich — Der Treiber akzeptiert keine TLS 1.0- oder TLS 1.1-Verbindungen zu Identitätsanbietern mehr. Alle IdP-Verbindungen benötigen jetzt TLS 1.2 oder höher.

• Der BrowserSSOOIDC-Authentifizierungsablauf wurde aktualisiert — Das BrowserSSOOIDC-Plugin verwendet jetzt den Autorisierungscode mit PKCE anstelle der Gerätecode-Autorisierung. Ein neuer optionaler Parameter listen_port (Standard 7890) ist für den OAuth 2.0-Callback-Server verfügbar. Möglicherweise müssen Sie diesen Port in Ihrem Netzwerk zulassen. Der Standardbereich wurde auf sso:account:access geändert. Weitere Informationen finden Sie unter Browser SSO OIDC.

• browserSSOOIDC — Zur Verbesserung der Sicherheit wurde mit PKCE vom Gerätecode-Flow zum Autorisierungscode migriert.

• BrowserAzureAD — PKCE (Proof Key for Code Exchange) zum OAuth 2.0-Autorisierungsablauf hinzugefügt, um Angriffe vom Abfangen von Autorisierungscodes zu verhindern.

• BrowserSAML — RelayState CSRF-Schutz hinzugefügt, um SAML-Token-Injection-Angriffe zu verhindern.

• Cache für Anmeldeinformationen — Ab Version 2.1.0.0 werden zwischengespeicherte Anmeldeinformationen als Klartext-JSON im user-profile/.athena-odbc/ Verzeichnis gespeichert, wobei die Dateiberechtigungen auf den Besitzer beschränkt sind. Dies entspricht der Art und Weise, wie die CLI lokal gespeicherte Anmeldeinformationen schützt. AWS

• IAM-Profil — Zusätzlich zu den vorhandenen wurde Unterstützung für EcsContainer und Quellen von Environment Anmeldeinformationen hinzugefügt. Ec2InstanceMetadata

• Parser für Verbindungszeichenfolgen — Die korrekte }} ODBC-Escape-Behandlung wurde implementiert.

• Katalogabfragen — SQL-Identifier-Escaping für Schemanamen und Tabellenmuster hinzugefügt.

• ODBC-Mustervergleich — Der Regex-basierte Abgleich wurde durch den direkten ODBC LIKE-Platzhalter-Matcher ersetzt.

• XML-Parsing — Für SAML-Token wurden eine Begrenzung der Rekursionstiefe (100 Stufen) und eine Größenbeschränkung (1 MB) hinzugefügt.

• ADFS-Authentifizierung — Für ADFS-Serverantworten wurde eine Beschränkung der Antwortgröße (200 KB) hinzugefügt.

• Die falsche Neutralisierung spezieller Elemente in Authentifizierungskomponenten, die die Codeausführung oder die Umleitung des Authentifizierungsflusses über benutzerdefinierte Verbindungsparameter ermöglichen könnten, wurde behoben. Wirkt sich auf BrowserSSOOIDC-, BrowserAzure AD- und BrowserSAML-Plugins aus.

• Es wurde eine falsche Neutralisierung von Spezialelementen in Komponenten zur Abfrageverarbeitung behoben, die einen Denial-of-Service oder eine SQL-Injection über handgefertigte Tabellenmetadaten ermöglichen konnten.

• Falsche Zertifikatsvalidierung beim Herstellen einer Verbindung zu Identitätsanbietern wurde behoben.

• Fehlende Sicherheitskontrollen für die Authentifizierung in browserbasierten Authentifizierungsabläufen wurden behoben, darunter PKCE für OAuth, CSRF-Schutz für SAML, sicheres Zwischenspeichern von Anmeldeinformationen und exklusive Callback-Portbindung.

• Der unkontrollierte Ressourcenverbrauch beim Analysieren von Komponenten, der einen Denial-of-Service über benutzerdefinierte Eingabemuster, unbegrenzte Serverantworten oder tief verschachtelte XML-Payloads ermöglichen konnte, wurde behoben.

• Es wurde ein Problem behoben, bei dem bei SQLColumns Verwendung von kontoübergreifenden Verbundkatalogen im Power UseSingleCatalogAndSchema=1 BI-Importmodus keine Ergebnisse SQLTables zurückgegeben wurden.

• Browser Trusted Identity Propagation-Authentifizierungs-Plugin — Es wurde ein neues Authentifizierungs-Plugin hinzugefügt, das die browserbasierte OpenID Connect (OIDC) -Authentifizierung mit vertrauenswürdiger Identitätsweitergabe unterstützt. Dieses Plugin bietet ein nahtloses Authentifizierungserlebnis, indem es den kompletten OAuth 2.0-Prozess über Ihren Standardbrowser abwickelt, das JSON Web Token (JWT) automatisch abruft und in die vertrauenswürdige Identitätsverbreitung integriert. Das Plugin wurde speziell für Einzelbenutzer-Desktop-Umgebungen entwickelt. Informationen zur Aktivierung und Verwendung der Weitergabe von vertrauenswürdiger Identitäten finden Sie unter Was ist Weitergabe von vertrauenswürdiger Identitäten?.

• Verbessertes Logging-Framework — Der Logging-Mechanismus des Treibers wurde erheblich verbessert durch:

  • Einführung von detaillierteren Protokollebenen, die über die grundlegenden 0/1 Optionen hinausgehen

  • Redundante Protokollanweisungen entfernen

  • Optimierung des Protokollierungs-Frameworks, um diagnostisch relevante Informationen einzubeziehen

  • Behebung von Leistungsproblemen, die zu Betriebsverzögerungen geführt haben

  • Reduzierung der übermäßigen Generierung von Protokolldateien bei aktivierter Protokollierung

• Optimierung des Ergebnisabrufs — Es wurde ein Problem behoben, bei dem die Beschränkungen der Abrufgrößenparameter fälschlicherweise sowohl auf Streaming-Ergebnisabrufe als auch auf Nicht-Streaming-Ergebnisabrufe angewendet wurden. Die Beschränkung wird jetzt korrekt nur auf Ergebnisabrufe angewendet, die nicht per Streaming abgerufen werden.

Der Amazon Athena-Treiber ODBC v2.0.5.1 enthält die folgenden Fehlerbehebungen für browserbasierte Authentifizierungs-Plugins.

• Validierung für Anmelde-URL und Schemaüberprüfung wurde implementiert.

• Browser-Startmechanismus unter Linux zur Nutzung von System-APIs wurde verbessert, was zu verbesserter Stabilität und Sicherheit führt.

• Authentifizierungs-Plugin für JWT vertrauenswürdigen Identitätsanbieter (TIP) – Es wurde ein neues Authentifizierungs-Plugin hinzugefügt, um die Integration von JWT ertrauenswürdiger Identitätsanbieter (TIP) mit ODBC-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. Mit TIP 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 von TIP finden Sie unter Was ist Weitergabe von vertrauenswürdiger Identitäten?.

• Unterstützung für benutzerdefinierte SSO-Admin-Endpunkte – Unterstützung für benutzerdefinierte SSO-Admin-Endpunkte im ODBC-Treiber hinzugefügt. Mit dieser Erweiterung können Sie Ihre eigenen Endpunkte für SSO-Dienste angeben, wenn Sie ODBC 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 2.0.5.0 aktualisiert.

• Ergebnis-Fetcher – Der Treiber wählt jetzt automatisch die 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 Ergebnis-Fetcher.

• Die Curl-Bibliothek wurde auf 8.12.1 aktualisiert.

• Die Proxykonfiguration für das IAM-Profil beim Herstellen einer Verbindung zu STS wurde behoben. Mit der Fehlerbehebung kann das IAM-Profil für eine erfolgreiche Authentifizierung verwendet werden.

• Lesen Sie alle zusätzlichen Konfigurationsoptionen für das IAM-Profil mit Authentifizierungs-Plugins. Dazu gehören UseProxyForIdP, SSL_Insecure, LakeformationEnabled und LoginToRP zur Behebung von Fehlkonfigurationen für die betroffenen Plugins.

• Fehler bei der Rundungsfunktion behoben, indem sie nun einen optionalen zweiten Parameter akzeptiert. Verarbeitet erfolgreich Abfragen, die die Escape-Syntax enthalten.

• Die Spaltengröße für TIME WITH TIME ZONE- und TIMESTAMP WITH TIME ZONE-Datentypen wurde korrigiert. Werte mit dem Datentyp Zeitstempel und Zeitzone werden nicht gekürzt.

• MFA-Unterstützung für das Okta-Authentifizierungs-Plugin auf Linux- und Mac-Plattformen hinzugefügt.

• Sowohl die athena-odbc.dll-Bibliothek als auch das AmazonAthenaODBC-2.x.x.x.msi-Installationsprogramm für Windows sind jetzt signiert.

• Die cacert.pem-CA-Zertifikatsdatei, die mit dem Treiber installiert wurde, wurde aktualisiert.

• Die Zeit, die zum Auflisten von Tabellen in Lambda-Katalogen benötigt wird, wurde verbessert. Bei LAMBDA-Katalogtypen kann der ODBC-Treiber jetzt eine SHOW TABLES-Abfrage senden, um eine Liste der verfügbaren Tabellen abzurufen. Weitere Informationen finden Sie unter Abfrage verwenden um Tabellen aufzulisten.

• Es wurde der UseWCharForStringTypes-Verbindungsparameter eingeführt, um Zeichenfolgendatentypen mithilfe von SQL_WCHAR und SQL_WVARCHAR zu melden. Weitere Informationen finden Sie unter WCHAR für Zeichenfolgentypen verwenden.

• Eine Warnung zur Beschädigung der Registrierung, die bei der Verwendung des Get-OdbcDsn PowerShell Tools auftrat, wurde behoben.

• Die Analyselogik wurde aktualisiert, sodass Kommentare am Anfang von Abfragezeichenfolgen verarbeitet werden.

• Bei den Datentypen Datum und Zeitstempel ist jetzt eine Null im Jahresfeld zulässig.

• Es wurden zwei Verbindungsparameter hinzugefügt, StringColumnLength und ComplexTypeColumnLength, mit denen Sie die Standardspaltenlänge für Zeichenketten- und komplexe Datentypen ändern können. Weitere Informationen erhalten Sie unter Länge der Zeichenfolgen-Spalte und Spaltenlänge eines komplexen Typs.

• Unterstützung für die Betriebssysteme Linux und macOS (Intel und ARM) wurde hinzugefügt. Weitere Informationen erhalten Sie unter Linux und macOS.

• AWS-SDK-CPP wurde auf die Tag-Version 1.11.245 aktualisiert.

• Die Curl-Bibliothek wurde auf die Version 8.6.0 aktualisiert.

• Es wurde ein Problem behoben, das dazu führte, dass falsche Werte in den Metadaten der Ergebnismenge für zeichenfolgenähnliche Datentypen in der Genauigkeitsspalte gemeldet wurden.

• Verbesserte Thread-Sicherheit des ODBC-Treibers für alle Schnittstellen.

• Wenn die Protokollierung aktiviert ist, werden Datum/Uhrzeit-Werte jetzt mit Millisekunden-Präzision aufgezeichnet.

• Bei der Authentifizierung mit dem Browser SSO OIDC-Plugin wird nun das Terminal geöffnet, um dem Benutzer den Gerätecode anzuzeigen.

• Es wurde ein Problem mit der Speicherfreigabe behoben, das beim Parsen von Ergebnissen aus der Streaming-API auftrat.

• Anfragen für die Schnittstellen SQLTablePrivileges(), SQLSpecialColumns(), SQLProcedureColumns() und SQLProcedures() geben nun leere Ergebnismengen zurück.

• Das Datei-Cache-Feature wurde für die browserbasierten Authentifizierungs-Plugins Browser Azure AD, Browser SSO OIDC und Okta hinzugefügt.

  BI-Tools wie Power BI und browserbasierte Plugins verwenden mehrere Browserfenster. Mit dem neuen Datei-Cache-Verbindungsparameter können temporäre Anmeldeinformationen zwischengespeichert und zwischen den verschiedenen Prozessen, die von BI-Anwendungen geöffnet werden, wiederverwendet werden.

• Anwendungen können jetzt Informationen über die Ergebnismenge abfragen, nachdem eine Anweisung vorbereitet wurde.

• Die standardmäßigen Verbindungs- und Anforderungs-Timeouts wurden für die Verwendung in langsameren Client-Netzwerken erhöht. Weitere Informationen erhalten Sie unter Verbindungstimeout und Anforderungstimeout.

• Endpunktüberschreibungen wurden für SSO und SSO OIDC hinzugefügt. Weitere Informationen finden Sie unter Überschreibungen von Endpunkten.

• Es wurde ein Verbindungsparameter hinzugefügt, um ein URI-Argument für eine Authentifizierungsanforderung an Ping zu übergeben. Sie können diesen Parameter verwenden, um die Einzelrollenbeschränkung von Lake Formation zu umgehen. Weitere Informationen finden Sie unter Ping-URI-Parameter.

• Es wurde ein Problem mit einem Ganzzahlüberlauf behoben, das bei der Verwendung des zeilenbasierten Bindungsmechanismus auftrat.

• Das Timeout wurde aus der Liste der erforderlichen Verbindungsparameter für das Browser-SSO-OIDC-Authentifizierungs-Plugin entfernt.

• Fehlende Schnittstellen für SQLStatistics(), SQLPrimaryKeys(), SQLForeignKeys() und SQLColumnPrivileges() wurden hinzugefügt und es wurde die Möglichkeit hinzugefügt, auf Anfrage leere Ergebnissätze zurückzugeben.

• URI-Protokollierung zum Okta-Authentifizierungs-Plugin hinzugefügt.

• Der bevorzugte Rollenparameter wurde dem Plug-in für externe Anmeldeinformationen hinzugefügt.

• Es wurde eine Behandlung für das Profilpräfix im Profilnamen der AWS -Konfigurationsdatei hinzugefügt.

• Es wurde ein AWS-Region Nutzungsproblem behoben, das bei der Arbeit mit Lake Formation und AWS STS Clients auftrat.

• Fehlende Partitionsschlüssel wurden in der Liste der Tabellenspalten wiederhergestellt.

• Der fehlende BrowserSSOOIDC-Authentifizierungstyp wurde dem AWS -Profil hinzugefügt.