Documentation Home

3.5.3 配置属性

配置属性定义 Connector/J 将如何连接到 MySQL 服务器。除非另有说明,否则可以为DataSource对象或 Connection对象设置属性。

可以通过以下方式之一设置配置属性:

  • 使用set*()MySQL 实现上的方法java.sql.DataSource (这是使用 的实现时的首选方法 java.sql.DataSource):

    • com.mysql.cj.jdbc.MysqlDataSource

    • com.mysql.cj.jdbc.MysqlConnectionPoolDataSource

  • java.util.Properties作为传递给 DriverManager.getConnection()或 的实例中的键值对 Driver.connect()

  • 作为给定的 URL 中的 JDBC URL 参数 java.sql.DriverManager.getConnection()java.sql.Driver.connect()或该 javax.sql.DataSource setURL()方法的 MySQL 实现。如果您在 URL 中指定配置属性而没有为其提供值,则不会设置任何内容;例如, useServerPrepStmts单独添加到 URL 不会使 Connector/J 使用服务器端准备语句;你需要添加useServerPrepStmts=true.

    笔记

    如果用于配置 JDBC URL 的机制是基于 XML 的,请使用 XML 字符文字 &来分隔配置参数,因为 & 符号是 XML 的保留字符。

这些属性在下表中按类别列出,然后在后面的小节中列出。单击表中的属性名称可在小节中查看其完整描述。

表 3.4 身份验证属性

姓名 默认值 自版本
user - 所有版本
password - 所有版本
password1 - 8.0.28
password2 - 8.0.28
password3 - 8.0.28
authenticationPlugins - 5.1.19
disabledAuthenticationPlugins - 5.1.19
ociConfigFile - 8.0.27
authenticationFidoCallbackHandler - 8.0.29
defaultAuthenticationPlugin mysql_native_password 5.1.19
ldapServerHostname - 8.0.23

表 3.5 连接属性

姓名 默认值 自版本
connectionAttributes - 5.1.25
connectionLifecycleInterceptors - 5.1.4
useConfigs - 3.1.5
clientInfoProvider com.mysql.cj.jdbc.CommentClientInfoProvider 5.1.0
createDatabaseIfNotExist 错误的 3.1.9
databaseTerm 目录 8.0.17
detectCustomCollations 错误的 5.1.29
disconnectOnExpiredPasswords 真的 5.1.23
interactiveClient 错误的 3.1.0
passwordCharacterEncoding - 5.1.7
propertiesTransform - 3.1.4
rollbackOnPooledClose 真的 3.0.15
useAffectedRows 错误的 5.1.7

表 3.6 会话属性

姓名 默认值 自版本
sessionVariables - 3.1.8
characterEncoding - 1.1克
characterSetResults - 3.0.13
connectionCollation - 3.0.13
customCharsetMapping - 8.0.26
trackSessionState 错误的 8.0.26

表 3.7 网络属性

姓名 默认值 自版本
socksProxyHost - 5.1.34
socksProxyPort 1080 5.1.34
socketFactory com.mysql.cj.protocol.StandardSocketFactory 3.0.3
connectTimeout 0 3.0.1
socketTimeout 0 3.0.1
dnsSrv 错误的 8.0.19
localSocketAddress - 5.0.5
maxAllowedPacket 65535 5.1.8
socksProxyRemoteDns 错误的 8.0.29
tcpKeepAlive 真的 5.0.7
tcpNoDelay 真的 5.0.7
tcpRcvBuf 0 5.0.7
tcpSndBuf 0 5.0.7
tcpTrafficClass 0 5.0.7
useCompression 错误的 3.0.17
useUnbufferedInput 真的 3.0.11


表 3.9 语句属性

姓名 默认值 自版本
cacheDefaultTimeZone 真的 8.0.20
continueBatchOnError 真的 3.0.3
dontTrackOpenResources 错误的 3.1.7
queryInterceptors - 8.0.7
queryTimeoutKillsConnection 错误的 5.1.9

表 3.10 准备好的语句属性


表 3.11 结果集属性


表 3.12 元数据属性

姓名 默认值 自版本
getProceduresReturnsFunctions 真的 5.1.26
noAccessToProcedureBodies 错误的 5.0.3
nullDatabaseMeansCurrent 错误的 3.1.8
useHostsInPrivileges 真的 3.0.2
useInformationSchema 错误的 5.0.0

表 3.13 BLOB/CLOB 处理属性

姓名 默认值 自版本
autoDeserialize 错误的 3.1.5
blobSendChunkSize 1048576 3.1.9
blobsAreStrings 错误的 5.0.8
clobCharacterEncoding - 5.0.0
emulateLocators 错误的 3.1.0
functionsNeverReturnBlobs 错误的 5.0.8
locatorFetchBufferSize 1048576 3.2.1

表 3.14 日期时间类型处理属性

姓名 默认值 自版本
connectionTimeZone - 3.0.2
forceConnectionTimeZoneToSession 错误的 8.0.23
noDatetimeStringSync 错误的 3.1.7
preserveInstants 真的 8.0.23
sendFractionalSeconds 真的 5.1.37
sendFractionalSecondsForTime 真的 8.0.23
treatUtilDateAsTimestamp 真的 5.0.5
yearIsDateType 真的 3.1.9
zeroDateTimeBehavior 例外 3.1.4


表 3.16 性能扩展属性

姓名 默认值 自版本
callableStmtCacheSize 100 3.1.2
metadataCacheSize 50 3.1.1
useLocalSessionState 错误的 3.1.7
useLocalTransactionState 错误的 5.1.7
prepStmtCacheSize 25 3.0.10
prepStmtCacheSqlLimit 256 3.0.10
queryInfoCacheFactory com.mysql.cj.PerConnectionLRUFactory 5.1.1
serverConfigCacheFactory com.mysql.cj.util.PerVmServerConfigCacheFactory 5.1.1
alwaysSendSetIsolation 真的 3.1.7
maintainTimeStats 真的 3.1.9
useCursorFetch 错误的 5.0.0
cacheCallableStmts 错误的 3.1.2
cachePrepStmts 错误的 3.0.10
cacheResultSetMetadata 错误的 3.1.1
cacheServerConfiguration 错误的 3.1.5
defaultFetchSize 0 3.1.9
dontCheckOnDuplicateKeyUpdateInSQL 错误的 5.1.32
elideSetAutoCommits 错误的 3.1.3
enableEscapeProcessing 真的 6.0.1
enableQueryTimeouts 真的 5.0.6
largeRowSizeThreshold 2048 5.1.1
readOnlyPropagatesToServer 真的 5.1.35
rewriteBatchedStatements 错误的 3.1.13
useReadAheadInput 真的 3.1.5

表 3.17 调试/分析属性

姓名 默认值 自版本
logger com.mysql.cj.log.StandardLogger 3.1.1
profilerEventHandler com.mysql.cj.log.LoggingProfilerEventHandler 5.1.6
useNanosForElapsedTime 错误的 5.0.7
maxQuerySizeToLog 2048 3.1.3
maxByteArrayAsHex 1024 8.0.31
profileSQL 错误的 3.1.0
logSlowQueries 错误的 3.1.2
slowQueryThresholdMillis 2000 3.1.2
slowQueryThresholdNanos 0 5.0.7
autoSlowLog 真的 5.1.4
explainSlowQueries 错误的 3.1.2
gatherPerfMetrics 错误的 3.1.2
reportMetricsIntervalMillis 30000 3.1.2
logXaCommands 错误的 5.0.5
traceProtocol 错误的 3.1.2
enablePacketDebug 错误的 3.1.3
packetDebugBufferSize 20 3.1.3
useUsageAdvisor 错误的 3.1.1
resultSetSizeThreshold 100 5.0.5
autoGenerateTestcaseScript 错误的 3.1.9

表 3.18 异常/警告属性


表 3.19 用于与其他产品集成的 Tunes 属性

姓名 默认值 自版本
overrideSupportsIntegrityEnhancementFacility 错误的 3.1.12
ultraDevHack 错误的 2.0.3

表 3.20 JDBC 合规性属性

姓名 默认值 自版本
useColumnNamesInFindColumn 错误的 5.1.7
pedantic 错误的 3.0.0
useOldAliasMetadataBehavior 错误的 5.0.4