.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 und maxHttpRetries durch den Treiber wurde aktualisiert und der Standardwert von CONNECTION_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() zu SnowflakeDbCommand hinzugefügt, um die Abfrage-ID der zuletzt ausgeführten Abfrage abzurufen und so der bestehenden Funktionalität in SnowflakeDbDataReader 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 in HTTPClientHander 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() vor Dispose() 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 Funktionsaufruf Replace() 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.