ODBC Driver-Versionshinweise 2023

Dieser Artikel enthält die Versionshinweise für ODBC Driver, einschließlich der folgenden, sofern zutreffend:

  • Verhaltensänderungen

  • Neue Features

  • Fehlerkorrekturen für Kunden

Snowflake verwendet semantische Versionierung für ODBC Driver-Aktualisierungen.

Version 3.1.4 (07. Dezember 2023)

Neue Features und Aktualisierungen

  • Keine.

Fehlerkorrekturen

  • Verbindungsparameter BROWSER_RESPONSE_TIMEOUT wurde hinzugefügt, um Problem mit der Authentifizierung von externen Browsern zu beheben.

  • Verbindungsparameter allowEmptyProxy wurde hinzugefügt, um Problem zu beheben, bei dem eine leere Proxyeinstellung die Konfigurationseinstellung überschreiben konnte.

  • Problem behoben, das beim Senden von Telemetriedaten zu zeitweiligen Abstürzen führte.

  • CRT-Funktionen entfernt, die bei Microsoft aufgrund von Sicherheitsbedenken nicht zulässig sind.

Version 3.1.3 (13. November 2023)

Neue Features und Aktualisierungen

  • Folgende Bibliotheken wurden aktualisiert:

    • openssl von 3.0.9 auf 3.0.11

    • curl von 8.1.2 auf 8.4.0

  • SQLGetStmtAttr(SQL_SF_STMT_ATTR_LAST_QUERY_ID) wurde aktualisiert, um die Abfrage-ID für fehlgeschlagene Abfragen zurückzugeben.

  • Unterstützung für die Verwaltung der Häufigkeit von Wiederholungsversuchen bei erfolglosen Verbindungsanforderungen hinzugefügt:

    • Parameter retryTimeout wurde mit einem Standardwert von 300 Sekunden hinzugefügt.

    • Verwendung der Verbindungsparameter LOGIN_TIMEOUT und maxHttpRetries durch den Treiber wurde aktualisiert und der Standardwert von LOGIN_TIMEOUT auf 300 Sekunden geändert.

Fehlerkorrekturen

  • Problem behoben, bei dem der Treiber Abfrageergebnissen aufgrund eines Timeouts bei der OSCP-Validierung nicht abrufen konnte.

  • Problem behoben, bei dem die Befehle PUT und GET fehlschlugen, wenn ein Dateipfad Zeichen enthielt, die keine ASCII-Zeichen waren.

  • Problem behoben, bei dem ein PUT-Befehl auf GCP bestehende Dateien überschrieb, wenn nicht overwrite=true angegeben war.

  • CRT-Funktionen entfernt, die bei Microsoft aufgrund von Sicherheitsbedenken nicht zulässig sind.

Version 3.1.1 (29. September 2023)

Neue Features und Aktualisierungen

  • Das für SSL-Verbindungen verwendete cacert-Bundle wurde aktualisiert.

Fehlerkorrekturen

  • Fehlermeldungen zu PUT/GET-Befehlsfehlern wurden verbessert, um spezifische Fehler anstelle von „unknown exception“ zu liefern.

  • Problem behoben, bei dem der ODBC-Treiber das Herunterladen von Blöcken auch dann weiter versuchte, wenn die Anwendung die entsprechende Abfrage abgebrochen hatte.

  • Problem behoben, bei dem die Verwendung von SQLGetData() mit dem ARROW-Ergebnisformat die Leistung beeinträchtigen konnte.

  • Problem behoben, bei dem in Fehlermeldungen die Anmeldeinformationen angezeigt wurden.

  • Ein Problem mit OCSP-Fallback-Anforderungen in AWS PrivateLink-Umgebungen behoben.

  • Problem behoben, bei dem der Treiber bei der OCSP-Validierung nicht die gesamte OCSP-URL im Zertifikat verwendet hat.

Version 3.1.0 (23. August 2023)

Änderungen in Verhaltensänderungs-Release (BCR)

  • Problem behoben, bei dem der Treiber unter bestimmten Bedingungen HTTP-Anforderungen unbegrenzt wiederholen konnte.

    Bisher hat der Treiber die während eines Ausfalls fehlgeschlagene HTTP-Anforderung so lange wiederholt, bis sie erfolgreich war oder bis jemand das Beenden der Operation erzwungen hat.

    Mit dieser Änderung deaktiviert der Treiber endlose HTTP-Wiederholungsversuche, die von execute- und executeQuery-Aufrufen ausgehen. Der Treiber begrenzt wiederholte HTTP-Versuche jetzt standardmäßig auf sieben Wiederholungen. Kunden können über den Verbindungsparameter maxHttpRetries die maximale Anzahl der Wiederholungsversuche selbst festlegen. Kunden können maxHttpRetries=0 einstellen, wodurch das Limit für die Wiederholungsversuche aufgehoben wird. Dabei besteht jedoch die Gefahr, dass der Treiber fehlgeschlagene HTTP-Anforderungen unendlich oft wiederholt.

  • Um die Leistung zu verbessern, validiert die Funktion SQLExecDirect() nicht mehr unnötigerweise Parameterbindungen für eine Abfrage.

    Bisher hat der Treiber für jeden Aufruf von SQLExecDirect() zwei Anforderungen gesendet: eine Beschreibungsanforderung und eine Ausführungsanforderung. Um die Leistung zu verbessern, wird die beschriebene Anforderung weggelassen. Mit dieser Änderung wird der Treiber die von der Abfrage benötigten Parameterbindungen nicht mehr validieren. Wenn die Parameterbindungen aus der vorherigen Abfrage nicht mit SQLFreeStmt(SQL_RESET_PARAMS) gelöscht werden, könnten sie fälschlicherweise auf die folgende Abfrage angewendet werden und Probleme verursachen.

Neue Features und Aktualisierungen

  • Sitzungsparameter CLIENT_OUT_OF_BAND_TELEMETRY_ENABLED zum Aktivieren/Deaktivieren der Unterstützung der Out-of-Band-Telemetrie (OOB) wurde hinzugefügt.

Fehlerkorrekturen

  • Problem behoben, bei dem der Treiber fehlschlagen konnte, wenn er ein Abfrageergebnis für Abfragen mit mehreren Anweisungen erhielt, die mit neuen Anweisungstypen beginnen, wie z. B. CALL.

  • Problem behoben, das dazu führen konnte, dass die Funktion SQLColAttribute() bei VARCHAR-Spalten einen falschen Wert für SQL_DESC_OCTET_LENGTH zurückgab, wodurch Daten abgeschnitten werden konnten.

  • Problem behoben, bei dem der Treiber die Abfrageergebnisse nicht herunterladen konnte, weil er bei der Verwendung privater Verbindungen fälschlicherweise Out-of-Band-Telemetrie-Timeouts (OOB) sendete.

Version 3.0.2 (27. Juli 2023)

Neue Features und Aktualisierungen

  • Folgende Software-Bibliotheken wurden aktualisiert:

    • util-linux auf Version 2.39.0.

    • curl auf Version 8.1.2.

  • Hybride transaktionale/analytische Verarbeitung (HTAP) verbessert.

  • LogLevel-Standardwert für ODBC-Clients, die auf Windows-Plattformen ausgeführt werden, auf OFF gesetzt.

Fehlerkorrekturen

  • Problem behoben, das beim Senden von Telemetriedaten zu zeitweiligen Abstürzen führte.

Version 3.0.1 (06. Juli 2023)

Änderungen in Verhaltensänderungs-Release (BCR)

Ab Version 3.0.1 des ODBC-Treibers:

  • Openssl von 1.1.1 auf 3.0.9. aktualisiert. Folglich funktionieren private Schlüssel, die mit den veralteten Verschlüsselungsalgorithmen früherer openssl-Bibliotheksversionen generiert wurden, nicht mehr. Bei einem Update auf ODBC 3.0.1 müssen Sie Ihre private Schlüsseldatei, die für die Schlüsselpaar-Authentifizierung verwendet wird, neu generieren.

  • Unterstützung von CentOS 6 und MacOS 10.14 und 10.15 wurde eingestellt.

Neue Features und Aktualisierungen

  • Folgende Software-Bibliotheken wurden aktualisiert:

    • openssl auf Version 3.0.9.

    • ICU auf Version 71.1.0.

  • Eine Einheitliche Architektur für Release-Pakete erstellt, die sowohl x86_64- als auch arm64 Mac-Systeme unterstützt.

Fehlerkorrekturen

  • Problem behoben, bei dem der Treiber zeitweise abstürzte, wenn CLIENT_SESSION_KEEP_ALIVE auf Windows-Systemen auf „true“ gesetzt wurde.

Version 2.25.12 (06. Juni 2023)

Neue Features und Aktualisierungen

Keine.

Fehlerkorrekturen

  • Problem behoben, bei dem sehr große Anforderungen mit einer großen Anzahl von Parameterbindungen eine Anwendung zum Absturz bringen konnten, weil die Protokollierungsgröße überschritten wurde.

  • Problem mit der OCSP-Validierung wurde behoben.

  • Problem behoben, durch das versehentlich ein Proxykennwort in der Snowflake-Protokolldatei aufgedeckt werden konnte.

Version 2.25.11 (20. April 2023)

Neue Features und Aktualisierungen

  • Die libcurl-Bibliothek wurde von Version 7.87.0 auf 7.88.1 aktualisiert.

  • Die zlib-Bibliothek wurde von Version 1.2.11 auf 1.2.13 aktualisiert.

Fehlerkorrekturen

  • Problem mit ungültiger URL behoben, das während der OCSP-Validierung beim Verbindungsaufbau auftreten konnte.

  • Problem behoben, bei dem Verbindungen fehlschlugen, wenn bei Verwendung von Proxys Anmeldeinformationen bereitgestellt wurden, die diese nicht benötigen.

  • Veraltete openssl-Funktionsaufrufe wurden entfernt.

  • Problem behoben, bei dem Parameterbindungen vom Typ „Double“ an Genauigkeit verlieren konnten.

  • Unsichere Funktionsaufrufe, die bei Microsoft nicht zulässig sind, wurden entfernt.

Version 2.25.10 (22. März 2023)

Neue Features und Aktualisierungen

  • Die libcurl-Bibliothek wurde von Version 7.84.0 auf 7.87.0 aktualisiert.

Fehlerkorrekturen

  • Problem behoben, das Clients daran hinderte, einen Datei-DSN (Name der Datenquelle) zu erstellen.

  • Problem behoben, bei dem der PUT-Befehl die Daten nicht replizieren konnte.

  • Problem behoben, bei dem eine Macintosh-Anwendung, die auf der ARM64-Architektur läuft, keine Verbindung zu Snowflake herstellen konnte, wenn der native Apple Silicon-ODBC-Treiber verwendet wurde.

Version 2.25.9 (28. Februar 2023)

Neue Features und Aktualisierungen

Keine.

Fehlerkorrekturen

  • Unterstützung von Datentyp GEOMETRY in SnowflakeType-Typ „enum“ hinzugefügt, um Problem zu beheben, das auftrat, wenn die Funktion SQLColumns() aufgerufen wurde, um Metadaten zurückzugeben, die GEOMETRY-Daten enthielten.

  • Problem behoben, bei dem für Zeitstempel-Daten in einigen Fällen fälschlicherweise NULL zurückgegeben wurden.

Version 2.25.8 (8. Februar 2023)

Neue Features und Aktualisierungen

Keine.

Fehlerkorrekturen

  • Problem behoben, bei dem eine INSERT-Anweisung zur Array-Bindung fehlschlug, wenn das Schema nicht in der Sitzung definiert war.

  • Problem behoben, das gelegentlich zum Absturz des ODBC-Treibers führte, wenn GET- und PUT-Abfragen ausgeführt wurden.

  • Problem behoben, bei dem der ODBC-Treiber SIGPIPE-Signale sendete, nachdem die Sitzung etwa 120 Sekunden lang inaktiv war.

  • Problem behoben, bei dem die Okta-Authentifizierung fehlschlug, wenn ein HTTP-429-Fehler auftrat.