You can use connection properties to customize the driver for your environment. This section organizes connection properties according to functionality. You can use connection properties with either the JDBC DriverManager or a JDBC data source. For a DriverManager connection, a property is expressed as a key value pair and takes the form property=value. For a data source connection, a property is expressed as a JDBC method and takes the form setproperty(value).

Note: Connection property names are case-insensitive. For example, Password is the same as password.
Note: In a JDBC data source, string values must be enclosed in double quotation marks, for example, setUser("abc@defcorp.com").

The following tables describe the connection properties by functionality.

Bearer token authentication properties

The following table summarizes properties used for Bearer token authentication.

Property Data Source Method Default
AuthenticationMethod getAuthenticationMethod()

setAuthenticationMethod(String)

 BearerToken
ServerName getServerName()

setServerName(String)

 No default value
SecurityToken getSecurityToken()

setSecurityToken(String)

 No default value

Basic authentication properties

The following table summarizes properties used for Basic authentication.

Property Data Source Method Default
AuthenticationMethod getAuthenticationMethod()

setAuthenticationMethod(String)

 BearerToken
Password getPassword()

setPassword(String)

 No default value
ServerName getServerName()

setServerName(String)

 No default value
User getUser()

setUser(String)

 No default value

OAuth 2.0 properties

The following table summarizes properties used for OAuth 2.0 authentication. The OAuth 2.0 properties you must specify depend on the grant type used in your environment. If you are unsure of the grant type or its requirements, contact your system administrator. For details, see OAuth 2.0 authentication.

Property Data Source Method Default
AccessToken getAccessToken()

setAccessToken(String)

 No default value
AuthenticationMethod getAuthenticationMethod()

setAuthenticationMethod(String)

 BearerToken
AuthURI getAuthUri()

setAuthUri(String)

 No default value
ClientID getClientId()

setClientId(String)

 No default value
ClientSecret getClientSecret()

setClientSecret(String)

 No default value
RedirectURI getRedirUri()

setRedirUri(String)

 No default value
Scope getScope()

setScope(String)

 No default value
ServerName getServerName()

setServerName(String)

 No default value
TokenURI getTokenUri()

setTokenUri(String)

 No default value

Proxy server properties

The following table summarizes proxy server connection properties.

Property Data Source Method Default
ProxyHost getProxyHost()

setProxyHost(String)

 No default value
ProxyPassword getProxyPassword()

setProxyPassword(String)

 No default value
ProxyPort getProxyPort()

setProxyPort(Integer)

 0
ProxyUser getProxyUser()

setProxyUser(String)

 No default value

Timeout properties

The following table summarizes timeout connection properties.

Property Data Source Method Default
WSRetryCount getWsRetryCount()

setWsRetryCount(Integer)

 5
WSTimeout getWsTimeout()

setWsTimeout(Integer)

 120 (seconds)

Additional properties

The following table summarizes additional connection properties.

Property Data Source Method Default
DebugRecord getDebugRecord()

setDebugRecord(String)

 0 (Disabled)
DefaultQueryOptions getDefaultQueryOptions()

setDefaultQueryOptions(String)

 No default value
FetchSize getFetchSize()

setFetchSize(Integer)

 100 (rows)
LogConfigFile getLogConfigFile()

setLogConfigFile(String)

 ddlogging.properties
SpyAttributes getSpyAttributes()

setSpyAttributes(String)

 No default value
StmtCallLimit getStmtCallLimit()

setStmtCallLimit(Integer)

 2000
StmtCallLimitBehavior getStmtCallLimitBehavior()

setStmtCallLimitBehavior(String)

 ErrorAlways