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

Transcription

1 Cloudera ODBC Driver for Impala The release notes provide details of enhancements and features in Cloudera ODBC Driver for Impala , as well as the version history. The following are highlights of the new features and functionalities that have been added to Cloudera ODBC Driver for Impala Nested data types (ARRAY, MAP, and STRUCT) now supported The driver now supports ARRAY, MAP, and STRUCT data types. For more information about how the driver translates and works with these data types, see "Data Types" in the Cloudera ODBC Driver for Impala Installation and Configuration Guide. Added MANIFEST file for the OpenSSL library The driver now loads the OpenSSL library based on a MANIFEST file, which prevents SideBySide errors from occurring. Data encryption and integrity support implemented for the SASL SSPI plugin The driver now supports data encryption and integrity support in the SASL SSPI plugin, providing improved support for connections that are authenticated through Kerberos. The following issues were resolved in Cloudera ODBC Driver for Impala SQLCancel does not work correctly Before, SQLCancel was slow to execute and did not cancel the query in the Impala server. Now, SQLCancel works as expected. Version History Version ODBC Driver for Impala

2 Support added for calling SQLGetData on columns that come before a bound column Previously, after you call SQLBindCol on a column, you cannot call SQLGetData on any columns that appear before that column. The driver has been updated so that you can now call SQLGetData on any column regardless of the relative order of the columns. Updated support for SQL_C_TINYINT Previously, the driver treated SQL_C_TINYINT data as unsigned tinyint data. The driver now treats SQL_C_TINYINT data as signed tinyint data, which is more compatible with Impala. Improved error messaging for authentication issues The driver now returns a more informative error message when a connection fails due to an issue in the authentication settings. Support added for saving passwords as encrypted strings in the Windows Registry When using the user interface of the Windows driver to configure a connection, you can now save the password for authentication (the PWD value) by selecting the "Save Password" check box. The saved password will be obscured (not saved in plain text). However, it is still possible for the encrypted password to be copied and used. Driver now supports the use of "_HOST" as a special value for the Host FQDN option When configuring Kerberos authentication, you can now set the value of the Host FQDN option (the KrbFQDN key) to _HOST in order to use the Impala server host name as the fully qualified domain name for Kerberos authentication. The following issues were resolved in Cloudera ODBC Driver for Impala When using User Name and Password authentication over SSL, the driver does not retrieve the user name and password information, and authentication fails Version ODBC Driver for Impala

3 Debian 7 now supported You can now install and use the driver on computers that run Debian 7 (Ubuntu LTS and Ubuntu LTS). Implemented driver configuration option for enabling or disabling connections to SSL-enabled servers that use self-signed certificates You can now configure the "Allow Self-signed Server Certificate" option (the AllowSelfSignedServerCert key) to control whether the driver allows connections to an Impala server that uses a self-signed SSL certificate. The following issues were resolved in Cloudera ODBC Driver for Impala When the driver is configured to use the User Name and Password authentication mechanism, it does not prompt you to provide a password The driver now prompts you for your credentials as needed. On Windows computers, when the driver is configured to use Kerberos authentication and MIT Kerberos is not installed, the connection fails Now, when the driver uses Kerberos authentication and MIT Kerberos is not installed, the driver tries to establish the connection using the SSPI plugin instead of returning an error immediately. The driver does not return result sets for queries that contain common table expression syntax The driver now returns result sets as expected. The driver does not return the correct SQLNumResultCols() values for queries that contain common table expression syntax Version The driver now returns the correct SQLNumResultCols() values. ODBC Driver for Impala SSL now configured separately from authentication Before, you would enable SSL in the driver by setting the authentication mechanism to "SASL User Name and Password (SSL)" (AuthMech=4) or "No Authentication (SSL)" 3

4 (AuthMech=5). You can now use the new "Enable SSL" option (the SSL key) to enable or disable SSL connections, and use the "Mechanism" option (the AuthMech key) solely to configure authentication. Implemented option for configuring SASL when using User Name and Password authentication Before, you would enable SASL by setting the authentication mechanism to "SASL User Name and Password" (AuthMech=3) and disable SASL by setting the authentication mechanism to "NOSASL User Name and Password" (AuthMech=6). Now, you can configure these types of authentication by setting the "Mechanism" option to "User Name and Password" (AuthMech=3) and then using the new "Use Simple Authentication and Security Layer (SASL)" option (the UseSASL key) to enable or disable SASL. Deprecated some SASL and SSL authentication mechanisms Due to the changes in SASL and SSL configuration mentioned above, the following authentication mechanisms have been deprecated: SASL User Name and Password (SSL) No Authentication (SSL) NOSASL User Name and Password Also, the "SASL User Name and Password" mechanism has been renamed to "User Name and Password". The following issues were resolved in Cloudera ODBC Driver for Impala Column names in a GROUP BY clause are not qualified The driver now qualifies the column names in GROUP BY clauses. When converting data of type INTEGER to data of type STRING, the driver does not correctly convert the smallest INTEGER value Version The driver now converts the data correctly. ODBC Driver for Impala

5 "Use Only SSPI Plugin" option can now be configured separately for DSN and DSN-less connections You can now configure the "Use Only SSPI Plugin" option for a specific DSN, or all DSNless connections, or both. Windows 8 now supported Version You can now install and use the driver on computers that run Windows 8. ODBC Driver for Impala Updated translation support for custom aggregate and scalar functions The driver is now able to translate more custom aggregate and scalar functions. Updated key name for the "Database" connection attribute The "Database" connection attribute is now named "Schema". Set the "Schema" key to specify the database schema that the driver should use when a schema is not explicitly specified in a query. Implemented driver configuration option for using the SSPI plugin to handle Kerberos authentication By default, the Windows driver uses MIT Kerberos to handle Kerberos authentication, and only uses the SSPI plugin if the gssapi library is not available. You can now configure the Windows driver to use the SSPI plugin by default by setting the "Use Only SSPI Plugin" option (the UseOnlySSPI key). Updated handling of schema, table, and column names in catalog function calls In catalog function calls, the names of schemas, tables, and columns are now caseinsensitive. The following issues were resolved in Cloudera ODBC Driver for Impala Driver cannot translate INSERT statements that contain a row with a NULL value in a numeric column and another row with a numeric literal in the same numeric column 5

6 When using the driver with the Custom SQL feature in Tableau, queries involving custom scalar and aggregate functions are not translated correctly When working in translation mode, the driver returns an error if the query contains subquery syntax Version ODBC Driver for Impala "Use SQL Unicode Types" configuration option implemented You can now use the "Use SQL Unicode Types" option (the UseUnicodeSQLCharacterTypes key) to control whether the driver returns SQL_WCHAR/SQL_WVARCHAR or SQL_CHAR/SQL_VARCHAR for CHAR, STRING, and VARCHAR columns. Updated process for retrieving result set metadata The driver now uses the GetSchemas and GetTables client API calls instead of the SHOW TABLES and SHOW SCHEMAS queries to retrieve schema names and tables metadata. This update enables the driver to restrict the metadata that is returned based on the user's privileges. The following issues were resolved in Cloudera ODBC Driver for Impala SQLGetInfo(SQL_NULL_COLLATION) incorrectly reports SQL_NC_LOW SQLGetInfo(SQL_NULL_COLLATION) now reports SQL_NC_HIGH. Translated INSERT statements do not include back quotes (`) around column names INSERT statements that are translated by the driver now have the correct syntax and surround column names with back quotes (`). SQLGetInfo(SQL_CREATE_VIEW) incorrectly reports 0 SQLGetInfo(SQL_CREATE_VIEW) now reports SQL_CV_CREATE_VIEW. 6

7 Driver returns unintuitive error message when connected to the wrong Thrift service Version The driver now returns an improved error message to inform the user to make sure the host and port correspond to the correct Impala service. ODBC Driver for Impala Authentication using user credentials without SASL implemented You can now configure the driver to authenticate a connection using a user name and password but without using SASL (Simple Authentication and Security Layer). The following issues were resolved in Cloudera ODBC Driver for Impala SQLDescribeCol returns incorrect column lengths Windows DSN Setup dialog box allows passwords to be saved to and loaded from DSNs Passwords are no longer saved to or loaded from DSNs, even if you provide a value in the DSN Setup dialog box. The driver may terminate unexpectedly when running concurrent operations using the same connection from different threads Version ODBC Driver for Impala ODBC 3.80 supported The driver now supports ODBC OpenSSL 1.0.0n supported The driver has been upgraded to use OpenSSL 1.0.0n. 7

8 Server-side properties supported You can now use the driver to set server-side properties via a Data Source Name (DSN). Impala 2.0 CHAR(n) and VARCHAR(n) data types supported The driver now supports the Impala 2.0 data types CHAR(n) and VARCHAR(n). Columnar result set serialization supported The driver now supports columnar result set serialization. Interval literals supported The driver now supports interval literals. Custom scalar and aggregate functions supported The driver now supports custom scalar and aggregate functions. Support added for translating CAST and CONVERT functions used on SQL_DATE data The driver is now able to translate CAST and CONVERT functions that are used on SQL_DATE data into CAST(TO_DATE(<value>), TIMESTAMP). Support added for translating CURRENT_TIMESTAMP(0) The driver is now able to translate CURRENT_TIMESTAMP(0) into NOW(). On Mac OS X, the driver is automatically installed to the system's odbcinst.ini file When you install the driver on a Mac OS X computer, the odbcinst.ini file on the system is automatically updated to include the necessary configurations for running the driver. Driver environment variable renamed to CLOUDERAIMPALAINI The environment variable for locating the cloudera.impalaodbc.ini configuration file has been renamed to CLOUDERAIMPALAINI. The default value of CLOUDERAIMPALAINI is the default installation location of the cloudera.impalaodbc.ini file. The following issues were resolved in Cloudera ODBC Driver for Impala CAST and CONVERT functions used on SQL_DATE and SQL_<TYPE>_TIME data are not properly passed through to the CAST(<value> AS DATE/TIME) function 8

9 REPLACE functions cannot be translated if the second argument contains a regular expression with special characters Version ODBC Driver for Impala Translation of SUBSTRING(string_Exp, length) syntax supported The driver is now able to translate SUBSTRING(string_exp, length) syntax. The following issues were resolved in Cloudera ODBC Driver for Impala CROSS JOIN syntax is not translated correctly Tables metadata is sometimes replicated to other databases Identifiers in generated queries are not quoted In CREATE TABLE statements, the precision and scale of the DECIMAL data type is translated incorrectly Version ODBC Driver for Impala OpenSSL 1.0.0m supported The driver has been upgraded to use OpenSSL 1.0.0m. 9

10 Impala 1.4 supported The driver now supports Impala 1.4. DECIMAL data type supported The driver now supports data of type DECIMAL. Improved reading of BOOLEAN type connection attributes The driver is now able to read connection attributes of type BOOLEAN more efficiently. The following issues were resolved in Cloudera ODBC Driver for Impala COMPUTE STATS queries are treated as ROWCOUNT queries COMPUTE STATS queries are now handled correctly. Driver activity is logged in standard output (stdout) in the Thrift layer Version Driver activity is no longer logged in stdout. The following issues were resolved in Cloudera ODBC Driver for Impala Transaction statements cause errors to occur Version The errors occur because ODBC does not support transaction statements. As a workaround, enable the "Enable Simulated Transactions" driver configuration option (the EnableSimulatedTransactions key). When this option is enabled, the driver will run the query without returning errors about transaction statements. However, the transaction statements will not be executed. The following issues were resolved in Cloudera ODBC Driver for Impala Open session request automatically sets user name and password 10

11 Version ODBC Driver for Impala IBM AIX now supported You can now install and use the driver on computers that run IBM AIX. OpenSSL library statically linked in the Linux and Mac OS X drivers In the Linux and Mac OS X versions of the driver, the OpenSSL library is now statically linked. The following issues were resolved in Cloudera ODBC Driver for Impala Some operation handles are not closed properly Default value for "Rows Fetched Per Block" configuration option is incorrect Version The default value of the "Rows Fetched Per Block" option (the RowsFetchedPerBlock key) is now corrected from to ODBC Driver for Impala Authentication using SSL without user credentials implemented Version You can now configure the driver to authenticate a connection using Secure Sockets Layer (SSL) without requiring a user name and password. ODBC Driver for Impala

12 Documentation improved Version The Cloudera ODBC Driver for Impala Installation and Configuration Guide has been revised and improved. ODBC Driver for Impala Active Directory supported Version The Windows version of the driver now supports Active Directory, enabling you to use Active Directory Kerberos as an authentication method. ODBC Driver for Impala Improved performance for parameterized array insertion The performance of the driver when using parameterized array insertions has been improved. The following issues were resolved in Cloudera ODBC Driver for Impala Self-signed SSL certificates are not validated correctly when the "Allow Common Name Host Name Mismatch" option (the CAIssuedCertNamesMismatch key) is disabled Version ODBC Driver for Impala

13 Authentication using SSL and user credentials implemented You can now configure the driver to authenticate a connection using Secure Sockets Layer (SSL) and a user name and password. Support added for proxied users You can now delegate all operations against Impala to a user that is different than the authenticated user for the connection by using the "Delegation UID" option (the DelegationUID key). Improved logging of queries sent to Thrift when the logging level is LOG_INFO or higher The driver now produces more detailed logs of the queries sent to Thrift when the logging level is set to LOG_INFO, LOG_DEBUG, or LOG_TRACE. The following issues were resolved in Cloudera ODBC Driver for Impala Driver does not correctly block or report runtime errors for queries that take a long time to execute Version ODBC Driver for Impala Support added for using back quotes (`) to specify identifiers when the "Use Native Query" option is disabled Version You can now use back quotes (`) to indicate identifiers in a statement when the "Use Native Query" option (the UseNativeQuery key) is disabled. ODBC Driver for Impala

14 Support added for using double quotation marks (") when specifying identifiers in CREATE/DROP TABLE statements Version You can now use double quotation marks (") to indicate identifiers in CREATE/DROP TABLE statements. Improved handling of schemas The driver is now configured to update the list of schemas before executing catalog functions or if a table cannot be found due to an incorrect schema. ODBC Driver for Impala DSNs can be renamed through the ODBC Data Source Administrator When modifying an existing Data Source Name (DSN) through the ODBC Data Source Administrator, you can now change the Name value. Database configuration option implemented You can now specify the database that the driver connects to by default by using the "Database" configuration option (the Database configuration key). Support added for using the INTEGER data type in CAST scalar functions You can now use the CAST function on data of type INTEGER. The following issues were resolved in Cloudera ODBC Driver for Impala When running a query that contains cross joins nested in other JOIN statements, an error occurs SQL_VARCHAR parameter values that contain single quotation marks (') do not get escaped properly when converted to Impala SQL 14

15 Version ODBC Driver for Impala String Column Length configuration option implemented You can now specify the maximum length of STRING columns by using the "String Column Length" configuration option (the StringColumnLength configuration key). This option is useful for applications that do not accept columns beyond a certain size. For example, Linked Server does not accept SQL_VARCHAR columns greater than 8000 characters. Optimizations for SQLTables implemented The functionalities of SQLTables have been optimized. The following issues were resolved in Cloudera ODBC Driver for Impala The CAST scalar function does not work as expected when the "Use Native Query" option is disabled Version The CAST scalar function now works correctly. SQLGetInfo does not report the correct limits ODBC Driver for Impala Support added for using parameterized INSERT statements when the "Use Native Query" option is disabled You can now use INSERT statements with parameters when the "Use Native Query" option (the UseNativeQuery configuration key) is disabled. 15

16 Version The following issues were resolved in Cloudera ODBC Driver for Impala If SQLCloseCursor is used before the entire result set is retrieved, the driver may stop working or terminate unexpectedly Version Version The following issues were resolved in Cloudera ODBC Driver for Impala Queries that return large result sets return incorrect data instead of expected NULL values Version was the initial release of Cloudera ODBC Driver for Impala. 16

17 Contact Us If you are having difficulties using the driver, our Community Forum 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 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. 17