Skip to content

Commit 8c23ab0

Browse files
madhav-dbmadhav-db
authored
Add release notes for versions 1.0.1 through 1.0.5 (#826)
1 parent 32f96bb commit 8c23ab0

5 files changed

Lines changed: 416 additions & 0 deletions

File tree

‎release-notes/release-notes-v1.0.1.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Databricks JDBC Driver v1.0.1 Release Notes
2+
3+
We're excited to announce the release of Databricks JDBC Driver v1.0.1. This release includes significant improvements to support for complex data types, prepared statements, and enhances backward compatibility with the latest Databricks driver.
4+
5+
## What's New in v1.0.1
6+
7+
### Added Features
8+
- **Enhanced Data Type Support**
9+
- Support for complex data types, including `MAP`, `ARRAY`, and `STRUCT`
10+
- Support for `TIMESTAMP_NTZ` and `VARIANT` data types
11+
12+
- **Extended Prepared Statement Support**
13+
- Improved support for prepared statements when using Thrift DBSQL/all-purpose clusters
14+
15+
- **Performance Optimizations**
16+
- Improved driver performance for large queries by optimizing chunk handling
17+
- Configurable HTTP connection pool size for better resource management
18+
19+
- **Authentication Enhancements**
20+
- Support for Azure Active Directory (AAD) Service Principal in M2M OAuth
21+
- Implemented `java.sql.Driver#getPropertyInfo` to fetch driver properties
22+
23+
### Updated
24+
- Set Thrift mode as the default for the driver
25+
- Improved driver telemetry (opt-in feature) for better monitoring and debugging
26+
- Enhanced test infrastructure to improve accuracy and reliability
27+
- Added SQL state support in SEA mode
28+
- Changes to JDBC URL parameters (to ensure compatibility with the latest Databricks driver):
29+
1. Removed `catalog` in favour of `ConnCatalog`
30+
2. Removed `schema` in favour of `ConnSchema`
31+
3. Renamed `OAuthDiscoveryURL` to `OIDCDiscoveryEndpoint`
32+
4. Renamed `OAuth2TokenEndpoint` to `OAuth2ConnAuthTokenEndpoint`
33+
5. Renamed `OAuth2AuthorizationEndPoint` to `OAuth2ConnAuthAuthorizeEndpoint`
34+
6. Renamed `OAuthDiscoveryMode` to `EnableOIDCDiscovery`
35+
7. Renamed `OAuthRefreshToken` to `Auth_RefreshToken`
36+
37+
### Fixed Issues
38+
- Ensured `TIMESTAMP` columns are returned in local time
39+
- Resolved inconsistencies in schema and catalog retrieval from the `Connection` class
40+
- Fixed minor issues with metadata fetching in Thrift mode
41+
- Addressed incorrect handling of access tokens provided via client info
42+
- Corrected the driver version reported by `DatabaseMetaData`
43+
- Fixed case-sensitive behaviour while fetching client info
44+
45+
## Documentation
46+
47+
For detailed information about the Databricks JDBC Driver, please refer to our [official documentation](https://docs.databricks.com/sql/jdbc-odbc-drivers.html).
48+
49+
## Feedback
50+
51+
Your feedback is important to us. If you encounter any issues or have suggestions for improvement, please [submit an issue](https://github.com/databricks/databricks-jdbc/issues) on our GitHub repository.

‎release-notes/release-notes-v1.0.2.md‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Databricks JDBC Driver v1.0.2 Release Notes
2+
3+
We're excited to announce the release of Databricks JDBC Driver v1.0.2. This release includes important fixes for columnType conversion and string handling.
4+
5+
## What's New in v1.0.2
6+
7+
### Fixed Issues
8+
- Fixed `columnType` conversion for `Variant` and `Timestamp_NTZ` types
9+
- Fixed minor issue for string handling with whitespaces
10+
11+
## Previous Release: v1.0.1
12+
13+
### Added Features
14+
- **Enhanced Data Type Support**
15+
- Support for complex data types, including `MAP`, `ARRAY`, and `STRUCT`
16+
- Support for `TIMESTAMP_NTZ` and `VARIANT` data types
17+
18+
- **Extended Prepared Statement Support**
19+
- Improved support for prepared statements when using Thrift DBSQL/all-purpose clusters
20+
21+
- **Performance Optimizations**
22+
- Improved driver performance for large queries by optimizing chunk handling
23+
- Configurable HTTP connection pool size for better resource management
24+
25+
- **Authentication Enhancements**
26+
- Support for Azure Active Directory (AAD) Service Principal in M2M OAuth
27+
- Implemented `java.sql.Driver#getPropertyInfo` to fetch driver properties
28+
29+
### Updated
30+
- Set Thrift mode as the default for the driver
31+
- Improved driver telemetry (opt-in feature) for better monitoring and debugging
32+
- Enhanced test infrastructure to improve accuracy and reliability
33+
- Added SQL state support in SEA mode
34+
- Changes to JDBC URL parameters (to ensure compatibility with the latest Databricks driver):
35+
1. Removed `catalog` in favour of `ConnCatalog`
36+
2. Removed `schema` in favour of `ConnSchema`
37+
3. Renamed `OAuthDiscoveryURL` to `OIDCDiscoveryEndpoint`
38+
4. Renamed `OAuth2TokenEndpoint` to `OAuth2ConnAuthTokenEndpoint`
39+
5. Renamed `OAuth2AuthorizationEndPoint` to `OAuth2ConnAuthAuthorizeEndpoint`
40+
6. Renamed `OAuthDiscoveryMode` to `EnableOIDCDiscovery`
41+
7. Renamed `OAuthRefreshToken` to `Auth_RefreshToken`
42+
43+
### Fixed Issues
44+
- Ensured `TIMESTAMP` columns are returned in local time
45+
- Resolved inconsistencies in schema and catalog retrieval from the `Connection` class
46+
- Fixed minor issues with metadata fetching in Thrift mode
47+
- Addressed incorrect handling of access tokens provided via client info
48+
- Corrected the driver version reported by `DatabaseMetaData`
49+
- Fixed case-sensitive behaviour while fetching client info
50+
51+
## Documentation
52+
53+
For detailed information about the Databricks JDBC Driver, please refer to our [official documentation](https://docs.databricks.com/sql/jdbc-odbc-drivers.html).
54+
55+
## Feedback
56+
57+
Your feedback is important to us. If you encounter any issues or have suggestions for improvement, please [submit an issue](https://github.com/databricks/databricks-jdbc/issues) on our GitHub repository.

‎release-notes/release-notes-v1.0.3.md‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
# Databricks JDBC Driver v1.0.3 Release Notes
2+
3+
We're excited to announce the release of Databricks JDBC Driver v1.0.3. This release introduces significant new features and improvements, including centralized timeout management, custom retry strategies, and Azure Managed Identity authentication.
4+
5+
## What's New in v1.0.3
6+
7+
### Added Features
8+
- **Timeout Management**
9+
- Introduces a centralized timeout check and automatic cancellation for statements
10+
11+
- **Connection Parameters**
12+
- Allows specifying a default size for `STRING` columns (set to 255 by default) via `defaultStringColumnLength` connection parameter
13+
- Allows adjusting the number of rows retrieved in each fetch operation for better performance via `RowsFetchedPerBlock` parameter
14+
- Allows overriding the default OAuth redirect port (8020) with a single port or comma-separated list of ports using `OAuth2RedirectUrlPort`
15+
- Support for custom headers in the JDBC URL via `http.header.<key>=<value>` connection parameter
16+
17+
- **Retry and Performance**
18+
- Implements a custom retry strategy to handle long-running tasks and connection attempts
19+
- Adds existence checks for volumes, objects, and prefixes to improve operational coverage
20+
21+
- **Authentication**
22+
- Added support for Azure Managed Identity based authentication
23+
24+
### Updated
25+
- Removes the hard-coded default poll interval configuration in favor of a user-defined parameter for greater flexibility
26+
- Adjusts the handling of `NULL` and non-`NULL` boolean values
27+
28+
### Fixed Issues
29+
- Ensures the driver respects the configured limit on the number of rows returned
30+
- Improves retry behaviour to cover all operations, relying solely on the total retry time specified via the driver URL parameter
31+
- Returns an exception instead of `-1` when a column is not found
32+
33+
## Previous Release: v1.0.2
34+
35+
### Fixed Issues
36+
- Fixed `columnType` conversion for `Variant` and `Timestamp_NTZ` types
37+
- Fixed minor issue for string handling with whitespaces
38+
39+
## Previous Release: v1.0.1
40+
41+
### Added Features
42+
- **Enhanced Data Type Support**
43+
- Support for complex data types, including `MAP`, `ARRAY`, and `STRUCT`
44+
- Support for `TIMESTAMP_NTZ` and `VARIANT` data types
45+
46+
- **Extended Prepared Statement Support**
47+
- Improved support for prepared statements when using Thrift DBSQL/all-purpose clusters
48+
49+
- **Performance Optimizations**
50+
- Improved driver performance for large queries by optimizing chunk handling
51+
- Configurable HTTP connection pool size for better resource management
52+
53+
- **Authentication Enhancements**
54+
- Support for Azure Active Directory (AAD) Service Principal in M2M OAuth
55+
- Implemented `java.sql.Driver#getPropertyInfo` to fetch driver properties
56+
57+
### Updated
58+
- Set Thrift mode as the default for the driver
59+
- Improved driver telemetry (opt-in feature) for better monitoring and debugging
60+
- Enhanced test infrastructure to improve accuracy and reliability
61+
- Added SQL state support in SEA mode
62+
- Changes to JDBC URL parameters (to ensure compatibility with the latest Databricks driver):
63+
1. Removed `catalog` in favour of `ConnCatalog`
64+
2. Removed `schema` in favour of `ConnSchema`
65+
3. Renamed `OAuthDiscoveryURL` to `OIDCDiscoveryEndpoint`
66+
4. Renamed `OAuth2TokenEndpoint` to `OAuth2ConnAuthTokenEndpoint`
67+
5. Renamed `OAuth2AuthorizationEndPoint` to `OAuth2ConnAuthAuthorizeEndpoint`
68+
6. Renamed `OAuthDiscoveryMode` to `EnableOIDCDiscovery`
69+
7. Renamed `OAuthRefreshToken` to `Auth_RefreshToken`
70+
71+
### Fixed Issues
72+
- Ensured `TIMESTAMP` columns are returned in local time
73+
- Resolved inconsistencies in schema and catalog retrieval from the `Connection` class
74+
- Fixed minor issues with metadata fetching in Thrift mode
75+
- Addressed incorrect handling of access tokens provided via client info
76+
- Corrected the driver version reported by `DatabaseMetaData`
77+
- Fixed case-sensitive behaviour while fetching client info
78+
79+
## Documentation
80+
81+
For detailed information about the Databricks JDBC Driver, please refer to our [official documentation](https://docs.databricks.com/sql/jdbc-odbc-drivers.html).
82+
83+
## Feedback
84+
85+
Your feedback is important to us. If you encounter any issues or have suggestions for improvement, please [submit an issue](https://github.com/databricks/databricks-jdbc/issues) on our GitHub repository.

‎release-notes/release-notes-v1.0.4.md‎

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
# Databricks JDBC Driver v1.0.4 Release Notes
2+
3+
We're excited to announce the release of Databricks JDBC Driver v1.0.4. This release includes important new connection parameters, SDK updates, and several bug fixes to improve stability and security.
4+
5+
## What's New in v1.0.4
6+
7+
### Added Features
8+
- **Connection Parameters**
9+
- Support for connection parameter `SocketTimeout`
10+
- Handle server returned Thrift version as part of open session response gracefully
11+
- Added OWASP security check in the repository
12+
13+
### Updated
14+
- Updated SDK to the latest version (0.44.0)
15+
- Add descriptive messages in thrift error scenario
16+
17+
### Fixed Issues
18+
- `BigDecimal` is now set correctly to `NULL` if null value is provided
19+
- Fixed issue with JDBC URL not being parsed correctly when compute path is provided via properties
20+
- Addressed CVE vulnerabilities (CVE-2024-47535, CVE-2025-25193, CVE-2023-33953)
21+
- Fix bug in `preparedStatement` decimal parameter in thrift flow
22+
23+
## Previous Release: v1.0.3
24+
25+
### Added Features
26+
- **Timeout Management**
27+
- Introduces a centralized timeout check and automatic cancellation for statements
28+
29+
- **Connection Parameters**
30+
- Allows specifying a default size for `STRING` columns (set to 255 by default) via `defaultStringColumnLength` connection parameter
31+
- Allows adjusting the number of rows retrieved in each fetch operation for better performance via `RowsFetchedPerBlock` parameter
32+
- Allows overriding the default OAuth redirect port (8020) with a single port or comma-separated list of ports using `OAuth2RedirectUrlPort`
33+
- Support for custom headers in the JDBC URL via `http.header.<key>=<value>` connection parameter
34+
35+
- **Retry and Performance**
36+
- Implements a custom retry strategy to handle long-running tasks and connection attempts
37+
- Adds existence checks for volumes, objects, and prefixes to improve operational coverage
38+
39+
- **Authentication**
40+
- Added support for Azure Managed Identity based authentication
41+
42+
### Updated
43+
- Removes the hard-coded default poll interval configuration in favor of a user-defined parameter for greater flexibility
44+
- Adjusts the handling of `NULL` and non-`NULL` boolean values
45+
46+
### Fixed Issues
47+
- Ensures the driver respects the configured limit on the number of rows returned
48+
- Improves retry behaviour to cover all operations, relying solely on the total retry time specified via the driver URL parameter
49+
- Returns an exception instead of `-1` when a column is not found
50+
51+
## Previous Release: v1.0.2
52+
53+
### Fixed Issues
54+
- Fixed `columnType` conversion for `Variant` and `Timestamp_NTZ` types
55+
- Fixed minor issue for string handling with whitespaces
56+
57+
## Previous Release: v1.0.1
58+
59+
### Added Features
60+
- **Enhanced Data Type Support**
61+
- Support for complex data types, including `MAP`, `ARRAY`, and `STRUCT`
62+
- Support for `TIMESTAMP_NTZ` and `VARIANT` data types
63+
64+
- **Extended Prepared Statement Support**
65+
- Improved support for prepared statements when using Thrift DBSQL/all-purpose clusters
66+
67+
- **Performance Optimizations**
68+
- Improved driver performance for large queries by optimizing chunk handling
69+
- Configurable HTTP connection pool size for better resource management
70+
71+
- **Authentication Enhancements**
72+
- Support for Azure Active Directory (AAD) Service Principal in M2M OAuth
73+
- Implemented `java.sql.Driver#getPropertyInfo` to fetch driver properties
74+
75+
### Updated
76+
- Set Thrift mode as the default for the driver
77+
- Improved driver telemetry (opt-in feature) for better monitoring and debugging
78+
- Enhanced test infrastructure to improve accuracy and reliability
79+
- Added SQL state support in SEA mode
80+
- Changes to JDBC URL parameters (to ensure compatibility with the latest Databricks driver):
81+
1. Removed `catalog` in favour of `ConnCatalog`
82+
2. Removed `schema` in favour of `ConnSchema`
83+
3. Renamed `OAuthDiscoveryURL` to `OIDCDiscoveryEndpoint`
84+
4. Renamed `OAuth2TokenEndpoint` to `OAuth2ConnAuthTokenEndpoint`
85+
5. Renamed `OAuth2AuthorizationEndPoint` to `OAuth2ConnAuthAuthorizeEndpoint`
86+
6. Renamed `OAuthDiscoveryMode` to `EnableOIDCDiscovery`
87+
7. Renamed `OAuthRefreshToken` to `Auth_RefreshToken`
88+
89+
### Fixed Issues
90+
- Ensured `TIMESTAMP` columns are returned in local time
91+
- Resolved inconsistencies in schema and catalog retrieval from the `Connection` class
92+
- Fixed minor issues with metadata fetching in Thrift mode
93+
- Addressed incorrect handling of access tokens provided via client info
94+
- Corrected the driver version reported by `DatabaseMetaData`
95+
- Fixed case-sensitive behaviour while fetching client info
96+
97+
## Documentation
98+
99+
For detailed information about the Databricks JDBC Driver, please refer to our [official documentation](https://docs.databricks.com/sql/jdbc-odbc-drivers.html).
100+
101+
## Feedback
102+
103+
Your feedback is important to us. If you encounter any issues or have suggestions for improvement, please [submit an issue](https://github.com/databricks/databricks-jdbc/issues) on our GitHub repository.

0 commit comments

Comments
 (0)