Release v3.0.5 (#1095)

## Description
Release v3.0.5

## Changes
This release includes:

### Added
- Added support for high-performance batched writes with parameter
interpolation:
- `supportManyParameters=1`: Enables parameter interpolation to bypass
256-parameter limit (default: 0)
- `EnableBatchedInserts=1`: Enables multi-row INSERT batching (default:
0)
  - `BatchInsertSize=<SIZE>`: Maximum rows per batch (default: 1000)
- Note: Large batches are chunked for execution. If a chunk fails,
previous chunks remain committed (no transaction rollback). Consider
using staging tables for critical workflows.
- Added Feature-flag integration for SQL Exec API rollout
- Call statements will return result sets in response

### Updated
- Minimized OAuth requests by reducing calls in feature flags and
telemetry.

### Fixed
- Fix: SQLInterpolator failing to escape temporal fields and special
characters.
- Fixed: Errors in table creation when using BIGINT, SMALLINT, TINYINT,
or VOID types.
- Fixed: PreparedStatement.getMetaData() now correctly reports TINYINT
columns as Types.TINYINT (java.lang.Byte) instead of Types.SMALLINT
(java.lang.Integer).
- Fixed: TINYINT to String conversion to return numeric representation
(e.g., "65") instead of character representation (e.g., "A").
- Fixed: Complex types (Structs, arrays, maps) now show detailed type
information in metadata calls in Thrift mode

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

OVERRIDE_FREEZE=true

---------

Co-authored-by: Claude <[email protected]>

Author: gopalldb

.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.4]
+ - Driver Version [e.g. 3.0.5]
  - BI Tool (if used) [e.g. DBeaver]
  - BI Tool version (if applicable) [e.g. 24.3.5]
 

CHANGELOG.md

@@ -1,4 +1,31 @@
 # Version Changelog
+## [v3.0.5] - 2025-11-20
+
+### Added
+- Added support for high-performance batched writes with parameter interpolation:
+  - `supportManyParameters=1`: Enables parameter interpolation to bypass 256-parameter limit (default: 0)
+  - `EnableBatchedInserts=1`: Enables multi-row INSERT batching (default: 0)
+  - `BatchInsertSize=<SIZE>`: Maximum rows per batch (default: 1000)
+  - Note: Large batches are chunked for execution. If a chunk fails, previous chunks remain committed (no transaction rollback). Consider using staging tables for critical workflows.
+- Added Feature-flag integration for SQL Exec API rollout
+- Call statements will return result sets in response
+- Add a gating flag for enabling GeoSpatial support: `EnableGeoSpatialSupport`. By default, it will be disabled
+
+### Updated
+- Minimized OAuth requests by reducing calls in feature flags and telemetry.
+- Geospatial `getWKB()` now returns OGC-compliant WKB values.
+
+### Fixed
+- Fix: SQLInterpolator failing to escape temporal fields and special characters.
+- Fixed: Errors in table creation when using BIGINT, SMALLINT, TINYINT, or VOID types.
+- Fixed: PreparedStatement.getMetaData() now correctly reports TINYINT columns as Types.TINYINT (java.lang.Byte) instead of Types.SMALLINT (java.lang.Integer).
+- Fixed: TINYINT to String conversion to return numeric representation (e.g., "65") instead of character representation (e.g., "A").
+- Fixed: Complex types (Structs, arrays, maps) now show detailed type information in metadata calls in Thrift mode
+- Fixed: incorrect chunk download/processing status codes.
+- Shade SLF4J to avoid conflicts with user applications.
+
+---
+
 ## [v3.0.4] - 2025-11-12
 
 ### Added

NEXT_CHANGELOG.md

@@ -3,36 +3,10 @@
 ## [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 support for high-performance batched writes with parameter interpolation:
-  - `supportManyParameters=1`: Enables parameter interpolation to bypass 256-parameter limit (default: 0)
-  - `EnableBatchedInserts=1`: Enables multi-row INSERT batching (default: 0)
-  - `BatchInsertSize=<SIZE>`: Maximum rows per batch (default: 1000)
-  - Note: Large batches are chunked for execution. If a chunk fails, previous chunks remain committed (no transaction rollback). Consider using staging tables for critical workflows.
-- 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.
-- Added Feature-flag integration for SQL Exec API rollout
-- Add a gating flag for enabling GeoSpatial support: `EnableGeoSpatialSupport`. By default, it will be disabled
-- Call statements will return result sets in response
 
 ### Updated
-- Geospatial `getWKB()` now returns OGC-compliant WKB values.
-- Minimized OAuth requests by reducing calls in feature flags and telemetry.
 
 ### 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
-- Fix: SQLInterpolator failing to escape temporal fields and special characters.
-- Fixed: Errors in table creation when using BIGINT, SMALLINT, TINYINT, or VOID types.
-- Fixed: PreparedStatement.getMetaData() now correctly reports TINYINT columns as Types.TINYINT (java.lang.Byte) instead of Types.SMALLINT (java.lang.Integer).
-- Fixed: TINYINT to String conversion to return numeric representation (e.g., "65") instead of character representation (e.g., "A").
-- Fixed: Complex types (Structs, arrays, maps) now show detailed type information in metadata calls in Thrift mode
-- Fixed: incorrect chunk download/processing status codes.
-- Shade SLF4J to avoid conflicts with user applications.
+
 ---
-*Note: When making changes, please add your change under the appropriate section with a brief description.* 
+*Note: When making changes, please add your change under the appropriate section with a brief description.*

development/.release-freeze.json

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

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.4</version>
+  <version>3.0.5</version>
   <packaging>jar</packaging>
   <name>Databricks JDBC Driver</name>
   <description>Databricks JDBC Driver.</description>

release-notes.txt

@@ -6,6 +6,28 @@ The release notes summarize enhancements, new features, known issues, workflow c
 
 Version History ==============================================================
 
+3.0.5 ========================================================================
+Released 2025-11-20
+
+Enhancements & New Features
+
+ * Added support for high-performance batched writes with parameter interpolation:
+   - `supportManyParameters=1`: Enables parameter interpolation to bypass 256-parameter limit (default: 0)
+   - `EnableBatchedInserts=1`: Enables multi-row INSERT batching (default: 0)
+   - `BatchInsertSize=<SIZE>`: Maximum rows per batch (default: 1000)
+   - Note: Large batches are chunked for execution. If a chunk fails, previous chunks remain committed (no transaction rollback). Consider using staging tables for critical workflows.
+ * Added Feature-flag integration for SQL Exec API rollout
+ * Call statements will return result sets in response
+ * Minimized OAuth requests by reducing calls in feature flags and telemetry.
+
+Resolved Issues
+
+ * Fix: SQLInterpolator failing to escape temporal fields and special characters.
+ * Fixed: Errors in table creation when using BIGINT, SMALLINT, TINYINT, or VOID types.
+ * Fixed: PreparedStatement.getMetaData() now correctly reports TINYINT columns as Types.TINYINT (java.lang.Byte) instead of Types.SMALLINT (java.lang.Integer).
+ * Fixed: TINYINT to String conversion to return numeric representation (e.g., "65") instead of character representation (e.g., "A").
+ * Fixed: Complex types (Structs, arrays, maps) now show detailed type information in metadata calls in Thrift mode
+
 3.0.4 ========================================================================
 Released 2025-11-12
 

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.4";
+  private static final String DRIVER_VERSION = "3.0.5";
   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.4", result);
+    assertEquals("3.0.5", 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.4";
+      "https://test-host/api/2.0/connector-service/feature-flags/OSS_JDBC/3.0.5";
 
   private DatabricksDriverFeatureFlagsContext context;
 

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.4", version);
+    assertEquals("3.0.5", version);
   }
 
   @Test
   public void testGetDriverVersionWithoutOSSSuffix() {
     String version = DriverUtil.getDriverVersionWithoutOSSSuffix();
     assertNotNull(version);
-    assertEquals("3.0.4", version);
+    assertEquals("3.0.5", version);
   }
 
   @Test