Connection String Parameters - ODBC Driver for Snowflake

Authentication

Specifies the authentication type to use when connecting to Snowflake.

ClientId

Specifies the client ID. Applies when the Authentication parameter is set to OAuth 2.0. For information on how to obtain a client ID, see Obtaining Credentials for OAuth 2.0 Authentication.

ClientSecret

Specifies the client secret. Applies when the Authentication parameter is set to OAuth 2.0. For information on how to obtain a client secret, see Obtaining Credentials for OAuth 2.0 Authentication.

Database

Specifies the database to connect to.

Domain

Specifies the URL of your Snowflake account.

Passphrase

Specifies the passphrase for the encrypted private key. Applies when the Authentication parameter is set to Key-pair and the private key is encrypted. For information on how to obtain a passphrase, see Obtaining Credentials for Key Pair Authentication.

Password

Specifies your Snowflake password. Applies when the Authentication parameter is set to Basic.

PrivateKey

Specifies the path to the private key file. Applies when the Authentication parameter is set to Key-pair. For information on how to obtain a private key, see Obtaining Credentials for Key Pair Authentication.

RefreshToken

Specifies the refresh token. Applies when the Authentication parameter is set to OAuth 2.0. For information on how to obtain a refresh token, see Obtaining Credentials for OAuth 2.0 Authentication.

Role

Indicates the role you are using to connect to the system.

Schema

Changes the current session schema to the specified schema.

User ID

Specifies your Snowflake username. Applies when the Authentication parameter is set to Basic or Key-pair.

Warehouse

Indicates the warehouse you are going to work with.

Proxy Settings

Proxy Server

Specifies the proxy hostname or IP address.

Proxy User ID

Specifies the proxy server account ID.

Proxy Password

Specifies the proxy password.

Proxy Port

Specifies the port number used to connect to a proxy server.

Advanced Settings

Allow NULL strings

Enables compatibility with 3rd-party tools that pass NULL to metadata retrieval parameters that, according to MSDN, cannot accept a null value (the driver would otherwise return an error).

Empty strings as NULL

Connection Timeout

Specifies the time (in seconds) to wait for a connection to open before terminating an attempt. The default value is 60.

ODBC Behavior

Sets the behavior corresponding to the ODBC specification version that a third-party tool expects. The behavior of ODBC driver can be changed by setting a value for the SQL_ATTR_ODBC_VERSION attribute by calling the SQLSetEnvAttr function. But some third-party tools expect the driver to exhibit ODBC 2.x behavior, but forget to call SQLSetEnvAttr with the specified version or pass an incorrect value there. In this case, the required behavior can be explicitly specified in the Connection String by setting the ODBC Behavior parameter. The possible values are:

• Default - default ODBC behavior determined by a third-party tool.
• Ver 2.x - ODBC 2.x behavior is explicitly set.
• Ver 3.x - ODBC 3.x behavior is explicitly set.

RegionalNumberSettings

Enables the use of local regional settings when converting numbers to strings.

RegionalDateTimeSettings

Enables the use of local regional settings when converting dates and times to strings.

ReturnForeignKeys

Specifies whether the driver must return foreign keys. Retrieving metadata about foreign key constraints is a time-consuming operation; many third-party tools request foreign key metadata even whey they do not actually need this information. Note that enabling the option may degrade performance of data access operations. The default value is False.

String Types

Sets the string value types returned by the driver as Default, Ansi or Unicode.

• Default - the driver defines the string types.
• Ansi - all string types will be returned as SQL_CHAR, SQL_VARCHAR and SQL_LONGVARCHAR.
• Unicode - all string types will be returned as SQL_WCHAR, SQL_WVARCHAR and SQL_WLONGVARCHAR.

The parameter value should be changed if any third-party tool supports only Ansi string types or Unicode ones.

QueryTimeout

Specifies the time to wait for a query execution result before terminating and generating an error.

UTC Dates

Specifies whether all the datetime values retrieved from the data source are returned as UTC values or converted to local time and whether the date values specified on the application side (e.g., in SQL statements) are considered UTC or local. The default value is false.