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 19. Oracle Driver Properties
Property
Data source method
Default
setAccountingInfo
Empty string
setAction
Empty string
setAlternateServers
None
setApplicationName
Empty string
setAuthenticationMethod
auto
setBatchMechanism
None
setBulkLoadBatchSize
1000 (rows)
setBulkLoadOptions
0 (the bulk load operation continues even if a value that can cause an index to be invalidated is loaded)
setCatalogOptions
2 (result sets contain synonyms)
setClientHostName
Empty string
setClientID
Empty string
setClientUser
Empty string
setCodePageOverride
None
setCommitBehavior
serverDefault
setConnectionRetryCount
5
setConnectionRetryDelay
1 (second)
setConvertNull
1 (data type check is performed if column value is null)
setCryptoProtocolVersion
None
setDatabase
None
setDatabaseName
None
setDataIntegrityLevel
accepted
setDataIntegrityTypes
List of all possible values
setEditionName
None
setEnableBulkLoad
false
setEnableCancelTimeout
false
setEnableServerResultCache
false
setEncryptionLevel
accepted
setEncryptionMethod
noEncryption
setEncryptionTypes
List of all possible values
setFailoverGranularity
nonAtomic
setFailoverMode
connect
setFailoverPreconnect
false
setFetchTSWTZasTimestamp
false
setGSSCredential
Null
setHostNameInCertificate
Empty string
setImportStatementPool
Empty string
setInitialColumnBufferSize
-1 (automatically determined based on the width of the column being bound)
setInitializationString
None
setInsensitiveResultSetBufferSize
2048 (KB of memory)
setJavaDoubleToString
false
setJDBCBehavior
1
setKeyPassword
None
setKeyStore
None
setKeyStorePassword
None
setLDAPDistinguishedName
None
setLoadBalancing
false
setLoadLibraryPath
None
setLOBPrefetchSize
4000
setLoginTimeout
0 (no timeout)
setMaxPooledStatements
0 (driver’s internal prepared statement pooling is not enabled)
setMaxStatements
0 (driver’s internal prepared statement pooling is not enabled)
setModule
Empty string
setNewPassword
None
setPassword
None
setPortNumber
1521
setProgramID
Empty string
setQueryTimeout
0 (query does not time out)
setRandomGenerator
secureRandom
setRegisterStatementPoolMonitorMBean
false
setReportRecycleBin
true
setResultSetMetaDataOptions
0 (no additional processing to determine the correct table name for each column in the result set)
setSDUSize
16384
setSecureRandomAlgorithm
None
setSendFloatParametersAsString
false
setServerName
None
setServerType
None
setServiceName
None
SID
setSID
None
setSpyAttributes
None
setStringParamsMustMatchCharColumns
true
setSupportBinaryXML
false
setSupportLinks
false
setSysLoginRole
Empty string
setTNSNamesFile
None
setTNSServerName
None
setTrustStore
None
setTrustStorePassword
None
setUser
None
setValidateServerCertificate
true
* AccountingInfo
* Action
* AlternateServers
* ApplicationName
* AuthenticationMethod
* BatchMechanism
* BulkLoadBatchSize
* BulkLoadOptions
* CatalogOptions
* ClientHostName
* ClientID
* ClientUser
* CodePageOverride
* CommitBehavior
* ConnectionRetryCount
* ConnectionRetryDelay
* ConvertNull
* CryptoProtocolVersion
* Database
* DatabaseName
* DataIntegrityLevel
* DataIntegrityTypes
* EditionName
* EnableBulkLoad
* EnableCancelTimeout
* EnableServerResultCache
* EncryptionLevel
* EncryptionMethod
* EncryptionTypes
* FailoverGranularity
* FailoverMode
* FailoverPreconnect
* FetchTSWTZasTimestamp
* GSSCredential
* HostNameInCertificate
* ImportStatementPool
* InitialColumnBufferSize
* InitializationString
* InsensitiveResultSetBufferSize
* JavaDoubleToString
* JDBCBehavior
* KeyPassword
* KeyStore
* KeyStorePassword
* LDAPDistinguishedName
* LoadBalancing
* LoadLibraryPath
* LOBPrefetchSize
* LoginTimeout
* MaxPooledStatements
* MaxStatements
* Module
* NewPassword
* Password
* PortNumber
* ProgramID
* QueryTimeout
* RandomGenerator
* RegisterStatementPoolMonitorMBean
* ReportRecycleBin
* ResultSetMetaDataOptions
* SDUSize
* SecureRandomAlgorithm
* SendFloatParametersAsString
* ServerName
* ServerType
* ServiceName
* SID
* SpyAttributes
* StringParamsMustMatchCharColumns
* SupportBinaryXML
* SupportLinks
* SysLoginRole
* TNSNamesFile
* TNSServerName
* TrustStore
* TrustStorePassword
* User
* ValidateServerCertificate