6.3.12 Высокая доступность и кластеризация
-
autoReconnectДолжен ли драйвер пытаться восстановить устаревшие и/или нерабочие соединения? Если включено, драйвер выбросит исключение для запросов, выданных по устаревшему или нерабочему соединению, которые принадлежат текущей транзакции, но будет пытаться переподключиться перед следующим запросом, выданным по соединению в новой транзакции. Использование этой функции не рекомендуется, поскольку она имеет побочные эффекты, связанные с состоянием сессии и согласованностью данных, когда приложения не обрабатывают SQLExceptions должным образом, и предназначена только для использования, когда вы не можете настроить свое приложение для правильной обработки SQLExceptions, возникающих в результате нерабочих и устаревших соединений. В качестве альтернативы, в последнюю очередь, изучите возможность установки переменной сервера MySQL 'wait_timeout' на высокое значение, а не на значение по умолчанию 8 часов.
Default Value false Since Version 1.1 -
autoReconnectForPoolsИспользовать стратегию переподключения, подходящую для пулов соединений?
Default Value false Since Version 3.1.3 -
failOverReadOnlyПри отказоустойчивости в режиме 'autoReconnect' соединение должно быть установлено как 'только для чтения'?
Default Value true Since Version 3.0.12 -
maxReconnectsМаксимальное количество попыток переподключения, если 'autoReconnect' равно "true".
Default Value 3 Since Version 1.1 -
reconnectAtTxEndЕсли 'autoReconnect' установлен в "true", должен ли драйвер пытаться переподключиться в конце каждой транзакции?
Default Value false Since Version 3.0.10 -
retriesAllDownПри использовании балансировки нагрузки или отказоустойчивости, количество раз, которое драйвер должен циклически проходить по доступным хостам, пытаясь установить соединение. Между циклами драйвер будет приостанавливаться на 250 мс, если серверы недоступны.
Default Value 120 Since Version 5.1.6 -
initialTimeoutЕсли включен 'autoReconnect', начальное время ожидания между попытками переподключения (в секундах, по умолчанию "2").
Default Value 2 Since Version 1.1 -
queriesBeforeRetrySourceПри использовании отказоустойчивости с несколькими хостами, количество запросов, которые необходимо выполнить, прежде чем вернуться к основному хосту при отказе. Любое из условий, 'queriesBeforeRetrySource' или 'secondsBeforeRetrySource', будет выполнено первым и вызовет попытку переподключения к основному хосту. Установка обоих свойств в "0" отключает автоматический возврат к основному хосту на границах транзакций.
Default Value 50 Since Version 3.0.2 -
secondsBeforeRetrySourceКак долго, в секундах, драйвер должен ждать при отказе, прежде чем пытаться переподключиться к основному хосту? Любое из условий, 'queriesBeforeRetrySource' или 'secondsBeforeRetrySource', будет выполнено первым и вызовет попытку переподключения к исходному хосту. Установка обоих свойств в "0" отключает автоматический возврат к основному хосту на границах транзакций.
Default Value 30 Since Version 3.0.2 -
allowReplicaDownConnectionsПо умолчанию, соединение с учетом репликации не сможет подключиться, если все настроенные реплицированные хосты недоступны при начальном подключении. Установка этого свойства в "true" позволяет установить начальное соединение. Это не предотвратит сбои при переключении на реплики, например, путем перевода реплицированного соединения в состояние "только для чтения". Для этой цели следует использовать свойство 'readFromSourceWhenNoReplicas'.
Default Value false Since Version 6.0.2 -
allowSourceDownConnectionsПо умолчанию, соединение с учетом репликации не сможет подключиться, если все настроенные исходные хосты недоступны при начальном подключении. Установка этого свойства в "true" позволяет установить начальное соединение, переключившись на серверы-реплики в режиме "только для чтения". Это не предотвратит последующие сбои при переключении обратно на исходные хосты, например, путем перевода реплицированного соединения в состояние "чтение/запись".
Default Value false Since Version 5.1.27 -
ha.enableJMXВключает управление группами соединений с балансировкой нагрузки на основе JMX, включая добавление/удаление хостов из пула балансировки нагрузки. Включает управление группами соединений репликации на основе JMX, включая повышение уровня реплики, добавление новых реплик и удаление исходных или реплицированных хостов из пулов соединений с балансировкой нагрузки для источника и реплик.
Default Value false Since Version 5.1.27 -
loadBalanceHostRemovalGracePeriodЗадает период ожидания освобождения хоста, удаляемого из соединения с балансировкой нагрузки, если он в данный момент является активным хостом.
Default Value 15000 Since Version 6.0.3 -
readFromSourceWhenNoReplicasСоединения с учетом репликации распределяют нагрузку, используя исходные хосты в состоянии чтения/записи и реплицированные хосты в состоянии "только для чтения". Если при переходе в состояние "только для чтения" ни один из реплицированных хостов недоступен, возвращается 'SQLException'. Установка этого свойства в "true" позволяет переключиться на исходные хосты, установив состояние соединения в "только для чтения", если реплицированные хосты недоступны в момент переключения.
Default Value false Since Version 6.0.2 -
selfDestructOnPingMaxOperationsЕсли установлено ненулевое значение, драйвер закроет соединение и сообщит об ошибке, когда вызывается 'com.mysql.cj.jdbc.JdbcConnection.ping()' или 'java.sql.Connection.isValid(int)', если количество команд соединения, отправленных на сервер, превышает это значение.
Default Value 0 Since Version 5.1.6 -
selfDestructOnPingSecondsLifetimeЕсли установлено ненулевое значение, драйвер закроет соединение и сообщит об ошибке, когда вызывается 'com.mysql.cj.jdbc.JdbcConnection.ping()' или 'java.sql.Connection.isValid(int)', если время существования соединения превышает это значение, указанное в миллисекундах.
Default Value 0 Since Version 5.1.6 -
ha.loadBalanceStrategyПри использовании соединения с балансировкой нагрузки для подключения к SQL-серверам в конфигурации MySQL Cluster (используя префикс URL "jdbc:mysql:loadbalance://"), какой алгоритм балансировки нагрузки должен использовать драйвер: (1) "random" - драйвер будет выбирать случайный хост для каждого запроса. Это, как правило, работает лучше, чем круговая рассылка, поскольку случайность несколько учитывает распределение нагрузок, где запросы различаются по времени отклика, в то время как круговая рассылка может иногда приводить к перегрузке узлов, если существуют вариации времени отклика в рабочей нагрузке. (2) "bestResponseTime" - драйвер будет направлять запрос на хост, у которого было лучшее время отклика для предыдущей транзакции. (3) "serverAffinity" - драйвер изначально пытается обеспечить соответствие серверу, сохраняя при этом преимущества и пользуясь аспектами отказоустойчивости реализации балансировки нагрузки. Список заказов соответствия серверу предоставляется с помощью свойства 'serverAffinityOrder'. Если ни один из серверов, указанных в списке соответствия, не отвечает, драйвер затем использует стратегию "random" для продолжения выбора следующего сервера.
Default Value random Since Version 5.0.6 -
loadBalanceAutoCommitStatementRegexКогда балансировка нагрузки включена для операторов автоматической фиксации (через 'loadBalanceAutoCommitStatementThreshold'), счетчик операторов будет увеличиваться только тогда, когда SQL соответствует регулярному выражению. По умолчанию, каждый выданный оператор соответствует.
Since Version 5.1.15
-
loadBalanceAutoCommitStatementThresholdПри включённом авто-сохранении количество запросов, которые должны быть выполнены перед запуском балансировки нагрузки для перераспределения. Значение по умолчанию "0" приводит к тому, что балансируемые соединения перераспределяются только при возникновении исключений или при отключённом авто-сохранении и явном подтверждении или откате транзакций.
Значение по умолчанию 0 Версия с момента выпуска 5.1.15 -
loadBalanceBlocklistTimeoutВремя в миллисекундах между проверками серверов, которые недоступны, контролируя время жизни сервера в глобальном чёрном списке.
Значение по умолчанию 0 Версия с момента выпуска 5.1.0 -
loadBalanceConnectionGroupЛогическая группа балансируемых соединений внутри загрузчика классов, используемая для независимого управления различными группами. Если не указано, управление балансируемыми соединениями в реальном времени отключено.
Версия с момента выпуска 5.1.13 -
loadBalanceExceptionCheckerПолное имя класса пользовательского обработчика исключений. Класс должен реализовывать интерфейс 'com.mysql.cj.jdbc.ha.LoadBalanceExceptionChecker' и используется для проверки исключений 'SQLException' и определения того, следует ли переключиться на другой хост при балансировке нагрузки.
Значение по умолчанию com.mysql.cj.jdbc.ha.StandardLoadBalanceExceptionChecker Версия с момента выпуска 5.1.13 -
loadBalancePingTimeoutВремя в миллисекундах ожидания ответов пинга от каждого из физических подключений с балансировкой нагрузки при использовании подключений с балансировкой нагрузки.
Значение по умолчанию 0 Версия с момента выпуска 5.1.13 -
loadBalanceSQLExceptionSubclassFailoverСписок классов/интерфейсов, разделённых запятыми, используемых по умолчанию обработчиком исключений с балансировкой нагрузки для определения того, должно ли данное исключение 'SQLException' привести к переключению. Сравнение выполняется с использованием 'Class.isInstance(SQLException)' с выброшенным 'SQLException'.
Версия с момента выпуска 5.1.13 -
loadBalanceSQLStateFailoverСписок кодов 'SQLState', разделённых запятыми, используемых обработчиком исключений с балансировкой нагрузки по умолчанию для определения того, должно ли данное исключение 'SQLException' привести к переключению. 'SQLState' данного 'SQLException' оценивается для определения того, начинается ли он с любого из значений, указанных в списке, разделённом запятыми.
Версия с момента выпуска 5.1.13 -
loadBalanceValidateConnectionOnSwapServerДолжен ли балансируемый по нагрузке клиент явно проверять, является ли подключение активным при переключении на новое физическое подключение при подтверждении/отмене?
Значение по умолчанию false Версия с момента выпуска 5.1.13 -
pinGlobalTxToPhysicalConnectionПри использовании подключений XA, должен ли драйвер гарантировать, что операции с заданным XID всегда направляются на одно и то же физическое подключение? Это позволяет 'XAConnection' поддерживать "XA START ... JOIN" после вызова "XA END".
Значение по умолчанию false Версия с момента выпуска 5.0.1 -
replicationConnectionGroupЛогическая группа подключений к репликации внутри загрузчика классов, используемая для независимого управления различными группами. Если не указано, управление подключениями к репликации в реальном времени отключено.
Версия с момента выпуска 8.0.7 -
resourceIdУникальное имя, которое идентифицирует ресурс, к которому подключён этот источник данных или соединение, используемый для 'XAResource.isSameRM()' в тех случаях, когда драйвер не может определить это значение на основе имён хостов, используемых в URL.
Версия с момента выпуска 5.0.1 -
serverAffinityOrderСписок, разделённый запятыми, содержащий пары хост/порт, которые должны быть использованы в стратегии балансировки нагрузки "serverAffinity". Будет использована только подмножество хостов, перечисленных в основном разделе хостов в этом URL, и они должны быть идентичными по регистру и типу, т.е. нельзя использовать IP-адрес в одном месте и соответствующее имя хоста в другом.
Версия с момента выпуска 8.0.8
© 2025 Oracle
Licensed under the GPLv2 License.