============================================================================== 
Cloudera ODBC Driver for Impala Release Notes 
============================================================================== 

The release notes provide details of enhancements, features, known issues, 
and workflow changes in Cloudera ODBC Driver for Impala 2.6.8, as well as 
the version history. 


2.6.8 ========================================================================

Released 2019-09-27

Enhancements & New Features

 * [IMP-636] Updated Impala and CDH support

   The driver now supports Impala versions 2.7 through 3.3, and CDH 
   versions 5.9 through 5.16 and 6.0 through 6.2.

 * [IMP-666] Support for DATE data type
 
   The driver now supports the DATE data type for Impala version 3.3 and 
   later. For more information, see "Data Types" in the Installation and 
   Configuration Guide.


Resolved Issues
The following issues have been resolved in Cloudera ODBC Driver for Impala 
2.6.8.

 * [IMP-686] When an AnalysisException error occurs, the driver incorrectly
   classifies it as a syntax error and returns SQLState 42000.
   
 * [IMP-687] After SQLFetch returns an error, if you attempt to call SQLFetch 
   again, the driver terminates unexpectedly.


Known Issues
The following are known issues that you may encounter due to limitations in 
the data source, the driver, or an application.

 * Limited support for BINARY, DATE, and TIME data types

   - BINARY is not a supported data type in Impala.
   - DATE is supported only when you connect to Impala version 3.3 or later.
   - As a result of the limitations above, some values of TIME data types are
     also not supported.


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

The following changes may disrupt established workflows for the driver.


2.6.8 ------------------------------------------------------------------------

 * [IMP-680] Removed support for earlier versions of Impala and CDH
 
   Beginning with this release, the driver no longer supports Impala 1.0.1 to
   2.6 and CDH 5.0 to 5.8. For a list of supported versions, see the 
   Installation and Configuration Guide.


2.6.0 ------------------------------------------------------------------------

 * Minimum TLS Version

   Beginning with this release, the driver requires a minimum version of TLS 
   for encrypting the data store connection. By default, the driver requires 
   TLS version 1.2. This requirement may cause existing DSNs and connection 
   strings to stop working, if they are used to connect to data stores that 
   use a TLS version earlier than 1.2.

   To resolve this, in your DSN or connection string, set the Minimum TLS 
   option (the Min_TLS property) to the appropriate version of TLS for your 
   server. For more information, see the Installation and Configuration Guide.


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

2.6.7 ------------------------------------------------------------------------

Released 2019-08-23

Enhancements & New Features

 * [IMP-678] Reporting the maximum length of database fields

   You can now specify the maximum character length that the driver reports
   for the names of catalogs, columns, schemas, and tables. To do this, set
   the following connection properties:
   - MaxCatalogNameLen
   - MaxColumnNameLen
   - MaxSchemaNameLen
   - MaxTableNameLen

   For more information, see the Installation and Configuration Guide.

 * [IMP-634] Thrift transport modes

   The driver now enables you to specify the Thrift transport mode used. You 
   can configure the driver to use binary, HTTP, or SASL transport. For more 
   information, see the Installation and Configuration Guide.

 * [00139411][IMP-668] Updated driver version information in Linux binary

   You can now check the Linux driver's version from the driver binary file. 
   To do this, open the .so file in a text editor, and search for the text 
   "$driver_version_sb$:". The driver's version number is listed after this 
   text.

 * [IMP-677] New name for Enable Simulated Transactions

   The configuration option Enable Simulated Transactions (key name 
   EnableSimulatedTransactions) has been renamed to Ignore Transactions (key 
   name IgnoreTransactions). The previous key name continues to be supported 
   for backwards compatibility.

 * [IMP-671] Updated third-party library linking for Linux
 
   In the Linux driver, minor internal improvements have been implemented for 
   the linking between the third-party libraries and the main driver library.

 * [00141891][IMP-645] Internal driver improvements

   The driver has been updated with minor internal improvements.

 * [IMP-639] Updated default value for DisableOptimizedEncodingConverter

   The DisableOptimizedEncodingConvert property is now set to true by 
   default. This enables the driver to read and replace invalid UTF-8 
   characters.


Resolved Issues
The following issues have been resolved in Cloudera ODBC Driver for Impala 
2.6.7.

 * [00145514][IMP-672] When the driver sets the SQLSetConnectAttr attribute 
   SQL_ATTR_AUTOCOMMIT to SQL_AUTOCOMMIT_OFF, it terminates unexpectedly.

 * [00142448][IMP-647] When the driver executes a dynamic or parameterized 
   query with OFFSET, it returns an error.

   This issue has been resolved. The driver now properly supports LIMIT x,y 
   query syntax.

 * [IMP-654] When query retry is enabled, the driver does not retry a query 
   when a transport or communication link failure occurs.

 * [00144299][IMP-660] When you insert a negative value into a TINYINT 
   column, the driver returns an error.

 * [00144389][IMP-664] When the driver prepares a query that includes a 
   STRING column cast to a variable-length VARCHAR, a length of 32767 is 
   always returned.

 * [IMP-670] When retrieving a DECIMAL value that contains an integer ending 
   with 0, the driver erroneously returns SQL_SUCCESS_WITH_INFO and a 
   truncation error.


2.6.5 ------------------------------------------------------------------------

Released 2019-05-10

Enhancements & New Features

 * [IMP-573] unixODBC driver manager support for macOS 

   On macOS, you can now use the driver with unixODBC driver manager version 
   2.3.1. 

 * [IMP-628] Updated OpenSSL support
 
   The driver now uses OpenSSL 1.1.0j.
   
 * [IMP-636] Updated Impala and CDH support

   The driver now supports Impala versions 1.0.1 through 3.2, and CDH 
   versions 5.0 through 5.16 and 6.0 through 6.2.


Resolved Issues
The following issue has been resolved in Cloudera ODBC Driver for Impala 
2.6.5.

 * [00141430][IMP-623] In some cases, queries with a parameterized INSERT 
   clauses fail.
 
 * [00141992][IMP-629] The driver does not handle the scale and precision of 
   DECIMAL data correctly. 
   
 * [IMP-612] The driver does not pass a UID into the session when connected 
   using No Authentication.

 * [IMP-631] When inserting CHAR or VARCHAR values, the driver incorrectly 
   translates those values to CAST(CAST(...)). 
   
   This issue is resolved. The driver now translates these values to a single 
   CAST.

2.6.4 ------------------------------------------------------------------------

Released 2019-03-08

Enhancements & New Features

 * [00138885][IMP-601] SERVER as alias for HOST

   The driver now supports the use of SERVER as an alias for the HOST 
   configuration option. The configuration option HOST is still supported.

 * [IMP-607] Updated RapidJSON parser

   The driver has been updated to use version 1.1.0 of the RapidJSON parser. 


Resolved Issues
The following issue has been resolved in Cloudera ODBC Driver for Impala 
2.6.4.

 * [00139182][IMP-603] In some queries that include aliases in subqueries, 
   the driver translates the query to a syntax that is not supported by 
   Impala CDH6.
   

2.6.3 ------------------------------------------------------------------------

Released 2019-02-15

Enhancements & New Features

 * [00137626][IMP-567] Impala 3.0 support

   The driver now supports Apache Impala 1.0.1 through 3.0, and CDH versions 
   5.0 through 6.0. Previously the driver supported Apache Impala 1.0.1 
   through 2.12, and CDH versions 5.0 through 5.15.

 * [00135683][IMP-569] Oracle Linux support

   The driver now supports Oracle Linux RHCK and UEK 7.5.

 * [00136413][IMP-580] Support for driver-wide configuration on Windows

   On Windows, the driver can now read driver-wide configuration settings 
   from the [vendor].impalaodbc.ini file. This file must be present in the 
   \lib subfolder inside the driver installation directory.

 * [00136789][IMP-592] Support for invalid UTF-8 characters

   The driver can now read and replace invalid characters in UTF-8 data. To 
   do this, set the DisableOptimizedEncodingConverter option to "true". For 
   more information, see the Installation and Configuration Guide.

 * [IMP-589] Dynamically linked third-party libraries

   The Linux driver has been updated to use dynamically linked libraries for 
   ICU and OpenSSL. The installation directory now includes a "ThirdParty" 
   directory which contains all required runtime libraries for the driver.

 * [IMP-566] Updated ICU library

   The driver has been updated to use version 58.2 of the ICU library.


Resolved Issues
The following issues have been resolved in Cloudera ODBC Driver for Impala 
2.6.3.

 * [IMP-570] When the driver is installed on a machine that uses Turkish 
   locale settings, if you try to connect using a connection string where one 
   or more of the property names contains a lower-case "i" character, the 
   driver does not connect to the server.

 * [00135746][IMP-581] If the comments for a table are longer than 256 
   characters, the driver returns the following error: (20030) Memory 
   management error.

 * [00135988][IMP-582] In some cases, the driver returns the following 
   error: (20030) Memory management error.

 * [00136067][IMP-583] In some cases when the Use SQL Unicode Types property 
   is disabled, after SQL_PREPARE the driver incorrectly returns SQL_WCHAR 
   and SQL_WVARCHAR for SQL_CHAR and SQL_VARCHAR.


2.6.2 ------------------------------------------------------------------------

Released 2018-11-14
   
Resolved Issues
The following issue has been resolved in Cloudera ODBC Driver for Impala 
2.6.2.

 * [00134149] [IMP-565] The driver reports transport-related errors using the 
   generic error code 10000, instead of reporting them more specifically using 
   error code 08S01.


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

Released 2018-10-05

Enhancements & New Features

 * [IMP-474] Support for native scalar functions

   The driver now defaults to using native Impala scalar functions, provided 
   that those functions are supported by the Impala server.

 * [IMP-550] More informative Port value error messages 

   The driver now provides more detailed error messages when an invalid 
   value is specified for the Port connection property.

 * [IMP-576] Updated OpenSSL version

   The driver now uses OpenSSL version 1.1.0i. Previously, the driver used 
   OpenSSL version 1.1.0h.

 
Resolved Issues
The following issues were resolved in Cloudera ODBC Driver for Impala 
2.6.1.

 * [00134149] [IMP-553] The driver translates Winsock error 10053 into 
   generic error 10000.

   This issue has been resolved. The drive now translates the Winsock error 
   into error 08S01.

 * [00115866] [IMP-475] The driver treats strings with the literal value 
   "NULL" as NULL values.

 * [00133890] [IMP-552] The driver does not honor the SQL_ATTR_LOGIN_TIME 
   attribute when connecting, which may cause the driver to behave 
   unexpectedly.


2.6.0 ------------------------------------------------------------------------

Released 2018-07-25

Enhancements & New Features

 * [IMP-533] Support for Impala 2.12 and CDH 5.15

   The driver now supports Impala versions 1.0.1 through 2.12, and CDH 
   versions 5.0 through 5.15.

 * [IMP-478] Updated SSL support
 
   The driver now uses OpenSSL 1.1.0h.
   
 * [IMP-519] Minimum TLS support
   
   You can now specify the minimum level of TLS the driver will accept when
   authenticating into the data source.
   
 * [IMP-472] TLS Server Name Indication
  
   The driver now supports TLS Server Name Indication (SNI).
  
 * [IMP-508] Standardized log file names

   When logging is enabled, the driver now produces the following log files:

   - A [vendor]impalaodbcdriver.log file that logs driver activity that is not 
     specific to a connection, where [vendor] is the name of the driver vendor.

   - A [vendor]impalaodbcdriver_connection_[Number].log for each connection 
     made to the database, where [Number] is a number that identifies each log 
     file and [vendor] is the name of the driver vendor. This file logs driver
     activity that is specific to the connection.  

 * [IMP-462] More informative SSL error messages

   The driver now provides more detailed error messages for TLS/SSL errors.

 * [00116516] [IMP-484] Renamed keytab property

   The key name for the UPN Keytab Mapping File configuration property has
   been changed to keytab.
      
 * [IMP-520] Linux installation workflow improvement
 
   A single set of RPMs now work for all supported Linux distributions.
   Previously, a set of RPMs for each supported Linux distribution was
   required. 
   
 * [IMP-317] Support for result set cache and query retry

   The driver can now be configured to set a limit on the result set cache
   size, and to retry queries to the server. For details, see the Installation
   and Configuration guide.

   
Resolved Issues
The following issues were resolved in Cloudera ODBC Driver for Impala 
2.6.0.

 * [00131357] [IMP-511] In some cases queries are not properly closed on the
   server, negatively impacting server resources.

 * [IMP-486] In some cases, CAST AS VARCHAR does not function correctly.
 
 * [00119275] [IMP-503] Connections from a machine with large amounts of RAM
   are slower than expected.
   
 * [00132211] [IMP-523] Driver wide properties cannot be read from the .ini
   file.


============================================================================== 
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.
