==============================================================================
Cloudera JDBC Connector for Apache Hive Release Notes 
==============================================================================

The release notes provide details of enhancements, features, known issues, 
and workflow changes in Cloudera JDBC Connector for Apache Hive 2.6.34, as 
well as the version history.

This version of the connector supports the following data source versions and 
Java platforms:

 * All supported CDP and CDW versions

 * Java 8, 9, 11, 17, 25


2.6.34 =======================================================================

Released 2026-06-05

Enhancements & New Features

 * [HIVEJ-922] Updated third-party libraries

   The connector now uses the following third-party libraries:
   - commons-codec 1.22.0 (previously 1.17.2)
   - commons-logging 1.3.6 (previously 1.3.5)
   - libthrift 0.23.0 (previously 0.17.0)
   - netty-handler 4.2.13 (previously 4.1.130)
   
   New dependencies added due to thrift upgrade:
      - httpcomponents-httpclient5 5.6.1
      - httpcomponents-httpcore5 5.4.2
   

Workflow Changes =============================================================

The following changes may disrupt established workflows for the connector. 

2.6.32 -----------------------------------------------------------------------

 * [HIVEJ-901] Fixed an issue where the driver does not handle URL encoding in
   the connection string correctly.

   When using semicolons (;), percent signs (%), or any other URL reserved 
   characters in the connection string for any property value, 
   URL encoding/Percent-encoding must be used to represent them.

2.6.26 -----------------------------------------------------------------------

 * [HIVEJ-820] Updated JAAS configuration information

   By default, the JAAS configuration is turned off when Kerberos  
   authentication is used. To turn it on, set the JDBC_ENABLE_JAAS environment  
   variable to 1. For more information, see the Installation and Configuration
   Guide.


2.6.23 -----------------------------------------------------------------------
 
 * [HIVEJ-761] Removed support for Java 7

   Beginning with this release, the connector no longer supports Java 7.For a 
   list of supported JDBC versions, see the Installation and Configuration 
   Guide.
  
 * [HIVEJ-649] Removed support for Hive Server 1.0.0

   Beginning with this release, the connector no longer supports Hive Server 
   1.0.0. For a list of supported Hive Server versions, see the Installation
   and Configuration Guide.


2.6.19 -----------------------------------------------------------------------

 * [HIVEJ-722] Removed slf4j-log4j12 dependency

   Beginning with this release, the connector no longer includes the 
   slf4j-log4j12 library in the JAR file.


2.6.15 -----------------------------------------------------------------------

 * Removed support for CDH versions 5.11 to 5.16

   Beginning with this release, the driver no longer supports CDH versions 
   5.11 to 5.16. For a list of supported CDH versions, see the Installation 
   and Configuration Guide.

 * Removed support for JDBC 4 (Java 6)

   Beginning with this release, the driver no longer supports JDBC 4 (Java 6).
   For a list of supported JDBC versions, see the Installation and
   Configuration Guide.


2.6.1 ------------------------------------------------------------------------

 * Removed support for JDBC 3 (Java 5)

   Beginning with this release, the driver no longer supports JDBC 3 (Java 5).
   For a list of supported JDBC versions, see the Installation and 
   Configuration Guide.


Version History ==============================================================

2.6.33 -----------------------------------------------------------------------

Released 2026-04-24

Enhancements & New Features

 * [HIVEJ-904] Updated third-party libraries

   The connector now uses the following third-party libraries:
   - jackson-annotations 2.21 (previously 2.20.0)
   - jackson-core 2.21.2 (previously 2.20.0)
   - jackson-databind 2.21.2 (previously 2.20.0)   
   - log4j-api 2.25.4 (previously 2.25.3)
   - log4j-core 2.25.4 (previously 2.25.3)
   - log4j-slf4j-impl 2.25.4 (previously 2.25.3)
   - zookeeper 3.9.5 (previously 3.9.4)
   - zookeeper-jute 3.9.5 (previously 3.9.4)

 * [HIVEJ-905] Added support for Java 25

   The connector now supports Java 25.

2.6.32 -----------------------------------------------------------------------

Released 2026-03-06

Enhancements & New Features

 * [HIVEJ-882][HIVEJ-883][HIVEJ-895][HIVEJ-897] Updated third-party libraries

   The connector now uses the following third-party libraries:
   - log4j-api 2.25.3 (previously 2.25.2)
   - log4j-core 2.25.3 (previously 2.25.2)
   - log4j-slf4j-impl 2.25.3 (previously 2.25.2)
   - netty-handler 4.1.130 (previously 4.1.118)
   
   The commons-lang library has been removed.
   
   
Resolved Issues
The following issue has been resolved in Cloudera JDBC Connector for Apache 
Hive 2.6.32

 * [HIVEJ-900] When using Kerberos with IBM Java 17, an exception 
   occurs during connection.


2.6.30 -----------------------------------------------------------------------

Released 2025-11-28

Enhancements & New Features

 * [HIVEJ-868] Added server logging support
 
   Added the capability to print available server log information to the
   driver logs. To do this, set the EnableServerLogs property. For more 
   details, see the Installation and Configuration Guide.

 * [05394397][HIVEJ-872] Added support for Java 21

   The connector now supports Java 21.
   
 * [HIVEJ-873] Updated third-party libraries

   The connector now uses the following third-party libraries:
   - commons-logging 1.3.5 (previously 1.3.4)
   - jackson-annotations 2.20.0 (previously 2.18.2)
   - jackson-core 2.20.0 (previously 2.18.2)
   - jackson-databind 2.20.0 (previously 2.18.2)
   - log4j-api 2.25.2 (previously 2.24.3)
   - log4j-core 2.25.2 (previously 2.24.3)
   - log4j-slf4j-impl 2.25.2 (previously 2.24.3)
   - slf4j 2.0.17 (previously 2.0.16)
   - zookeeper 3.9.4 (previously 3.9.3)
   - zookeeper-jute 3.9.4 (previous 3.9.3)


Resolved Issues
The following issue has been resolved in Cloudera JDBC Connector for Apache 
Hive 2.6.30.

 * [HIVEJ-853] Fixed an issue with incorrect rounding of Decimal numbers with
   varying precision for parameterized insert batch queries.

 * [HIVEJ-854][HIVEJ-869] Fixed an issue with the driver logging extraneous 
   messages when log4j is already in the classpath. To resolve the issue, 
   please use the lean connector JAR instead of the standard connector JAR.


2.6.29 -----------------------------------------------------------------------

Released 2025-07-18

Resolved Issues
The following issue has been resolved in Cloudera JDBC Connector for Apache 
Hive 2.6.29.

 * [HIVEJ-851] Fixed an issue where Netty Handler still shows version 4.1.113 
   in META-INF, even after upgrading to 4.1.118.
   

2.6.28 -----------------------------------------------------------------------

Released 2025-02-28

Enhancements & New Features

 * [05130515][HIVEJ-834][HIVEJ-841] Updated third-party libraries

   The connector now uses the following third-party libraries:
   - commons-codec 1.17.2 (previously 1.17.1)
   - Jackson annotations 2.18.2 (previously 2.16.1)
   - Jackson core 2.18.2 (previously 2.16.1)
   - Jackson databind 2.18.2 (previously 2.16.1)
   - log4j-api 2.24.3 (previously 2.24.1)
   - log4j-core 2.24.3 (previously 2.24.1)
   - log4j-slf4j-impl 2.24.3 (previously 2.24.1)
   - netty-handler 4.1.118 (previously 4.1.115)


2.6.26 -----------------------------------------------------------------------

Released 2024-08-21

Enhancements & New Features

 * [03498512][HIVEJ-779] Updated SSLTrustStoreType property

   For the SSLTrustStoreType property, you can now specify the TrustStore  
   type. For more information, see the Installation and Configuration Guide.

 * [HIVEJ-820] Security improvement
   
   Resolved the issue where JNDI injection was causing RCE vulnerabilities in
   the JAAS framework, through the JDBC URL. 


2.6.25 -----------------------------------------------------------------------

Released 2024-02-05

Resolved Issues
The following issue has been resolved in Cloudera JDBC Connector for Apache 
Hive 2.6.25.

 * [HIVEJ-790] When connecting to a CDW cluster using HTTP transport, the 
   connector returns an error.


2.6.24 -----------------------------------------------------------------------

Released 2024-01-15

Enhancements & New Features

 * [HIVEJ-774] Query log support

   The connector can now retrieve the query logs from the server when 
   executing a SQL statement. For more information, see the Installation and 
   Configuration Guide.

 * [03600572][HIVEJ-785] Updated connector jar

   The connector now supports a lean connector jar that excludes log4j.


2.6.23 -----------------------------------------------------------------------

Released 2023-09-13

Enhancements & New Features

 * [HIVEJ-748] Support for JWT authentication

   You can now authenticate your connections to clusters with JWT 
   authentication. To do this, select JWT Authentication from the Mechanism 
   drop-down list (set the AuthMech property to 14). For more information, see
   the Installation and Configuration Guide.

 * [HIVEJ-762] Native GSS-API support

   The connector now supports the native GSS-API feature in the JDK without 
   the need to set the AllowTgtSessionKey property in the Windows registry. 
   For more information, see the Installation and Configuration Guide.

 * [HIVEJ-765] Updated third-party libraries

   The connector has been upgraded with the following third-party libraries:
   - Apache HttpClient 4.5.14 (previously 4.5.13)
   - Apache HttpCore 4.4.16 (previously 4.4.14)
   - Google Guava 31.1 (previously 30.1)
   - log4j-api 2.20.0 (previously 2.17.1)
   - log4j-core 2.20.0 (previously 2.17.1)
   - log4j-slf4j-impl 2.20.0 (previously 2.17.1)
   - slf4j 1.7.36 (previously 1.7.30)
   - thrift 0.17.0 (previously 0.13.0)

 * [HIVEJ-773][02840395] Updated Jackson libraries

   The connector now uses the following libraries for the Jackson JSON parser:
   - jackson-annotations-2.15.2 (previously 2.13.4)
   - jackson-core-2.15.2 (previously 2.13.4)
   - jackson-databind-2.15.2 (previously 2.13.4.2)


2.6.21 -----------------------------------------------------------------------

Released 2022-08-05

Enhancements & New Features

 * [00371927][HIVEJ-733] Updated SAML SSO authentication behavior
 
   When using SAML SSO authentication, the connector now automatically closes
   the browser tab opened by the connector. By default, the tab closes five 
   seconds after successfully authenticating. Note that the tab does not 
   automatically close after login credentials are entered during the first
   authentication attempt. Only tabs opened during subsequent authentication
   attempts, where login credentials are not required, are closed 
   automatically. If a browser window is not already opened, SAML SSO 
   authentication attempts always prompt the user for credentials.

  
Resolved Issues
The following issue has been resolved in Cloudera JDBC Connector for Apache 
Hive 2.6.21.

 * [00391275][HIVEJ-753] After closing HTTP connections, the connector does 
   not clean up native threads. 


2.6.20 -----------------------------------------------------------------------

Released 2022-06-30

Enhancements & New Features

 * [HIVEJ-750] Updated query behavior
 
   You can now configure the connector to return a regular result set, rather
   than a row count. To do this, set the NonRowcountQueryPrefixes property to 
   a comma-separated list of queries. For more information, see the 
   Installation and Configuration Guide.

 * [HIVEJ-743] Updated Jackson library

   The connector now uses the following Jackson versions: 
   - jackson-annotations 2.13.2 (previously 2.13.1)
   - jackson-core 2.13.2 (previously 2.13.1)
   - jackson-databind 2.13.2.2 (previously 2.13.1)

  
Resolved Issues
The following issue has been resolved in Cloudera JDBC Connector for Apache 
Hive 2.6.20.

 * [00388538][HIVEJ-751] When the server closes the TCP connection due to an
   idle timeout, the connector attempts to reuse a TCP connection for an HTTP 
   request afterwards, resulting in a "Communication link failure" error.


2.6.19 -----------------------------------------------------------------------

Released 2021-03-18

Enhancements & New Features

 * [00374597][HIVEJ-723] Updated log4j third-party libraries

   The JDBC 4.2 version of the connector has been updated to version 2.17.1
   of the log4j third-party libraries.
   
   The JDBC 4.1 version of the connector has been updated to version 2.12.4
   of the log4j third-party libraries. To address security vulnerabilities, do
   one of the following: 
   - In PatternLayout in the logging configuration, replace Context Lookups 
     like ${ctx:loginId} or $${ctx:loginId} with Thread Context Map patterns 
     (%X, %mdc, or %MDC). 
   - Otherwise, in the configuration, remove references to Context Lookups 
     like ${ctx:loginId} or $${ctx:loginId} where they originate from sources
     external to the application such as HTTP headers or user input. 
	 
 * [HIVEJ-725] Updated Jackson library

   The connector now uses version 2.13.1 of the Jackson library. Previously, 
   the connector used Jackson version 2.12.3. 	 


2.6.18 -----------------------------------------------------------------------

Released 2021-02-08

Resolved Issues
The following issue has been resolved in Cloudera JDBC Connector for Apache 
Hive 2.6.18.

 * [00372375][HIVEJ-728] When close() is not called on the connection object, 
   the connector prevents the JVM from exiting.   
   

============================================================================== 
Contact Us 
============================================================================== 

If you are having difficulties using the driver, our Community Forum 
(http://community.cloudera.com) may have your solution. In addition to 
providing user to user support, our forums are a great place to share your 
questions, comments, and feature requests with us. 

If you are a Subscription customer you may also use the Cloudera Support 
Portal (http://www.cloudera.com/content/cloudera/en/support/home.html) to 
search the Knowledge Base or file a Case.

Important: To help us assist you, prior to contacting Cloudera Support please 
prepare a detailed summary of the client and server environment including 
operating system version, patch level, and configuration.
