Release v3.0.6 (databricks#1133)

## Description
Release v3.0.6

## Changes
This release includes:

### Added
- Added the EnableTokenFederation url param to enable or disable Token
federation feature. By default it is set to 1
- Added the ApiRetriableHttpCodes, ApiRetryTimeout url params to enable
retries for specific HTTP codes irrespective of Retry-After header. By
default the HTTP codes list is empty.

### Updated
- Added validation for positive integer configuration properties
(RowsFetchedPerBlock, BatchInsertSize, etc.) to prevent hangs and errors
when set to zero or negative values.
- Updated Circuit breaker to be triggered by 429 errors too.
- Refactored chunk download to keep a sliding window of chunk links. The
window advances as the main thread consumes chunks. These changes can be
enabled using the connection property EnableStreamingChunkProvider=1.
The changes are expected to make chunk download faster and robust.
- Added separate circuit breaker to handle 429 from SEA connection
creation calls, and fall back to Thrift.

### Fixed
- Fix driver crash when using `INTERVAL` types.
- Fix connection failure in restricted environments when `LogLevel.OFF`
is used.
- Fix U2M by including SDK OAuth HTML callback resources.
- Fix microsecond precision loss in
`PreparedStatement.setTimestamp(int,Timestamp, Calendar)` and address
thread-safety issues with global timezone modification.
- Fix metadata methods (`getColumns`, `getFunctions`, `getPrimaryKeys`,
`getImportedKeys`) to return empty ResultSets instead of throwing
exceptions when catalog parameter is NULL, for SEA.

## Testing
Version bump and release notes have been updated across all relevant
files.

OVERRIDE_FREEZE=true
SKIP_COVERAGE_CHECK=Flaky test for SEA circuit breaker
🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: msrathore-db

.github/ISSUE_TEMPLATE/bug_report.md

@@ -26,7 +26,7 @@ If available, share redacted client side logs
  - OS: [e.g. Windows]
  - Java version [e.g. Java 21]
  - Java vendor [e.g. OpenJDK]
- - Driver Version [e.g. 3.0.5]
+ - Driver Version [e.g. 3.0.6]
  - BI Tool (if used) [e.g. DBeaver]
  - BI Tool version (if applicable) [e.g. 24.3.5]
 

CHANGELOG.md

@@ -1,4 +1,25 @@
 # Version Changelog
+## [v3.0.6] - 2025-12-11
+
+### Added
+- Added the EnableTokenFederation url param to enable or disable Token federation feature. By default it is set to 1
+- Added the ApiRetriableHttpCodes, ApiRetryTimeout url params to enable retries for specific HTTP codes irrespective of Retry-After header. By default the HTTP codes list is empty.
+
+### Updated
+- Added validation for positive integer configuration properties (RowsFetchedPerBlock, BatchInsertSize, etc.) to prevent hangs and errors when set to zero or negative values.
+- Updated Circuit breaker to be triggered by 429 errors too.
+- Refactored chunk download to keep a sliding window of chunk links. The window advances as the main thread consumes chunks. These changes can be enabled using the connection property EnableStreamingChunkProvider=1. The changes are expected to make chunk download faster and robust.
+- Added separate circuit breaker to handle 429 from SQL Exec API connection creation calls, and fall back to Thrift.
+
+### Fixed
+- Fix driver crash when using `INTERVAL` types.
+- Fix connection failure in restricted environments when `LogLevel.OFF` is used.
+- Fix U2M by including SDK OAuth HTML callback resources.
+- Fix microsecond precision loss in `PreparedStatement.setTimestamp(int,Timestamp, Calendar)` and address thread-safety issues with global timezone modification.
+- Fix metadata methods (`getColumns`, `getFunctions`, `getPrimaryKeys`, `getImportedKeys`) to return empty ResultSets instead of throwing exceptions when catalog parameter is NULL, for SQL Exec API.
+
+---
+
 ## [v3.0.5] - 2025-11-20
 
 ### Added

NEXT_CHANGELOG.md

@@ -3,22 +3,10 @@
 ## [Unreleased]
 
 ### Added
-- Added the EnableTokenFederation url param to enable or disable Token federation feature. By default it is set to 1
-- Added the ApiRetriableHttpCodes, ApiRetryTimeout url params to enable retries for specific HTTP codes irrespective of Retry-After header. By default the HTTP codes list is empty.
 
 ### Updated
-- Added validation for positive integer configuration properties (RowsFetchedPerBlock, BatchInsertSize, etc.) to prevent hangs and errors when set to zero or negative values.
-- Updated Circuit breaker to be triggered by 429 errors too.
-- Refactored chunk download to keep a sliding window of chunk links. The window advances as the main thread consumes chunks. These changes can be enabled using the connection property EnableStreamingChunkProvider=1. The changes are expected to make chunk download faster and robust. 
-- Added separate circuit breaker to handle 429 from SEA connection creation calls, and fall back to Thrift.
 
 ### Fixed
 
-- Fix driver crash when using `INTERVAL` types.
-- Fix connection failure in restricted environments when `LogLevel.OFF` is used.
-- Fix U2M by including SDK OAuth HTML callback resources.
-- Fix microsecond precision loss in `PreparedStatement.setTimestamp(int,Timestamp, Calendar)` and address thread-safety issues with global timezone modification.
-- Fix metadata methods (`getColumns`, `getFunctions`, `getPrimaryKeys`, `getImportedKeys`) to return empty ResultSets instead of throwing exceptions when catalog parameter is NULL, for SEA.
-
 ---
 *Note: When making changes, please add your change under the appropriate section with a brief description.*

README.md

@@ -20,7 +20,7 @@ Add the following dependency to your `pom.xml`:
 <dependency>
   <groupId>com.databricks</groupId>
   <artifactId>databricks-jdbc</artifactId>
-  <version>3.0.5</version>
+  <version>3.0.6</version>
 </dependency>
 ```
 

development/.release-freeze.json

@@ -1,4 +1,4 @@
 {
-  "freeze": false,
-  "reason": ""
+  "freeze": true,
+  "reason": "Release freeze for v3.0.6"
 }

pom.xml

@@ -5,7 +5,7 @@
   <groupId>com.databricks</groupId>
   <artifactId>databricks-jdbc</artifactId>
   <!-- This value may be modified by a release script to reflect the current version of the driver. -->
-  <version>3.0.5</version>
+  <version>3.0.6</version>
   <packaging>jar</packaging>
   <name>Databricks JDBC Driver</name>
   <description>Databricks JDBC Driver.</description>

release-notes.txt

@@ -6,6 +6,26 @@ The release notes summarize enhancements, new features, known issues, workflow c
 
 Version History ==============================================================
 
+3.0.6 ========================================================================
+Released 2025-12-11
+
+Enhancements & New Features
+
+ * Added the EnableTokenFederation url param to enable or disable Token federation feature. By default it is set to 1
+ * Added the ApiRetriableHttpCodes, ApiRetryTimeout url params to enable retries for specific HTTP codes irrespective of Retry-After header. By default the HTTP codes list is empty.
+ * Added validation for positive integer configuration properties (RowsFetchedPerBlock, BatchInsertSize, etc.) to prevent hangs and errors when set to zero or negative values.
+ * Updated Circuit breaker to be triggered by 429 errors too.
+ * Refactored chunk download to keep a sliding window of chunk links. The window advances as the main thread consumes chunks. These changes can be enabled using the connection property EnableStreamingChunkProvider=1. The changes are expected to make chunk download faster and robust.
+ * Added separate circuit breaker to handle 429 from SEA connection creation calls, and fall back to Thrift.
+
+Resolved Issues
+
+ * Fix driver crash when using `INTERVAL` types.
+ * Fix connection failure in restricted environments when `LogLevel.OFF` is used.
+ * Fix U2M by including SDK OAuth HTML callback resources.
+ * Fix microsecond precision loss in `PreparedStatement.setTimestamp(int,Timestamp, Calendar)` and address thread-safety issues with global timezone modification.
+ * Fix metadata methods (`getColumns`, `getFunctions`, `getPrimaryKeys`, `getImportedKeys`) to return empty ResultSets instead of throwing exceptions when catalog parameter is NULL, for SEA.
+
 3.0.5 ========================================================================
 Released 2025-11-20
 

src/main/java/com/databricks/jdbc/common/util/DriverUtil.java

@@ -20,7 +20,7 @@
 public class DriverUtil {
 
   private static final JdbcLogger LOGGER = JdbcLoggerFactory.getLogger(DriverUtil.class);
-  private static final String DRIVER_VERSION = "3.0.5";
+  private static final String DRIVER_VERSION = "3.0.6";
   private static final String DRIVER_NAME = "oss-jdbc";
   private static final String JDBC_VERSION = "4.3";
 

src/test/java/com/databricks/jdbc/api/impl/DatabricksDatabaseMetaDataTest.java

@@ -813,7 +813,7 @@ public void testGetDriverName() throws SQLException {
   @Test
   public void testGetDriverVersion() throws SQLException {
     String result = metaData.getDriverVersion();
-    assertEquals("3.0.5", result);
+    assertEquals("3.0.6", result);
   }
 
   @Test

src/test/java/com/databricks/jdbc/common/safe/DatabricksDriverFeatureFlagsContextTest.java

@@ -37,7 +37,7 @@ class DatabricksDriverFeatureFlagsContextTest {
   @Mock private ObjectMapper objectMapperMock;
   private static final String FEATURE_FLAG_NAME = "featureFlagName";
   private static final String FEATURE_FLAGS_ENDPOINT =
-      "https://test-host/api/2.0/connector-service/feature-flags/OSS_JDBC/3.0.5";
+      "https://test-host/api/2.0/connector-service/feature-flags/OSS_JDBC/3.0.6";
 
   private DatabricksDriverFeatureFlagsContext context;