JDBC Driver-Versionshinweise 2026

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

  • Verhaltensänderungen

  • Neue Features

  • Fehlerkorrekturen für Kunden

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

Siehe JDBC-Treiber für die Dokumentation.

Version 4.0.2 (12. März 2026)

Neue Features und Aktualisierungen

Fehlerkorrekturen

  • Das Problem mit der Erneuerung von abgelaufenen Sitzungstoken beim Abfragen von Ergebnissen wurde behoben.

  • Das Problem mit der fehlenden asynchronen Minicore-Initialisierung, die während der öffentlichen API-Umstrukturierung in v4.0.0 gelöscht wurde, wurde behoben.

  • Der Protokolliergrad während der Treiberinitialisierung wurde angepasst.

  • Die Bereinigung für nonProxyHosts-Regex-Muster wurde hinzugefügt.

  • Der Fehler mit einer falsch formatierten Datei beim S3-Upload wurde behoben.

  • Es wurde ein periodisches Schließen von Sockets hinzugefügt, die vom Remote-Ende geschlossen werden.

  • Der mehrteilige Schwellenwert des S3-Clients wurde wieder auf 16 MB zurückgesetzt.

  • Die Fat-Jar mit S3-Iteration, bei der die Klasse software.amazon.awssdk.transfer.s3.internal.ApplyUserAgentInterceptor nicht gefunden werden konnte, wurde korrigiert.

  • Conscrypt wurde aus der Schattierung entfernt, um einen nativen Fehler failed to find class org/conscrypt/CryptoUpcalls zu verhindern.

  • Ein Fehler mit der NullPointerException, wenn der Cache für das HOME-Verzeichnis nicht verfügbar ist, wurde behoben.

  • Die Proxy-Authentifizierung bei der Verbindung mit GCP wurde korrigiert.

  • Korrektur eines Fehlers, bei dem ein vom Aufrufenden bereitgestelltes Schema in getStreams() ignoriert wurde.

  • Die Behandlung von S3-Fehlern, die zu einer NullPointerException führte, wurde korrigiert.

Version 4.0.1 (09. Februar 2026)

Neue Features und Aktualisierungen

  • Keine.

Fehlerkorrekturen

  • Die falsche Auswahl des Verschlüsselungsalgorithmus beim Hochladen einer Datei in S3, wobei der Kontoparameter client_encryption_key_size auf 256 festgelegt ist, wurde behoben.

  • Problem wurde behoben, bei dem die Fehlermeldung auftrat, dass die software.amazon.awssdk.transfer.s3.internal.ApplyUserAgentInterceptor-Klasse nicht im Fat-Jar gefunden werden konnte.

  • Conscrypt wurde aus der Schattierung entfernt, um einen nativen Fehler zu verhindern, wenn die org/conscrypt/CryptoUpcalls-Klasse nicht gefunden werden konnte.

  • Problem mit externer Browser-Authentifizierung nach Änderung des Enumerationsnamens behoben, der zum Fehler „Invalid connection URL: Invalid SSOUrl found“ führte.

  • Rollback Authentifikatornamens des externen Browsers zu externalbrowser.

  • BouncyCastle-Abhängigkeiten aktualisiert, um CVE-2025-8916 und CVE-2025-8885 zu adressieren.

Version 4.0.0 (27. Januar 2026)

Wichtig

Aufgrund einiger zugrunde liegende Probleme empfiehlt Snowflake, dass Kunden mit AWS und Azure kein Upgrade auf diese Version durchführen, wenn sie PUT- oder GET-Abfragen verwenden. Stattdessen empfiehlt Snowflake ein direktes Upgrade auf Version 4.0.1. Wenn Sie bereits ein Upgrade auf diese Version durchgeführt haben, sollten Sie so bald wie möglich ein Upgrade auf Version 4.0.1 durchführen.

Änderungen in Verhaltensänderungs-Release (BCR)

  • Die öffentliche API wurde umstrukturiert, und alle öffentlichen APIs wurden in die net.snowflake.client.api.*-Pakethierarchie verschoben:

    • net.snowflake.client.jdbc.SnowflakeDriver ist veraltet. Sie sollten stattdessen jetzt net.snowflake.client.api.driver.SnowflakeDriver verwenden.

    • Vereinheitlichte QueryStatus-Klasse in der öffentlichen API, welche die veraltete QueryStatus-Enumeration und die QueryStatusV2-Klasse ersetzt.

    • Neue öffentliche DownloadStreamConfig und UploadStreamConfig API-Schnittstellen für die Konfiguration von Stream-Upload/Download hinzugefügt.

    • SnowflakeDatabaseMetaData-Schnittstelle zur öffentlichen API für Operationen mit Datenbankmetadaten hinzugefügt.

    • SnowflakeAsyncResultSet-Schnittstelle zur öffentlichen API für asynchrone Abfrageoperationen hinzugefügt.

    • SnowflakeResultSetSerializable-Schnittstelle zur öffentlichen API hinzugefügt.

    • Interne Klassen wurden in die net.snowflake.client.internal.*-Pakethierarchie verschoben.

    Weitere Informationen dazu finden Sie unter Migration von JDBC-Treiber 3.x auf JDBC-Treiber 4.x.

  • BouncyCastle JVM-Eigenschaft von net.snowflake.jdbc.enableBouncyCastle zu net.snowflake.jdbc.useBundledBouncyCastleForPrivateKeyDecryption umbenannt.

  • Schon länger veraltete Klassen und Methoden wurden entfernt:

    • Die veraltete com.snowflake.client.jdbc.SnowflakeDriver-Klasse wurde entfernt.

    • Die veraltete QueryStatus-Enumeration aus dem net.snowflake.client.core-Paket wurde entfernt.

    • Die veraltete QueryStatusV2-Klasse aus dem net.snowflake.client.jdbc-Paket wurde entfernt.

    • Die veraltete SnowflakeType-Enumeration aus dem net.snowflake.client.jdbc-Paket wurde entfernt.

Neue Features und Aktualisierungen

  • Von AWS SDK v1 in AWS SDK v2 für verbesserte Leistung und moderne API-Unterstützung migriert.

  • Azure-Speicher SDK von Version 5 auf Version 12 aktualisiert.

  • nimbus-jose-jwt OAuth2-Abhängigkeit wurde auf Version 11.30.1 aktualisiert.

  • netty wurde auf Version 4.1.130.Final erhöht, um CVE-2025-67735 zu beheben.

Fehlerkorrekturen

  • Das Problem mit dem Wert für column_size in Datenbankmetadatenbefehlen wurde behoben, sodass sie mit der JDBC-Spezifikation übereinstimmt.

  • Ein NullPointerException wurde behoben, wenn In-Band-Telemetrie ohne HTTP-Antwort gesendet wird.