.NET Driver-Versionshinweise 2023¶
Dieser Artikel enthält die Versionshinweise für .NET Driver, einschließlich der folgenden, sofern zutreffend:
Verhaltensänderungen
Neue Features
Fehlerkorrekturen für Kunden
Snowflake verwendet semantische Versionierung für .NET Driver-Aktualisierungen.
Version 2.1.5 (18. Dezember 2023)¶
Neue Features und Aktualisierungen¶
Keine
Fehlerkorrekturen¶
Problem beim Aktivieren von Prüfungen von Zertifikatssperren wurde behoben.
Version 2.1.4 (05. Dezember 2023)¶
Neue Features und Aktualisierungen¶
Dokumentation zum Aktivieren des Arrow-Formats hinzugefügt.
Fehlerkorrekturen¶
Validierung des Kontonamenformats in Verbindungsparametern wurde implementiert.
Synchronisierung des Zugriffs auf den Abfragekontext-Cache wurde hinzugefügt.
Version 2.1.3 (15. November 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung für die Verwaltung der Häufigkeit von Wiederholungsversuchen bei erfolglosen Verbindungsanforderungen hinzugefügt:
Parameter
RETRY_TIMEOUT
wurde mit einem Standardwert von 300 Sekunden hinzugefügt.Verwendung der Verbindungsparameter
CONNECTION_TIMEOUT
undmaxHttpRetries
durch den Treiber wurde aktualisiert und der Standardwert vonCONNECTION_TIMEOUT
auf 300 Sekunden geändert.
Arrow-Format ist jetzt als Vorschau-Feature verfügbar (wird in Zukunft standardmäßig aktiviert sein).
Fehlerkorrekturen¶
Problem im Zusammenhang mit unerwarteten Ausnahmen bei der Optimierung von HTAP-Metadaten wurde behoben.
Problem mit HTAP wurde behoben, das beim Ändern von Datenbanken oder Schemas auftreten konnte.
Asynchrone Bereinigung beim Zerstören eines Pools implementiert, um potenzielle Deadlocks zu vermeiden.
Ungenaue Fehlerinformationen zu PUT-Befehlen für GCP entfernt.
Problem mit fehlerhaftem Verhalten von
SnowflakeDbConnection.Dispose
behoben.
Version 2.1.2 (27. September 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung der hybriden transaktionalen und analytischen Verarbeitung wurde hinzugefügt:
Wiederholungskontext für Wiederholungen bei Abfrageanforderungen hinzugefügt.
Zwischenspeicherung des Abfragekontexts hinzugefügt.
Methode
GetQueryId()
zuSnowflakeDbCommand
hinzugefügt, um die Abfrage-ID der zuletzt ausgeführten Abfrage abzurufen und so der bestehenden Funktionalität inSnowflakeDbDataReader
zu entsprechen.
Fehlerkorrekturen¶
Problem behoben, bei dem PUT/GET-Befehle bei internen Stagingbereichen auf Azure Government-Cloudkonten fehlschlagen konnten.
Geringerer Speicherverbrauch bei PUT/GET-Operationen.
Problem behoben, das beim Hoch- und Herunterladen von Daten auftreten konnte, wenn sich die Quelldateien von den Zieldateien unterschieden, wie es beispielsweise bei der automatischen Dateikomprimierung der Fall sein kann.
Version 2.1.1 (22. August 2023)¶
Neue Features und Aktualisierungen¶
Keine.
Fehlerkorrekturen¶
Problem behoben, bei dem Testverbindungen nach erfolgreichem Erstellen nicht wieder verwendet wurden.
Problem behoben, bei dem die Platzhalter
*
und?
in Dateipfaden nicht korrekt funktionierten.Problem behoben, bei dem der Treiber fälschlicherweise Benutzername und Kennwort für die externe Browser-Authentifizierung verlangte.
Version 2.1.0 (27. Juli 2023)¶
Änderung in Verhaltensänderungs-Release (BCR)¶
Problem behoben, bei dem der .NET-Treiber unter bestimmten Bedingungen HTTP-Anforderungen unbegrenzt wiederholen konnte. Bisher hat der .NET-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 werden endlose HTTP-Wiederholungsversuche, die von „execute“- und „executeQuery“-Aufrufen ausgehen, deaktiviert. Der .NET-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 .NET-Treiber fehlgeschlagene HTTP-Anforderungen unendlich oft wiederholt.
Neue Features und Aktualisierungen¶
In GET-Befehlen verbesserte Behandlung von entfernten Pfaden, die ein Unterverzeichnis enthalten.
Fehlerkorrekturen¶
Problem mit Verbindungspools behoben, das auftreten konnte, wenn eine unsaubere Verbindung geschlossen und die Methode
BeginTransaction
explizit aufgerufen wird.Problem mit
UseProxy
inHTTPClientHander
wurde behoben.Der Verbindungsparameter
BROWSER_RESPONSE_TIMEOUT
wurde hinzugefügt, um ein Problem mit der Authentifizierung in einem externen Browser zu beheben. Der Standardwert ist 120 Sekunden.Problem mit Timeouts beim Verbindungspool während der Sommerzeitumstellung behoben.
Version 2.0.25 (16. Juni 2023)¶
Neue Features und Aktualisierungen¶
Keine
Fehlerkorrekturen¶
Problem behoben, bei dem das Proxykennwort in der Snowflake-Protokolldatei sichtbar sein konnte.
Problem behoben, bei dem
SnowflakeDbDataReader.HasRows()
bei einigen Abfragetypen (z. B. SELECT) immer „true“ zurückgab, unabhängig davon, ob gültige Zeilen im Abfrageergebnis vorhanden waren oder nicht.Ein gelegentlich auftretendes Problem „Authentifikator-Token ist abgelaufen“ oder „Sitzung nicht mehr vorhanden“ bei aktiviertem Verbindungspooling wurde behoben.
Verwendung von
WinHttpHandler
wurde entfernt.Problem behoben, bei dem Wiederholungsversuche beim Herunterladen von Blöcken gelegentlich fehlschlugen, z. B. wenn ein Netzwerkfehler auftrat, nachdem die Daten teilweise heruntergeladen worden waren.
Problem bei der Wiederholung des Herunterladens von Blöcken behoben und Testen dieser Wiederholungen verbessert.
Version 2.0.24 (23. Mai 2023)¶
Neue Features und Aktualisierungen¶
Protokollierung der Sitzungs-ID wurde hinzugefügt, um die Aktivitäten jeder Sitzung besser verfolgen zu können, wenn mehrere Verbindungen parallel genutzt werden.
Fehlerkorrekturen¶
Problem behoben, bei dem eine .NET-Anwendung einen nicht autorisierten Fehler auslöste, wenn Verbindungspooling aktiviert war.
Problem mit 401-Fehlern behoben, die durch leere Sitzungs-Tokens verursacht wurden.
Version 2.0.23 (19. April 2023)¶
Neue Features und Aktualisierungen¶
Die unterstützte Legacy-Version wurde auf Version 4.7.1 geändert.
Fehlerkorrekturen¶
Problem behoben, bei dem eine .NET-Anwendung wegen einer nicht verarbeiteten Ausnahme beendet wurde, wenn
client_session_keep_alive=true
war.Problem behoben, bei dem COMMIT durch ein unnötiges Rollback unterbrochen werden konnte.
Problem behoben, bei dem eine Verbindung eine Sitzung nicht beenden konnte, wenn Verbindungspooling aktiviert war.
Problem behoben, bei dem der Aufruf von
Close()
vorDispose()
zu doppelten Verbindungen in einem Pool führte.Problem behoben, bei dem ein Fehler auftrat, wenn eine obligatorische USER-Eigenschaft nicht angegeben wurde.
Problem WinHttpHandler
PlatformNotSupportedException
wurde behoben. Der .NET-Treiber verwendet WinHttpHandler jetzt nur noch für .NET-Framework-Anwendungen.Problem behoben, bei dem ein Fehler auftrat, wenn in der Verbindungszeichenfolge für SSO-Anmeldungen eine leere USER-Eigenschaft übergeben wurde.
Problem behoben, bei dem Datenbanknamen, die Leerzeichen enthielten und in doppelte Anführungszeichen eingeschlossen waren (z. B. „Meine DB“), nicht korrekt verarbeitet wurden.
Version 2.0.22 (22. März 2023)¶
Neue Features und Aktualisierungen¶
Keine.
Fehlerkorrekturen¶
Problem behoben, das dazu führte, dass Anwendungen, bei denen
CLIENT_SESSION_KEEP_ALIVE=true
eingestellt war, beim Schließen der Verbindung hängen blieben.Problem behoben, bei dem die Ausführung von Abfragen nach einer Zeitüberschreitung zeitweise fehlschlug.
Problem behoben, bei dem der .NET-Treiber in einem FIPS-aktivierten Bereitstellung keine PUT-Befehle ausführen konnte.
Auslösefehler des .NET-Konnektors behoben: „System.Net.Http.WinHttpException (80072EE2, 12002): Error 12002 calling WINHTTP_CALLBACK_STATUS_REQUEST_ERROR“.
Es wurde damit begonnen, das Präfix https: zu AWS-Endpunkten hinzuzufügen, die das Präfix nicht enthalten.
Das Beispiel zum Angeben eines unverschlüsselten privaten Schlüssels (aus einer Datei gelesen) in der Datei
README.md
wurde aktualisiert, um den FunktionsaufrufReplace()
zu entfernen.
Version 2.0.21 (22. Februar 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung für Verwendung von GCS-Zugriffstoken bei PUT- und GET-Abfragen hinzugefügt (#585).
Fehlerkorrekturen¶
Verbesserte Ausnahmebehandlung, um Stacktraces aufzubewahren.
Version 2.0.20 (24. Januar 2023)¶
Neue Features und Aktualisierungen¶
Unterstützung von neuer Okta OIE hinzugefügt.
Fehlerprotokollierung beim Parsen von JSON wurde verbessert, indem die
queryid
in die Protokollmeldung aufgenommen wurde.
Fehlerkorrekturen¶
Problem behoben, bei dem PUT/GET nicht den korrekten Kompressionstyp der hochzuladenden Dateien ermittelt haben.
Problem behoben, bei dem die Ergebniswerte von PUT/GET nicht dem entsprechenden Feld zugeordnet wurden.
Problem behoben, das beim Kürzen von SQL-Abfragen auftrat, die einen abschließenden Kommentar enthielten.
Problem behoben, bei dem die Okta-Authentifizierung fehlschlug, wenn ein HTTP-429-Fehler auftrat.
Problem mit Sitzungstimeouts behoben, indem der Sitzungsparameter
DEFAULT_TIMEOUT_IN_SECOND
hinzugefügt wurde.