An asterisk (*) indicates support that was added in a hotfix or software patch subsequent to a release.

Refer to the following resources for additional information:

• Product Compatibility Guide: Provides the latest data source and platform support information. 
• Fixes: Describes the issues resolved since general availability.  

Version 8.0.1

Enhancements

• The driver has been enhanced to support key-pair authentication. When key-pair authentication is enabled (AuthenticationMethod=21), you can authenticate to Snowflake using a pair of private and public keys. To configure the driver to use key-pair authentication, you can use the new Private Key Content (PrivateKeyContent), Private Key File (PrivateKeyFile), and Private Key Passphrase (PrivateKeyPassphrase) connection options.
• The driver has been enhanced to support the authorization code grant, the client credentials grant, and the refresh token grant, in addition to the access token flow. Also, on Windows, the Snowflake Configuration Manager may now be used to obtain access tokens.
• On Windows, the driver now includes the Snowflake Configuration Manager for quick configuration and testing of your driver in a web browser. This tool allows you to:
  • Configure data sources and connection strings
  • Test connectivity for your data sources and connection strings
  • Obtain access tokens for OAuth 2.0 authentication
  • Execute SQL commands for testing purposes
• The driver has been modified to map Snowflake data types for fixed-point numbers to the Numeric data type by default. In addition, the IntegerFieldMapping connection option has been added to the driver. This connection option allows you to specify whether fixed-point numbers are mapped to Numeric or BigInt.
• Debugging symbols have been integrated into the Linux and Windows versions of the product:
  • For UNIX, the driver binaries now include debugging symbols that can be used for diagnosing and debugging issues in the driver.
  • For Windows: The product package now includes .pdb files. These files contain debugging symbols that can be used for diagnosing and debugging issues in the driver.
• The driver is now compiled with an upgraded compiler for Windows platforms. As a result, you must have Microsoft Visual C/C++ runtime version 14.40.33810 or higher on your machine to run the driver.
• The driver now allows you to specify whether the driver fetches metadata for only tables in the database to which you are connected when a database name is not specified in metadata calls. When enabled, this behavior can provide better performance for metadata calls by reducing the number of tables queried. You can use the new Use Session Database For Metadata (UseSessionDatabaseForMetadata) connection option to configure the driver's behavior. Refer to the user's guide for details.
• The driver has been enhanced to support connecting to Snowflake partner applications. You can use the new Partner Application Name (PartnerApplicationName) connection option to specify the name of the partner application to which you want to connect. Refer to Partner Application Name for details.
• The ICU library files that are installed with the Windows version of the product have been upgraded to version 74.1. In addition, the ICU library file names have changed. For the 32-bit driver, the ICU file name has changed from ivicu28.dll to ivicu.dll. For the 64-bit driver, the ICU file name has changed from ddicu28.dll to ddicu.dll.
  This upgrade is available starting in build 08.02.1072 of the ICU library files.
• The ICU library files that are installed with the Linux version of the product have been upgraded to version 74.1. In addition, the ICU library file names have changed. For the 32-bit driver, the ICU file name has changed from libivicu28.so to libivicu.so. For the 64-bit driver, the ICU file name has changed from libddicu28.so to libddicu.so.
  This upgrade is available starting in build 08.02.0965 of the ICU library files.
• The driver has been enhanced to fall back to JSON query format when the arrow format is not properly initialized. The driver uses a high-speed arrow transfer that requires the restricted APIs from java.nio package. When the JVM is not correctly configured for Java SE 16 and higher, an exception is returned when the driver executes a query. To allow you to continue executing queries in this scenario, you can configure the new Arrow Fallback To JSON (ArrowFallbackToJson) option to switch to the JSON query format. Refer to Arrow Fallback To JSON for details.
  Available: Driver version 08.00.0100 (B1193, U0945, J001002)
• The drivers using base version B0649 and later have been enhanced to include timestamp in the internal packet logs by default. If you want to disable the timestamp logging in packet logs, set PacketLoggingOptions=1. The internal packet logging is not enabled by default. To enable it, set EnablePacketLogging=1.
• A Password Encryption Tool, called ddencpwd, is now included with the product package. It encrypts passwords for secure handling in connection strings and odbc.ini files. At connection, the driver decrypts these passwords and passes them to the data source as required. See Password Encryption Tool (UNIX/Linux only) for details.
• The driver is enhanced to support the COPY command for loading and unloading data from local file systems and cloud storage platforms. Refer to Using COPY command for details.

Changed Behavior

• The Authentication Method (Authenticator) option has been updated:
  • The attribute, Authenticator, has changed to AuthenticationMethod. To support existing configurations, the original attribute name will continue to be supported for this release
  • The valid values have changed from enum values to numeric values.
• The names and attributes for the following options have been changed:
  • The Role (Role) option has been renamed Role Name (RoleName).
  • The Token (Token) option has been renamed Access Token (AccessToken).
  • The User (LogonID) option has been renamed User (User).
  To support existing configurations, the original attribute names for these options will continue to be supported for this release.
• The following options are no longer supported:
  • Application Using Threads (ApplicationUsingThreads)
  • Fetch Size (FetchSize)
  • IANAAppCodePage
• The valid values for Client Session Keep Alive (ClientSessionKeepAlive) have changed from boolean to numeric.
• The default value for the SQL Engine Mode (SQLEngineMode) has changed from 0 (Auto) to 1 (Server) on Windows platforms.
• The product package no longer includes the ODBC Cursor library file (odbccurs.so) because it has some known security vulnerabilities that could potentially expose you to security risks.
  Note: The installer program cannot remove the ODBC Cursor library file automatically while installing a new version of the driver. Remove it manually.
• The installer program now requires you to install a JRE that is Java SE 11 or higher before running the installer. In earlier versions, the JRE used by the installer program was included in the product. However, to avoid potential security vulnerabilities, the installer program no longer includes a JRE. Instead, the installer program uses the JRE in your environment to allow for the most secure version of a JRE to be used.
  Notes:
  • This change does not affect the JVM requirements for the driver. For the latest driver requirements, refer to the Product Compatibility Guide.
  • The installer program cannot remove the already installed JRE files from the install directory automatically. Remove them manually.
  • To install the 32-bit drivers on 64-bit Windows platforms and start the SQL engine service, the installer requires the 32-bit version of Java SE 11 or higher installed on your machine and defined on your path.
• The installer program has been updated to no longer install common components for drivers that do not use them. As a result, the installer program no longer installs the following common components for the Snowflake driver:
  • OpenSSL library files, such as ivopenssl30.so, ddopenssl30.so, fips.so, and openssl.cnf.
  • Curl library files, such as libivcurl28.so and libddcurl28.so.
  
  If the files are not used by any other DataDirect driver on your machine, you can safely remove them from existing product directories.

Notes, Known Issues, and Limitations

• The driver does not support specifying values for the same connection option multiple times in a connection string or DSN. If a value is specified using the same attribute multiple times or using both long and short attributes, the connection may fail or the driver may not behave as intended.
• The driver does not support plain text inserts in columns of binary data. Data inserted into columns containing binary data, requires a conversion to hex format.
• The driver does not support scrollable cursor operations on result set data.
• The driver supports Windows 32 and 64-bit, Linux 32 and 64-bit platforms.
• The driver gives a warning message when a SELECT query is run for the first time in a new connection instance, using a console application and OpenJDK 11.
• The OAuth token is valid for 10 minutes, if no connection instance is established or after a connection instance is terminated. A token does not expire in an uninterrupted connection instance.
• For browser-based single sign-on connections, a message appears on the browser "Your identity was confirmed and propagated to Snowflake JDBC driver. You can close this window now and go back where you started from." This is due to the underlying JDBC layer architecture of the driver.
• The active connections viewed on the Snowflake console are termed as JDBC connections. This is due to the underlying JDBC layer architecture of the driver.
• The browser-based SSO authentication does not work in SQL engine server mode when Snowflake server runs as a Windows service.

Version 8.0.0

GA Release Features

• The driver serves as a complete pass-through driver. It leverages the Snowflake SQL engine to execute queries.
• The driver provides enhanced performance over the native ODBC Snowflake driver.
• The driver supports create, read, update, and delete operations.
  
• The driver provides proxy support. Refer toConnection option descriptions for details.