skip to main content
Connection property descriptions
  

Try DataDirect Drivers Now

Connection property descriptions

You can use connection properties to customize the driver for your environment. This section lists the connection properties supported by the driver and describes each property. You can use these 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). Connection property names are case-insensitive. For example, Password is the same as password.
Note: In a JDBC DataSource, string values must be enclosed in double quotation marks, for example, setUser("User123").
Note: The data type listed for each connection property is the Java data type used for the property value in a JDBC data source.
The following table provides a summary of the connection properties supported by the driver, their corresponding data source methods, and their default values.
Table 18. Connection properties
Property
Data source method
Default
setAccountingInfo
Empty string
setAEKeyCacheTTL
7200
setAEKeystoreClientSecret
None
setAEKeystoreLocation
None
setAEKeystorePrincipalId
None
setAEKeystoreSecret
Empty string
setAlternateServers
None
setAlwaysReportTriggerResults
false
setApplicationIntent
ReadWrite
setApplicationName
Empty string
setAuthenticationMethod
auto
setBulkLoadBatchSize
1000 (rows)
setBulkLoadOptions
2
setCatalogOptions
0
setClientHostName
Empty string
setClientUser
Empty string
setColumnEncryption
Disabled
setCodePageOverride
None
setConnectionRetryCount
5
setConnectionRetryDelay
1 (second)
setConvertNull
1 (data type check is performed if column value is null)
setCryptoProtocolVersion
None
setDatabaseName
None
setDateTimeInputParameterType
auto
setDateTimeOutputParameterType
auto
setDescribeInputParameters
noDescribe
setDescribeOutputParameters
noDescribe
setDomain
None
setEnableBulkLoad
false
setEnableCancelTimeout
false
setEncryptionMethod
noEncryption
setFailoverGranularity
nonAtomic
setFailoverMode
connect
setFailoverPreconnect
false
setFetchTSWTZAsTimestamp
false
setFetchTWFSasTime
false
setGSSCredential
Null
setHostNameInCertificate
Empty string
setImportStatementPool
Empty string
setInitializationString
None
setInsensitiveResultSetBufferSize
2048 (KB)
setJavaDoubleToString
false
setJDBCBehavior
1
setLoadBalancing
false
setLoginConfigName
JDBC_DRIVER_01
setLoginTimeout
0 (no timeout)
setLongDataCacheSize
2048 (KB)
setMaxPooledStatements
0 (driver’s internal prepared statement pooling is not enabled)
setMultiSubnetFailover
false
setNetAddress
000000000000
setPackeSize
-1 (maximum packet size accepted by the database server)
setPassword
None
setPortNumber
1433
setProgramID
Empty string
setQueryTimeout
0 (query does not time out)
setRegisterStatementPoolMonitorMBean
false
setResultSetMetaDataOptions
0 (no additional processing to determine the correct table name for each column in the result set)
setSelectMethod
direct
setServerName
None
setServicePrincipalName
Driver builds value based on environment
setSnapshotSerializable
false
setSpyAttributes
None
setStringInputParameter
nvarchar
setStringOutputParameter
nvarchar
setSuppressConnectionWarnings
false
setTransactionMode
implicit
setTruncateFractionalSeconds
true
setTrustStore
None
setTrustStorePassword
None
setUser
None
setUseServerSideUpdatableCursors
false
setValidateServerCertificate
true
setXATransactionGroup
None
setXMLDescribeType
None
* AccountingInfo
* AEKeyCacheTTL
* AEKeystoreClientSecret
* AEKeystoreLocation
* AEKeystorePrincipalId
* AEKeystoreSecret
* AlternateServers
* AlwaysReportTriggerResults
* ApplicationIntent
* ApplicationName
* AuthenticationMethod
* BulkLoadBatchSize
* BulkLoadOptions
* CatalogOptions
* ClientHostName
* ClientUser
* CodePageOverride
* ColumnEncryption
* ConnectionRetryCount
* ConnectionRetryDelay
* ConvertNull
* CryptoProtocolVersion
* DatabaseName
* DateTimeInputParameterType
* DateTimeOutputParameterType
* DescribeInputParameters
* DescribeOutputParameters
* Domain
* EnableBulkLoad
* EnableCancelTimeout
* EncryptionMethod
* FailoverGranularity
* FailoverMode
* FailoverPreconnect
* FetchTSWTZAsTimestamp
* FetchTWFSasTime
* GSSCredential
* HostNameInCertificate
* ImportStatementPool
* InitializationString
* InsensitiveResultSetBufferSize
* JavaDoubleToString
* JDBCBehavior
* LoadBalancing
* LoginConfigName
* LoginTimeout
* LongDataCacheSize
* MaxPooledStatements
* MultiSubnetFailover
* NetAddress
* PacketSize
* Password
* PortNumber
* ProgramID
* QueryTimeout
* RegisterStatementPoolMonitorMBean
* ResultSetMetaDataOptions
* SelectMethod
* ServerName
* ServicePrincipalName
* SnapshotSerializable
* SpyAttributes
* StringInputParameterType
* StringOutputParameterType
* SuppressConnectionWarnings
* TransactionMode
* TruncateFractionalSeconds
* TrustStore
* TrustStorePassword
* User
* UseServerSideUpdatableCursors
* ValidateServerCertificate
* XATransactionGroup
* XMLDescribeType