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 [13858] Support added for Kerberos delegation You now have the option for the driver to forward the user credentials to the server when using Kerberos authentication. Support for Windows Trust Store You now have the option to use the CA certificates in the Windows Trust Store for server verification when using SSL. [13800] Auto Reconnect You can configure the driver to automatically attempt reconnection to the Impala server if communications are lost. [13996] Support for query, login, and connection timeout The driver now supports the following ODBC API calls: SQL_ATTR_CONNECTION_TIMEOUT SQL_ATTR_LOGIN_TIMEOUT SQL_ATTR_QUERY_TIMEOUT [14244] Optimization of metadata retrieval The following issues were resolved in Cloudera ODBC Driver for Impala If a user attempted to connect without proper permissions to access the schema set in the connection string, the driver would fail to connect. The driver will now display a warning under these circumstances, and use the default schema. 1

2 [13523] Specifying an alias for a column name in the SELECT list when SELECT DISTINCT is present and using that column name in the ORDER BY clause causes a system message to be displayed. [13656] Driver returning incorrect order for character data types in the SQLGetTypeInfo result set under some circumstances. Version History Version The following are highlights of the new features and functionalities that have been added to Cloudera ODBC Driver for Impala Support added for SQL_TSI_FRAC_SECOND precision The driver now supports queries that use the TIMESTAMPDIFF and TIMESTAMPADD scalar functions with the SQL_TSI_FRAC_SECOND precision. [13780] Support added for TLS versions up to 1.2 The driver can now connect to the database using TLS 1.2 or earlier. For detailed information about configuring TLS/SSL settings, see the Cloudera ODBC Driver for Impala Installation and Configuration Guide. The following issues were resolved in Cloudera ODBC Driver for Impala Driver returns non-selected columns specified in the ORDER BY clause Syntax error when using parameters in case expressions, specifically in the ELSE and THEN clauses 2

3 Using alias for a column name in SELECT DISTINCT List does not resolve properly for the ORDER BY clause [13794] When translating a CAST statement, the query translator removes the length from CHAR and VARCHAR data [13655] If a statement contains a CASE expression that uses THEN or ELSE as well as a parameter, and the statement also contains a GROUP BY clause that uses the same column as the CASE expression, then the driver returns a syntax error Version The following are highlights of the new features and functionalities that have been added to Cloudera ODBC Driver for Impala Support added for EXISTS syntax The driver now supports queries that use the EXISTS syntax. [12888] Additional SQLColumn optimization The driver now optimizes catalog functions that include schema restrictions. The following issues were resolved in Cloudera ODBC Driver for Impala [13202] Query fails if the column name contains a char from the Latin-1 Supplement char set [13205] Warning dialog when non-admin user clicks OK on the DSN dialog should be suppressed Driver reports statement length limit as 16K 3

4 Version The following are highlights of the new features and functionalities that have been added to Cloudera ODBC Driver for Impala Support added for Red Hat Enterprise Linux (RHEL) 7 and CentOS 7 You can now install and run the Linux version of the driver on machines that run RHEL 7 or CentOS 7. Improved implementation of SQLCancel The driver now implements industry-standard behavior for when SQLCancel is called while query results are being fetched. Optimized metadata retrieval The driver now retrieves schemas and table names using the SHOW TABLES query instead of the GetTables Thrift API call. The following issues were resolved in Cloudera ODBC Driver for Impala The Use Only SSPI configuration option (the UseOnlySSPI property) does not work correctly [12888] Driver does not push down restrictions for catalog functions (SQLTables and SQLColumns), in some cases causing a large number of GET_TABLES requests to occur When connecting to Impala 1.1 and executing a query that contains a NULL literal in the SELECT list, the driver terminates unexpectedly Version The following are highlights of the new features and functionalities that have been added to Cloudera ODBC Driver for Impala [12116] Advanced Kerberos authentication mechanism implemented 4

5 The driver now supports Advanced Kerberos authentication, which allows concurrent connections within the same process to use different Kerberos user principals. For information about how to use this authentication mechanism, see the Cloudera ODBC Driver for Impala Installation and Configuration Guide. Updated handling of result set metadata The driver now reports result set columns as being updatable, improving compatibility with the DotNet Odbc library and OdbcDataAdapter. Support added for returning table and column remarks through catalog functions Version The driver is now able to return remarks from tables and columns through catalog functions. Note: Currently, due to a known issue in Impala, table remarks are returned as empty strings. When the GetTables Thrift client API is called, Impala returns empty strings for table remarks even if the table contains remarks. ODBC Driver for Impala Automatically configure driver manager settings On non-windows platforms, the DriverManagerEncoding and ODBCInst settings are now configured automatically based on the driver manager (iodbc or unixodbc) that is used. Updated driver logging options Version You can now specify the maximum size of each log file by using the "Max File Size" option (the LogFileSize key), and specify the maximum number of log files to keep by using the "Max Number Files" option (the LogFileCount key). Also, in the Logging Options dialog box for the Windows driver, you now have the option of browsing for the folder where you want to save log files instead of typing the path. ODBC Driver for Impala Nested data types (ARRAY, MAP, and STRUCT) now supported 5

6 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 Driver does not report empty schemas in catalog function calls Version ODBC Driver for Impala 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. 6

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

8 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)" (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) 8

9 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 "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 9

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

11 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. Driver returns unintuitive error message when connected to the wrong Thrift service 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. 11

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