.NET Driver-Versionshinweise 2024¶

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

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

Version 3.0.0 (29. Februar 2024)¶

Zur Erhöhung der Sicherheit durchsucht der Treiber bei einfachen Protokollierungskonfigurationen nicht mehr ein temporäres Verzeichnis. Außerdem verlangt der Treiber nun, dass die Konfigurationsdatei für die Protokollierung auf Unix-Systemen die Dateiberechtigungen so einschränkt, dass nur der Eigentümer der Datei die Dateien ändern kann (z. B. chmod 0600, chmod 0644).
Der Treiber löst nun eine SnowflakeDbException-Ausnahme mit einer QueryID für PUT/GET-Fehler aus. Zuvor gab der Treiber unterschiedliche Typen von Ausnahmen zurück, z. B. FileNotFound und DirectoryNotFound. Wenn Ihre Anwendung auf eine dieser Ausnahmen geprüft hat, müssen Sie Ihren Code aktualisieren, um für PUT/GET-Fehler nur SnowflakeDbException zu behandeln.
Der Treiber unterstützt keine älteren Versionen, wie V1 und V2, des Block-Parsers/Downloaders mehr. Als Teil des Upgrades auf Version V3 unterstützt der Treiber nicht mehr die Konfigurationsoptionen SFConfiguration.UseV2JsonParser und SFConfiguration.UseV2ChunkDownloader. Wenn Sie ähnliche Befehle wie die folgenden verwendet haben, müssen Sie diese entfernen:
- SFConfiguration.Instance().ChunkParserVersion = 1; oder SFConfiguration.Instance().ChunkParserVersion = 2;
- SFConfiguration.Instance().ChunkDownloaderVersion = 1; oder SFConfiguration.Instance().ChunkDownloaderVersion = 2;
- SFConfiguration.Instance().UseV2JsonParser
- SFConfiguration.Instance().UseV2ChunkDownloader

Verbesserte Sicherheit beim einfachen Protokollierungs-Feature:
- Verwendung einer zuverlässigeren Methode zur Bestimmung des zu verwendenden Treiberverzeichnisses bei der Suche nach Client-Konfigurationsdateien.
- Es wird kein temporäres Verzeichnis mehr für die Konfigurationssuche verwendet.
- Erzwingen zusätzlicher Dateiberechtigungsprüfungen unter Unix für mehr Sicherheit.
- Hinzufügen einer ausführlicheren Protokollierung.
Okta-Wiederholungsproblem für SSO/SAML-Endpunkte wurde behoben.
Fail-Fast bei Befehlen ohne Textausführung hinzugefügt.
Ausnahmen, die von fehlgeschlagenen PUT/GET-Ausführungen ausgelöst werden, enthalten nun QueryId, wenn möglich.
Bibliothek Portable.BouncyCastle durch BouncyCastle.Cryptography ersetzt.

Ab Version 2.2.0 ersetzt der .NET-Treiber beim Konstruieren von Hostnamen auf Grundlage eines Kontonamens automatisch Unterstriche (_) im Kontonamen durch Bindestriche (-). Diese Änderung hat Auswirkungen für PrivateLink-Kunden, deren Kontonamen Unterstriche enthalten. In diesem Fall müssen Sie den Standardwert überschreiben, indem Sie allowUnderscoresInHost auf true setzen. Sie können dieses Verhalten überschreiben, indem Sie allowUnderscoresInHost=true in ConnectionString festlegen.

Diese Änderung wurde vorgenommen, um die DNS-Auflösungsfehler zu beheben, die bei der Verbindung über den öffentlichen Link mit Snowflake-Konten auftraten, deren Kontonamen Unterstriche enthielten.

Verbesserte Arrow-Abfrageleistung.
Ersetzt beim Konstruieren von Hostnamen auf Grundlage eines Kontonamens automatisch Unterstriche (_) im Kontonamen durch Bindestriche (-).
Konfigurationsparameter allowUnderscoresInHost hinzugefügt, damit Unterstriche (_) in Kontonamen im konstruierten Hostnamen beibehalten werden können. Mit diesem Parameter können Sie die mit diesem Release verbundene Verhaltensänderung außer Kraft setzen.

Um ein Problem mit Verbindungs-Timeouts zu beheben, schließt der Treiber beim Herstellen von Verbindungen jetzt asynchron abgelaufene Sitzungen.