6.3 Configuration Properties — MySQL Connectors 1.0

6.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() или реализациям MySQL для метода javax.sql.DataSource setURL(). Если вы указываете свойство конфигурации в URL без значения, оно не будет установлено; например, добавление useServerPrepStmts в URL не заставит Connector/J использовать предзаготовленные запросы на стороне сервера; вам нужно добавить useServerPrepStmts=true.

Примечание

Если механизм конфигурации URL JDBC основан на XML, используйте XML-литерал символа & для разделения параметров конфигурации, так как амперсанд является зарезервированным символом для XML.

Свойства перечислены по категориям в следующих таблицах, а затем в последующих подразделах. Щёлкните имя свойства в таблицах, чтобы увидеть его полное описание в подраздёлах.

Таблица 6.1 Свойства аутентификации

Таблица 6.1 Свойства аутентификации
Имя	Значение по умолчанию	Версия
`user`	-	все версии
`password`	-	все версии
`password1`	-	8.0.28
`password2`	-	8.0.28
`password3`	-	8.0.28
`authenticationPlugins`	-	5.1.19
`disabledAuthenticationPlugins`	-	5.1.19
`defaultAuthenticationPlugin`	caching_sha2_password	5.1.19
`ldapServerHostname`	-	8.0.23
`ociConfigFile`	-	8.0.27
`ociConfigProfile`	DEFAULT	8.0.33
`authenticationWebAuthnCallbackHandler`	-	8.2.0

Таблица 6.2 Свойства подключения

Таблица 6.2 Свойства подключения
Имя	Значение по умолчанию	Версия
`connectionAttributes`	-	5.1.25
`connectionLifecycleInterceptors`	-	5.1.4
`useConfigs`	-	3.1.5
`clientInfoProvider`	com.mysql.cj.jdbc.CommentClientInfoProvider	5.1.0
`createDatabaseIfNotExist`	false	3.1.9
`databaseTerm`	CATALOG	8.0.17
`detectCustomCollations`	false	5.1.29
`disconnectOnExpiredPasswords`	true	5.1.23
`interactiveClient`	false	3.1.0
`passwordCharacterEncoding`	-	5.1.7
`propertiesTransform`	-	3.1.4
`rollbackOnPooledClose`	true	3.0.15
`useAffectedRows`	false	5.1.7

Таблица 6.3 Свойства сессии

Таблица 6.3 Свойства сессии
Имя	Значение по умолчанию	Версия
`sessionVariables`	-	3.1.8
`characterEncoding`	-	1.1g
`characterSetResults`	-	3.0.13
`connectionCollation`	-	3.0.13
`customCharsetMapping`	-	8.0.26
`trackSessionState`	false	8.0.26

Таблица 6.4 Свойства сетевого уровня

Таблица 6.4 Свойства сетевого уровня
Имя	Значение по умолчанию	Версия
`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`	false	8.0.19
`localSocketAddress`	-	5.0.5
`maxAllowedPacket`	65535	5.1.8
`socksProxyRemoteDns`	false	8.0.29
`tcpKeepAlive`	true	5.0.7
`tcpNoDelay`	true	5.0.7
`tcpRcvBuf`	0	5.0.7
`tcpSndBuf`	0	5.0.7
`tcpTrafficClass`	0	5.0.7
`useCompression`	false	3.0.17
`useUnbufferedInput`	true	3.0.11

Таблица 6.5 Свойства безопасности

Таблица 6.5 Свойства безопасности
Имя	Значение по умолчанию	Версия
`paranoid`	false	3.0.1
`serverRSAPublicKeyFile`	-	5.1.31
`allowPublicKeyRetrieval`	false	5.1.31
`sslMode`	PREFERRED	8.0.13
`trustCertificateKeyStoreUrl`	-	5.1.0
`trustCertificateKeyStoreType`	JKS	5.1.0
`trustCertificateKeyStorePassword`	-	5.1.0
`fallbackToSystemTrustStore`	true	8.0.22
`clientCertificateKeyStoreUrl`	-	5.1.0
`clientCertificateKeyStoreType`	JKS	5.1.0
`clientCertificateKeyStorePassword`	-	5.1.0
`fallbackToSystemKeyStore`	true	8.0.22
`tlsCiphersuites`	-	5.1.35
`tlsVersions`	-	8.0.8
`fipsCompliantJsse`	false	8.1.0
`KeyManagerFactoryProvider`	-	8.1.0
`trustManagerFactoryProvider`	-	8.1.0
`keyStoreProvider`	-	8.1.0
`sslContextProvider`	-	8.1.0
`allowLoadLocalInfile`	false	3.0.3
`allowLoadLocalInfileInPath`	-	8.0.22
`allowMultiQueries`	false	3.1.1
`allowUrlInLocalInfile`	false	3.1.4
`requireSSL`	false	3.1.0
`useSSL`	true	3.0.2
`verifyServerCertificate`	false	5.1.6

Таблица 6.6 Свойства заявлений

Таблица 6.6 Свойства заявлений
Имя	Значение по умолчанию	С версии
`cacheDefaultTimeZone`	true	8.0.20
`continueBatchOnError`	true	3.0.3
`dontTrackOpenResources`	false	3.1.7
`queryInterceptors`	-	8.0.7
`queryTimeoutKillsConnection`	false	5.1.9

Таблица 6.7 Свойства подготовленных заявлений

Таблица 6.7 Свойства подготовленных заявлений
Имя	Значение по умолчанию	С версии
`allowNanAndInf`	false	3.1.5
`autoClosePStmtStreams`	false	3.1.12
`compensateOnDuplicateKeyUpdateCounts`	false	5.1.7
`emulateUnsupportedPstmts`	true	3.1.7
`generateSimpleParameterMetadata`	false	5.0.5
`processEscapeCodesForPrepStmts`	true	3.1.12
`useServerPrepStmts`	false	3.1.0
`useStreamLengthsInPrepStmts`	true	3.0.2

Таблица 6.8 Свойства наборов результатов

Таблица 6.8 Свойства наборов результатов
Имя	Значение по умолчанию	Версия
`clobberStreamingResults`	false	3.0.9
`emptyStringsConvertToZero`	true	3.1.8
`holdResultsOpenOverStatementClose`	false	3.1.7
`jdbcCompliantTruncation`	true	3.1.2
`maxRows`	-1	все версии
`netTimeoutForStreamingResults`	600	5.1.0
`padCharsWithSpace`	false	5.0.6
`populateInsertRowWithDefaultValues`	false	5.0.5
`scrollTolerantForwardOnly`	false	8.0.24
`strictUpdates`	true	3.0.4
`tinyInt1isBit`	true	3.0.16
`transformedBitIsBoolean`	false	3.1.9

Таблица 6.9 Свойства метаданных

Таблица 6.9 Свойства метаданных
Имя	Значение по умолчанию	Версия
`getProceduresReturnsFunctions`	true	5.1.26
`noAccessToProcedureBodies`	false	5.0.3
`nullDatabaseMeansCurrent`	false	3.1.8
`useHostsInPrivileges`	true	3.0.2
`useInformationSchema`	false	5.0.0

Таблица 6.10 Свойства обработки BLOB/CLOB

Таблица 6.10 Свойства обработки BLOB/CLOB
Имя	Значение по умолчанию	Версия
`blobSendChunkSize`	1048576	3.1.9
`blobsAreStrings`	false	5.0.8
`clobCharacterEncoding`	-	5.0.0
`emulateLocators`	false	3.1.0
`functionsNeverReturnBlobs`	false	5.0.8
`locatorFetchBufferSize`	1048576	3.2.1

Таблица 6.11 Свойства обработки типов дат и времени

Таблица 6.11 Свойства обработки типов дат и времени
Имя	Значение по умолчанию	Версия
`connectionTimeZone`	-	3.0.2
`forceConnectionTimeZoneToSession`	false	8.0.23
`noDatetimeStringSync`	false	3.1.7
`preserveInstants`	true	8.0.23
`sendFractionalSeconds`	true	5.1.37
`sendFractionalSecondsForTime`	true	8.0.23
`treatMysqlDatetimeAsTimestamp`	false	8.2.0
`treatUtilDateAsTimestamp`	true	5.0.5
`yearIsDateType`	true	3.1.9
`zeroDateTimeBehavior`	EXCEPTION	3.1.4

Таблица 6.12 Свойства высокой доступности и кластеризации

Таблица 6.12 Свойства высокой доступности и кластеризации
Имя	Значение по умолчанию	С версии
`autoReconnect`	false	1.1
`autoReconnectForPools`	false	3.1.3
`failOverReadOnly`	true	3.0.12
`maxReconnects`	3	1.1
`reconnectAtTxEnd`	false	3.0.10
`retriesAllDown`	120	5.1.6
`initialTimeout`	2	1.1
`queriesBeforeRetrySource`	50	3.0.2
`secondsBeforeRetrySource`	30	3.0.2
`allowReplicaDownConnections`	false	6.0.2
`allowSourceDownConnections`	false	5.1.27
`ha.enableJMX`	false	5.1.27
`loadBalanceHostRemovalGracePeriod`	15000	6.0.3
`readFromSourceWhenNoReplicas`	false	6.0.2
`selfDestructOnPingMaxOperations`	0	5.1.6
`selfDestructOnPingSecondsLifetime`	0	5.1.6
`ha.loadBalanceStrategy`	random	5.0.6
`loadBalanceAutoCommitStatementRegex`	-	5.1.15
`loadBalanceAutoCommitStatementThreshold`	0	5.1.15
`loadBalanceBlocklistTimeout`	0	5.1.0
`loadBalanceConnectionGroup`	-	5.1.13
`loadBalanceExceptionChecker`	com.mysql.cj.jdbc.ha.StandardLoadBalanceExceptionChecker	5.1.13
`loadBalancePingTimeout`	0	5.1.13
`loadBalanceSQLExceptionSubclassFailover`	-	5.1.13
`loadBalanceSQLStateFailover`	-	5.1.13
`loadBalanceValidateConnectionOnSwapServer`	false	5.1.13
`pinGlobalTxToPhysicalConnection`	false	5.0.1
`replicationConnectionGroup`	-	8.0.7
`resourceId`	-	5.0.1
`serverAffinityOrder`	-	8.0.8

Таблица 6.13 Свойства расширений производительности

Таблица 6.13 Свойства расширений производительности
Имя	Значение по умолчанию	С версии
`callableStmtCacheSize`	100	3.1.2
`metadataCacheSize`	50	3.1.1
`useLocalSessionState`	false	3.1.7
`useLocalTransactionState`	false	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`	true	3.1.7
`maintainTimeStats`	true	3.1.9
`useCursorFetch`	false	5.0.0
`cacheCallableStmts`	false	3.1.2
`cachePrepStmts`	false	3.0.10
`cacheResultSetMetadata`	false	3.1.1
`cacheServerConfiguration`	false	3.1.5
`defaultFetchSize`	0	3.1.9
`dontCheckOnDuplicateKeyUpdateInSQL`	false	5.1.32
`elideSetAutoCommits`	false	3.1.3
`enableEscapeProcessing`	true	6.0.1
`enableQueryTimeouts`	true	5.0.6
`largeRowSizeThreshold`	2048	5.1.1
`readOnlyPropagatesToServer`	true	5.1.35
`rewriteBatchedStatements`	false	3.1.13
`useReadAheadInput`	true	3.1.5

Таблица 6.14 Свойства отладки/профилирования

Таблица 6.14 Свойства отладки/профилирования
Имя	Значение по умолчанию	Версия с
`logger`	com.mysql.cj.log.StandardLogger	3.1.1
`profilerEventHandler`	com.mysql.cj.log.LoggingProfilerEventHandler	5.1.6
`useNanosForElapsedTime`	false	5.0.7
`maxQuerySizeToLog`	2048	3.1.3
`maxByteArrayAsHex`	1024	8.0.31
`profileSQL`	false	3.1.0
`logSlowQueries`	false	3.1.2
`slowQueryThresholdMillis`	2000	3.1.2
`slowQueryThresholdNanos`	0	5.0.7
`autoSlowLog`	true	5.1.4
`explainSlowQueries`	false	3.1.2
`gatherPerfMetrics`	false	3.1.2
`reportMetricsIntervalMillis`	30000	3.1.2
`logXaCommands`	false	5.0.5
`traceProtocol`	false	3.1.2
`enablePacketDebug`	false	3.1.3
`packetDebugBufferSize`	20	3.1.3
`useUsageAdvisor`	false	3.1.1
`resultSetSizeThreshold`	100	5.0.5
`autoGenerateTestcaseScript`	false	3.1.9
`openTelemetry`	PREFERRED	8.4.0

Таблица 6.15 Свойства исключений/предупреждений

Таблица 6.15 Свойства исключений/предупреждений
Имя	Значение по умолчанию	Версия с
`dumpQueriesOnException`	false	3.1.3
`exceptionInterceptors`	-	5.1.8
`ignoreNonTxTables`	false	3.0.9
`includeInnodbStatusInDeadlockExceptions`	false	5.0.7
`includeThreadDumpInDeadlockExceptions`	false	5.1.15
`includeThreadNamesAsStatementComment`	false	5.1.15
`useOnlyServerErrorMessages`	true	3.0.15

Таблица 6.16 Параметры для интеграции с другими продуктами

Таблица 6.16 Параметры для интеграции с другими продуктами
Имя	Значение по умолчанию	Версия с
`overrideSupportsIntegrityEnhancementFacility`	false	3.1.12
`ultraDevHack`	false	2.0.3

Таблица 6.17 Свойства соответствия JDBC

Таблица 6.17 Свойства соответствия JDBC
Имя	Значение по умолчанию	Версия с
`useColumnNamesInFindColumn`	false	5.1.7
`pedantic`	false	3.0.0
`useOldAliasMetadataBehavior`	false	5.0.4

Таблица 6.18 Свойства протокола X и X DevAPI

Таблица 6.18 Свойства протокола X и X DevAPI
Имя	Значение по умолчанию	Версия с
`xdevapi.auth`	PLAIN	8.0.8
`xdevapi.compression`	PREFERRED	8.0.20
`xdevapi.compression-algorithms`	zstd_stream,lz4_message,deflate_stream	8.0.22
`xdevapi.compression-extensions`	-	8.0.22
`xdevapi.connect-timeout`	10000	8.0.13
`xdevapi.connection-attributes`	-	8.0.16
`xdevapi.dns-srv`	false	8.0.19
`xdevapi.fallback-to-system-keystore`	true	8.0.22
`xdevapi.fallback-to-system-truststore`	true	8.0.22
`xdevapi.ssl-keystore`	-	8.0.22
`xdevapi.ssl-keystore-password`	-	8.0.22
`xdevapi.ssl-keystore-type`	JKS	8.0.22
`xdevapi.ssl-mode`	REQUIRED	8.0.7
`xdevapi.ssl-truststore`	-	6.0.6
`xdevapi.ssl-truststore-password`	-	6.0.6
`xdevapi.ssl-truststore-type`	JKS	6.0.6
`xdevapi.tls-ciphersuites`	-	8.0.19
`xdevapi.tls-versions`	-	8.0.19