Release v3.0.4 (#1078)

jprakash-db · jayantsing-db · web-flow · commit 5057a1a2ba55 · 2025-11-14T00:39:56.000+05:30
## Description
Release v3.0.4

## Testing
&lt;!-- Describe how the changes have been tested--&gt;

## Additional Notes to the Reviewer
&lt;!-- Share any additional context or insights that may help the reviewer
understand the changes better. This could include challenges faced,
limitations, or compromises made during the development process.
Also, mention any areas of the code that you would like the reviewer to
focus on specifically. --&gt;

---------

Co-authored-by: Jayant Singh &lt;jayant.singh@databricks.com&gt;
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.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.1]
+ - Driver Version [e.g. 3.0.4]
  - BI Tool (if used) [e.g. DBeaver]
  - BI Tool version (if applicable) [e.g. 24.3.5]
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,4 +1,24 @@
 # Version Changelog
+## [v3.0.4] - 2025-11-12
+
+### Added
+- Added support for geospatial data types.
+- Added support for telemetry log levels, which can be controlled via the connection parameter `TelemetryLogLevel`. This allows users to configure the verbosity of telemetry logging from OFF to TRACE.
+- Added full support for JDBC transaction control methods in Databricks. Transaction support in Databricks is currently available as a Private Preview. The `IgnoreTransactions` connection parameter can be set to `1` to disable or no-op transaction control methods.
+- Added a new config attribute `DisableOauthRefreshToken` to control whether refresh tokens are requested in OAuth exchanges. By default, the driver does not include the `offline_access` scope. If `offline_access` is explicitly provided by the user, it is preserved and not removed.
+
+### Updated
+- Updated sdk version from 0.65.0 to 0.69.0
+
+### Fixed
+- Fixed SQL syntax error when LIKE queries contain empty ESCAPE clauses.
+- Fix: driver failing to authenticate on token update in U2M flow.
+- Fix: driver failing to parse complex data types with nullable attributes.
+- Fixed: Resolved SDK token-caching regression causing token refresh on every call. SDK is now configured once to avoid excessive token endpoint hits and rate limiting.
+- Fixed: TimestampConverter.toString() returning ISO8601 format with timezone conversion instead of SQL standard format.
+- Fixed: Driver not loading complete JSON result in the case of SEA Inline without Arrow
+---
+
 ## [v3.0.3] - 2025-10-30
 ### Added
 
diff --git a/NEXT_CHANGELOG.md b/NEXT_CHANGELOG.md
@@ -3,20 +3,9 @@
 ## [Unreleased]
 
 ### Added
-- Added support for geospatial data types.
-- Added support for telemetry log levels, which can be controlled via the connection parameter `TelemetryLogLevel`. This allows users to configure the verbosity of telemetry logging from OFF to TRACE.
-- Added full support for JDBC transaction control methods in Databricks. Transaction support in Databricks is currently available as a Private Preview. The `IgnoreTransactions` connection parameter can be set to `1` to disable or no-op transaction control methods.
-- Added a new config attribute `DisableOauthRefreshToken` to control whether refresh tokens are requested in OAuth exchanges. By default, the driver does not include the `offline_access` scope. If `offline_access` is explicitly provided by the user, it is preserved and not removed.
 
 ### Updated
-- Updated sdk version from 0.65.0 to 0.69.0
 
 ### Fixed
-- Fixed SQL syntax error when LIKE queries contain empty ESCAPE clauses.
-- Fix: driver failing to authenticate on token update in U2M flow.
-- Fix: driver failing to parse complex data types with nullable attributes.
-- Fixed: Resolved SDK token-caching regression causing token refresh on every call. SDK is now configured once to avoid excessive token endpoint hits and rate limiting.
-- Fixed: TimestampConverter.toString() returning ISO8601 format with timezone conversion instead of SQL standard format.
-- Fixed: Driver not loading complete JSON result in the case of SEA Inline without Arrow
 ---
 *Note: When making changes, please add your change under the appropriate section with a brief description.* 
diff --git a/development/.release-freeze.json b/development/.release-freeze.json
@@ -1,4 +1,4 @@
 {
-  "freeze": true,
-  "reason": "release 3.0.4"
+  "freeze": false,
+  "reason": ""
 }
diff --git a/pom.xml b/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.1</version>
+  <version>3.0.4</version>
   <packaging>jar</packaging>
   <name>Databricks JDBC Driver</name>
   <description>Databricks JDBC Driver.</description>
diff --git a/release-notes.txt b/release-notes.txt
@@ -6,6 +6,25 @@ The release notes summarize enhancements, new features, known issues, workflow c
 
 Version History ==============================================================
 
+3.0.4 ========================================================================
+Released 2025-11-12
+
+Enhancements & New Features
+
+ * Added support for geospatial data types.
+ * Added support for telemetry log levels, which can be controlled via the connection parameter `TelemetryLogLevel`. This allows users to configure the verbosity of telemetry logging from OFF to TRACE.
+ * Added full support for JDBC transaction control methods in Databricks. Transaction support in Databricks is currently available as a Private Preview. The `IgnoreTransactions` connection parameter can be set to `1` to disable or no-op transaction control methods.
+ * Added a new config attribute `DisableOauthRefreshToken` to control whether refresh tokens are requested in OAuth exchanges. By default, the driver does not include the `offline_access` scope. If `offline_access` is explicitly provided by the user, it is preserved and not removed.
+
+Resolved Issues
+
+ * Fixed SQL syntax error when LIKE queries contain empty ESCAPE clauses.
+ * Fix: driver failing to authenticate on token update in U2M flow.
+ * Fix: driver failing to parse complex data types with nullable attributes.
+ * Fixed: Resolved SDK token-caching regression causing token refresh on every call. SDK is now configured once to avoid excessive token endpoint hits and rate limiting.
+ * Fixed: TimestampConverter.toString() returning ISO8601 format with timezone conversion instead of SQL standard format.
+ * Fixed: Driver not loading complete JSON result in the case of SEA Inline without Arrow
+
 3.0.3 ========================================================================
 Released 2025-10-30
 
diff --git a/src/main/java/com/databricks/jdbc/common/util/DriverUtil.java b/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.1";
+  private static final String DRIVER_VERSION = "3.0.4";
   private static final String DRIVER_NAME = "oss-jdbc";
   private static final String JDBC_VERSION = "4.3";
 
diff --git a/src/test/java/com/databricks/jdbc/api/impl/DatabricksDatabaseMetaDataTest.java b/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.1", result);
+    assertEquals("3.0.4", result);
   }
 
   @Test
diff --git a/src/test/java/com/databricks/jdbc/common/safe/DatabricksDriverFeatureFlagsContextTest.java b/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.1";
+      "https://test-host/api/2.0/connector-service/feature-flags/OSS_JDBC/3.0.4";
 
   private DatabricksDriverFeatureFlagsContext context;
 
diff --git a/src/test/java/com/databricks/jdbc/common/util/DriverUtilTest.java b/src/test/java/com/databricks/jdbc/common/util/DriverUtilTest.java
@@ -14,14 +14,14 @@ public class DriverUtilTest {
   public void testGetDriverVersion() {
     String version = DriverUtil.getDriverVersion();
     assertNotNull(version);
-    assertEquals("3.0.1", version);
+    assertEquals("3.0.4", version);
   }
 
   @Test
   public void testGetDriverVersionWithoutOSSSuffix() {
     String version = DriverUtil.getDriverVersionWithoutOSSSuffix();
     assertNotNull(version);
-    assertEquals("3.0.1", version);
+    assertEquals("3.0.4", version);
   }
 
   @Test
diff --git a/src/test/java/com/databricks/jdbc/common/util/UserAgentManagerTest.java b/src/test/java/com/databricks/jdbc/common/util/UserAgentManagerTest.java
@@ -84,7 +84,7 @@ void testUserAgentSetsClientCorrectly() throws DatabricksSQLException {
         DatabricksConnectionContextFactory.create(CLUSTER_JDBC_URL, new Properties());
     UserAgentManager.setUserAgent(connectionContext);
     String userAgent = getUserAgentString();
-    assertTrue(userAgent.contains("DatabricksJDBCDriverOSS/3.0.1"));
+    assertTrue(userAgent.contains("DatabricksJDBCDriverOSS/3.0.4"));
     assertTrue(userAgent.contains(" Java/THttpClient"));
     assertTrue(userAgent.contains(" MyApp/version"));
     assertTrue(userAgent.contains(" databricks-jdbc-http "));
@@ -95,7 +95,7 @@ void testUserAgentSetsClientCorrectly() throws DatabricksSQLException {
         DatabricksConnectionContextFactory.create(WAREHOUSE_JDBC_URL, new Properties());
     UserAgentManager.setUserAgent(connectionContext);
     userAgent = getUserAgentString();
-    assertTrue(userAgent.contains("DatabricksJDBCDriverOSS/3.0.1"));
+    assertTrue(userAgent.contains("DatabricksJDBCDriverOSS/3.0.4"));
     assertTrue(userAgent.contains(" Java/THttpClient"));
     assertTrue(userAgent.contains(" MyApp/version"));
     assertTrue(userAgent.contains(" databricks-jdbc-http "));
@@ -106,7 +106,7 @@ void testUserAgentSetsClientCorrectly() throws DatabricksSQLException {
         DatabricksConnectionContextFactory.create(WAREHOUSE_JDBC_URL_WITH_SEA, new Properties());
     UserAgentManager.setUserAgent(connectionContext);
     userAgent = getUserAgentString();
-    assertTrue(userAgent.contains("DatabricksJDBCDriverOSS/3.0.1"));
+    assertTrue(userAgent.contains("DatabricksJDBCDriverOSS/3.0.4"));
     assertTrue(userAgent.contains(" Java/SQLExecHttpClient"));
     assertTrue(userAgent.contains(" databricks-jdbc-http "));
     assertFalse(userAgent.contains("databricks-sdk-java"));
diff --git a/thin_public_pom.xml b/thin_public_pom.xml
@@ -4,7 +4,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.databricks</groupId>
   <artifactId>databricks-jdbc-thin</artifactId>
-  <version>3.0.1</version>
+  <version>3.0.4</version>
   <packaging>jar</packaging>
   <name>Databricks JDBC Driver Thin</name>
   <description>Databricks JDBC Driver Thin JAR - requires external dependencies.</description>
diff --git a/uber-minimal-pom.xml b/uber-minimal-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.1</version>
+  <version>3.0.4</version>
   <packaging>jar</packaging>
   <name>Databricks JDBC Driver</name>
   <description>Databricks JDBC Driver.</description>

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`	`1`	`{`
`2`		`- "freeze": true,`
`3`		`- "reason": "release 3.0.4"`
	`2`	`+ "freeze": false,`
	`3`	`+ "reason": ""`
`4`	`4`	`}`
Original file line number	Diff line number	Diff line change
`@@ -813,7 +813,7 @@ public void testGetDriverName() throws SQLException {`
`813`	`813`	`@Test`
`814`	`814`	`public void testGetDriverVersion() throws SQLException {`
`815`	`815`	`String result = metaData.getDriverVersion();`
`816`		`- assertEquals("3.0.1", result);`
	`816`	`+ assertEquals("3.0.4", result);`
`817`	`817`	`}`
`818`	`818`
`819`	`819`	`@Test`