ODBC Driver Connection String Properties

Specifies an alternate security property value to the identity within the current session. This is used to allow the user passing security property to the data source.

Note: You may get unexpected results when multiple requests are made on the same session or when multiple identities access the same session.

Specifies case sensitivity in the request values. Values can be:

Specifies the behavior if commit failed. Possible values are: rollback or bestEffort.

Specifies behavior if commit is interrupted.Possible values are: ignore, log, fail.

Specifies correcting behavior. If enabled, compensation blocks will be run if the transaction rolls back. Possible values: disabled or enabled. Default value is disabled.

Time-out for initial connection, in seconds. Use 0 (zero) for infinite time-out.

Current login user name.

Specifies the maximum text column data size.

Specifies the data source that is used for all connections.

Specifies an identification string that defines a realm of administrative autonomy, authority, or control.

The ODBC driver absolute path name.

ODBC DSN name.

Valid values are true and false. The default value is false.

Results are processed and returned immediately (instead of a round trip) when a query is submitted, potentially improving performance of low latency queries.

Values are true or false. Default value is True.

If true, the server will constantly send data, filling the network buffer.Useful for larger result sets.

Specifies cluster reconnection behavior.

If True, the client will connect to the TDV server using the ODBC driver SSL port.

Maximum number of rows to fetch for a batch based on batch size, in bytes. Setting fetchBytes to a very large number can cause an Out Of Memory error in the server. The value set for fetchBytes affects the memory used on the client and the TDV server, so the value should be set based on the heap size configured. The default value is used if this property is set to zero.

Maximum number of rows to fetch for a batch. The default value is used if this property is set to zero.

TDV Server host name.

Ignore trailing spaces at the end of values. Values can be:

Value that defines the user’s language and country. Refer to the section TDV Supported Encoding Standards for a list of supported encoding standards by TDV.

Blocks return of result-set metadata during query execution.

Controls the behavior of OUT parameters for stored procedures:

Specifies the password for the user name that you specify in the Username property. These values are used for your data source connection.

Maximum time to wait before sending a ping request while waiting for a result from TDV, in seconds.

The length of time the JDBC or ODBC client waits before closing a connection to the TDV server, after a ping to the TDV server has failed.

The value of this parameter should be greater than or equal to the "PingInterval" parameter. If a ping sent to the TDV server fails, the ODBC or JDBC client continues to send pings to TDV to check status. If these client pings continue to fail after the TimeoutWindow has expired, the ODBC or JDBC client closes the connection to the TDV server and sends a message. While the TimeoutWindow has not expired, the ODBC or JDBC client connection stays open and continues to send pings to the TDV server waiting for a response. The default for this property is 0, which means the setting is not being used.

TDV Server listening port.

Time-out for query commands and other requests

Session inactivity timeout, in seconds. Set to zero for infinite timeout.

Maximum log file size to saving to next log file, in M bytes.

Valid on Windows platform only, not useful on UNIX platforms.

Kerberos SPN value, only useful if the SSO value equals Kerberos.

Valid on Windows platform only, not useful on UNIX platforms. Single-sign-on type: ""/(Disabled), Kerberos or NTLM.

The default value is "", which forces the ODBC client application to provide user and password information to connect.

The subject (CN) of the Windows private certificate. You can locate this using this procedure:

1. Run the certmgr.msc program to open the Windows Certificate Manager.

2. Under Personal/Certificates, double-click the private certificate to open the Certificate dialog.

3. Click the Details tab, then select the Subject field.

Enter the Subject CN value in the sslKeyID field. This is the only parameter you need to specify for Windows.

The absolute path of a PEM file that contains the public key certificate for an SSL connection. (Optional)

The absolute path of a PEM file that contains private key certificate for an SSL connection. This private key should match public key in SSL Key Cert. (Optional)

The PEM file that contains the trusted CA certificates in PEM format. (Optional)

The properties sslCACert and sslCAPath should not be used on windows. This is because Windows has its own Trust Store in the operating system. Customers are advised to add non-standard CA certificates(example self-signed certificate(s)) in Windows TrustStore.

The absolute path of the directory that contains the trusted CA files in PEM format. On the Linux platform, the default value is “/etc/ssl/certs”. The CA PEM file name in the CA path directory must equal the hash value for the CA PEM file name. (Optional)

Note that on the Windows platform, the ODBC driver loads all CA certificates from the system Truststore, so this parameter is not used.

Values are true or false. Default value is false.

If true, the server will detect for duplicate CHAR/VARCHAR columns in subsequent rows, and will not re-transmit the data across the wire.

This would potentially lead to data savings across the wire.

Determines whether decimal result values are to be returned with trailing zeros removed.

Absolute path to the trace file.

Absolute directory to save trace file, the trace file name is "CsOdbcDebug_"+<DSN Name>+".log". the default folder is C:\ or $COMPOSITE_HOME

Valid values are off, fatal, error (this is the default), debug, warn, info, debug2, and all.

The valid values for client-side log settings are off, fatal, error (default), warn, info, debug, all, debug2, stdout.

On UNIX-based platforms, the log file CsOdbcDebug.log is created in the directory specified by the environment variable COMPOSITE_HOME.

Valid values are silent, warn, or fail. The default value is fail.

When set to silent, unsupported methods do nothing and return. When set to warn, the JDBC driver logs a warning message in the log file, Otherwise, the JDBC driver returns a SQL_ERROR when it encounters unsupported methods.

Authentication values that can be packaged for delivery.

Specifies the user name for connections to the data source.

When true, the TDV client initiates handshake validation, validating the TDV certificate and using it for password encryption. If validation fails, no connection is established.

When false (default), no certificate validation is performed prior to the establishment of a connection.

The TDV Server certificate is loaded from the Truststore File Location set in the Studio Configuration panel. The Keystore Key Alias is used when it is configured for use. For more information, refer to “TDV Configuration Parameters” in the TDV Administration Guide.

The TDV ODBC driver uses the system certification store to validate the certificate. The TDV Server certificate must be added to this client trust store or validation fails.

When true, the ODBC driver compares the value of host in the connection string with the subject CN (common name) value in the certificate received from the targeted TDV Server.

If the host name validation fails, the connection is not established. When false (default), the host name validation is not performed.

Indicates whether the authentication type is BASIC (using the user name/password) or OAUTH2 authentication (using access tokens). Choose OAuth2 if you will be using the authorization tokens.

The authorization tokens used for OAuth2 authentication. The tokens are represented in a specific format -

<header>.<payload>.<signature>.

Each of the parts of the token is in a JSON format.

The access token is used in place of id/password credentials, with a limited lifetime & privileges.

The type of the Access Token. JWT (JSON Web Token) is the default supported format. JWT token is a self-contained JSON form and ideal for federation.

Property Type: Boolean

Default Value: false

When set to true, the driver enables TCP-KeepAlive for the connection.