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
undmaxHttpRetries
durch den Treiber wurde aktualisiert und der Standardwert vonLOGIN_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
- undexecuteQuery
-Aufrufen ausgehen. Der Treiber begrenzt wiederholte HTTP-Versuche jetzt standardmäßig auf sieben Wiederholungen. Kunden können über den VerbindungsparametermaxHttpRetries
die maximale Anzahl der Wiederholungsversuche selbst festlegen. Kunden könnenmaxHttpRetries=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 mitSQLFreeStmt(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()
beiVARCHAR
-Spalten einen falschen Wert fürSQL_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, aufOFF
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 FunktionSQLColumns()
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.