Go Snowflake Driver-Versionshinweise 2023¶
Dieser Artikel enthält die Versionshinweise für Go Snowflake Driver, einschließlich der folgenden, sofern zutreffend:
Verhaltensänderungen
Neue Features
Fehlerkorrekturen für Kunden
Snowflake verwendet semantische Versionierung für Go Snowflake Driver-Aktualisierungen.
Version 1.7.1 (07. Dezember 2023)¶
Neue Features und Aktualisierungen¶
Bibliotheken
crypto
undnet
wurden aktualisiert.Unterstützung für die Ausführung von S3-Clients auf der neuen AWS SDK-Bibliothek unter Beibehaltung der Kompatibilität mit der vorherigen Bibliotheksversion wurde hinzugefügt.
Leistung des OCSP-Antwort-Caches wurde verbessert, indem der Schlüssel von einem
x509.Certificate
in eine Zeichenfolge geändert wurde.Separate Wiederholungsstrategien für Authentifizierungsendpunkte und andere Typen von Endpunkten wurden implementiert.
Fehlerkorrekturen¶
Treiber wiederholt jetzt fehlgeschlagene
getQueryStatus
-Abfragen, wenn Backend-Fehler auftreten.Der Treiber liefert jetzt einen
QueryId
für fehlgeschlagene Abfragen, die durch Anweisungen aufgerufen wurden.
Version 1.7.0 (15. November 2023)¶
Änderung in Verhaltensänderungs-Release (BCR)¶
Standardverhalten von PUT für den Parameter
OVERWRITE
wurde geändert. Zuvor war die StandardeinstellungOVERWRITE=true
. Mit dieser Änderung ist die StandardeinstellungOVERWRITE=false
, sodass das Überschreiben von PUT explizit aktiviert werden muss.
Neue Features und Aktualisierungen¶
Konfigurationsparameter
IncludeRetryReason
wurde hinzugefügt, mit dem das Senden des HTTP-Statuscodes für Abfragewiederholungsanforderungen aktiviert oder deaktiviert werden kann.Neuer Kontext
WithOriginalTimestamp
hinzugefügt, der es ermöglicht, Arrow-Batches mit Nanosekunden-Genauigkeit im gesamten von Snowflake unterstützten Jahresbereich zu verwenden.Unterstützung für das Einstellen des Protokolliergrads in einer Konfigurationsdatei hinzugefügt.
Verbesserte Verarbeitungsleistung durch Zwischenspeichern der geparsten OCSP-Antworten.
Fehlerkorrekturen¶
Problem im Zusammenhang mit dem gleichzeitigen Zugriff auf einen HTAP-Abfragekontext-Cache wurde behoben.
Problem im Zusammenhang mit der fehlerhaften Behandlung von Verbindungen im asynchronen Demo-Beispiel wurde behoben.
Version 1.6.25 (26. September 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung der hybriden transaktionalen und analytischen Verarbeitung wurde hinzugefügt.
Funktion
GetQueryId
auf Anweisungsebene implementiert, sodass die letzte Abfrage-ID für diese Anweisung abgerufen werden kann.Wiederholungsgrund zu Abfrageanforderungen hinzugefügt.
Das für SSL-Verbindungen verwendete
cacert
-Bundle wurde aktualisiert.
Fehlerkorrekturen¶
Ein Problem mit OCSP-Fallback-Anforderungen in PrivateLink-Umgebungen behoben.
QueryID aus snowflakeConn-Struktur entfernt, um einige Racebedingungen zu beheben, wenn dieselbe Verbindung zwischen Threads wiederverwendet wurde.
Problem behoben, bei dem der Treiber bei erfolgreichen Abfragen einen Fehler anzeigte.
Version 1.6.24 (22. August 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung für Angabe eines temporären Verzeichnisses für Verschlüsselung und Komprimierung wurde hinzugefügt.
Verarbeitungsleistung wurde verbessert, indem Standortdaten einmal pro Abfrage geprüft werden, anstatt für jede Zeile und Spalte einzeln.
Unterstützung für Angabe eines benutzerdefinierten Kontexts beim Abrufen eines Arrow-Batches wurde hinzugefügt.
Fehlerkorrekturen¶
Keine.
Version 1.6.23 (25. Juli 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung für Bindung benannter Parameter wurde hinzugefügt.
Unterstützung von
sql.Null
-Typen für Zuordnung von Abfragebindungen hinzugefügt.Einstellen eines separaten Authentifizierungs-Timeouts für die Schlüsselpaar-Authentifizierung erlaubt.
Beispielanwendung für das Feature des verteilten Abrufs hinzugefügt.
Timeout für externe Browser hinzugefügt.
Vereinfachung der Konfiguration der Snowflake-Konnektivität bereitgestellt (siehe
/cmd
-Beispiele).Arrow-Bibliothek aktualisiert, um Handhabung von 32-Bit-Systemen zu verbessern.
Beispielanwendung bereitgestellt, die die Verwendung von Arrow-Batches demonstriert.
Fehlerkorrekturen¶
Fehlermeldungen von Racebedingungen mit mehreren Threads wurden behoben.
Problem behoben, bei dem asynchronen Anforderungen wiederholt werden, obwohl Abfrage noch in Ausführung ist.
Nullprüfungen vor dem Zugriff auf die Verbindungskonfiguration während des Herunterladens von Blöcken hinzugefügt.
Problem bei der Behandlung von JSON-Resultsets behoben, die vom Server zurückgegeben wurden, wenn der Treiber Arrow erwartete.
JWT-Token (mit neuem Ablaufdatum) wird erneut erstellt, wenn Schlüsselpaar-Authentifizierung wiederholt wird.
Timeout für Authentifizierung in externen Browsern hinzugefügt, um unendliches Warten zu verhindern, wenn der Benutzer die Browser-Registerkarte schließt.
Treiberpanik behoben, wenn sich das temporäre Dateisystem im Nur-Lese-Modus befindet.
Problem bei der Authentifizierung behoben, indem Benutzername und Kennwort nur für Authentifizierungsmodi verlangt werden, in denen dies erforderlich ist.
Version 1.6.22 (14. Juni 2023)¶
Neue Features und Aktualisierungen¶
Beispielanwendung
async.go,
zum „cmd“-Ordner hinzugefügt, um zu demonstrieren, wie asynchrone API-Aufrufe innerhalb des Golang-Treibers verwendet werden können.Beispielanwendung
multistatement.go
zum „cmd“-Ordner hinzugefügt, um zu demonstrieren, wie mehrere Anweisungen innerhalb des Golang-Treibers gesendet werden.
Fehlerkorrekturen¶
Problem behoben, bei dem
Commit()
undRollback()
nicht denselben Kontextsatz inBeginTx()
verwendeten, was zu Sperren führen konnte.
Version 1.6.21 (23. Mai 2023)¶
Neue Features und Aktualisierungen¶
Prüfung hinzugefügt, um festzustellen, ob die Kontextfrist überschritten wurde, wenn der Versuch in
snowflakeChunkDownloader
wiederholt wird.Arrow-Bibliothek wurde auf Version v12 aktualisiert.
Möglichkeit hinzugefügt, die Direct Arrow-IPC-Streams des Snowflake-Go-Treibers anzuzeigen.
Arrow Database Connectivity (ADBC), Version 0.4.0 integriert, damit die aktualisierte Snowflake-Bibliothek verwendet wird, um einen Snowflake-ADBC-Treiber bereitzustellen, der zusätzlich zu den nativen Go-Bindungen von allem genutzt werden kann, das auf eine C-Schnittstelle zugreift.
Fehlerkorrekturen¶
Ein int64-Überlaufproblem mit großen oder kleinen
datetime
-Werten wurde behoben.
Version 1.6.20 (18. April 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung von Anmeldungen mit Okta Identity Engine (OIE) hinzugefügt.
Speichernutzung durch Bereinigen des ersten Datenblocks vor dem Lesen des nächsten Datenblocks optimiert.
Fehlerkorrekturen¶
Panik-Problem bei Schnittstellenumwandlung behoben, durch das der Kontext abgebrochen wurde, während eine asynchrone Abfrage überwacht und ein abbrechbarer Kontext an
WithFetchResultByID
übergeben wurde.Protokollmeldungen für OCSP-Dateisperren-Fehler aktualisiert.
Fehler wird nun protokolliert, wenn ein einzelner Datei-Upload fehlschlägt.
Version 1.6.19 (21. März 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung von Go 1.20 hinzugefügt, und Unterstützung von Go 1.18 entfernt.
Migration von azure-storage-blob-go v0.15.0 auf azure-sdk-for-go v1.0.0.
Der Go-Treiber unterstützt jetzt den erneuten Versuch bei einem HTTP 429-Fehler.
Arrow-Bibliothek wurde auf Version v10 aktualisiert.
Fehlerkorrekturen¶
Problem behoben, bei dem der Go-Treiber eine SSO-URL vor dem Ausführen nicht validieren konnte. Jetzt verwendet der Treiber die Dienstprogramme URLValidator und URLEncoder, um die URL zu validieren und zu kodieren.
Problem mit Pointer-Datentyp
*time.Time
behoben, der ab GO-Treiber-Version 1.6.13 den Wert<nil>
zurückgibt.
Version 1.6.18 (22. Februar 2023)¶
Neue Features und Aktualisierungen¶
Keine.
Fehlerkorrekturen¶
Unterstützung der Deaktivierung des Verbindungscachings für mehrstufige Authentifizierung und für externe Browser hinzugefügt, die standardmäßig aktiviert sind, wobei aber einer der folgenden Konfigurationsparameter festzulegen ist.
ClientStoreTemporaryCredential=ConfigBoolFalse
ClientRequestMfaToken=ConfigBoolFalse
Version 1.6.17 (26. Januar 2023)¶
Neue Features und Aktualisierungen¶
golang.org/x/net/http2
auf Version 0.5.0 aktualisiert.
Fehlerkorrekturen¶
Verarbeitungsleistung von Abfragen mit mehreren Anweisungen verbessert, indem Abfragen übersprungen werden, die keinen Aktualisierungszähler zurückgeben.
Problem mit Verbindungscaching für MFA und externe Browser-Authentifizierung wurde behoben.
Mutex-Sperre zur Zuordnung von Konfigurationsparametern hinzugefügt, um bei Verwendung mehrerer Go-Routinen parallele Lese-/Schreiboperationen zu vermeiden.