Spec-Zone.ru › MySQL Connectors 1.0

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.
https://docs.oracle.com/cd/E17952_01/connector-j-en/connector-j-connp-props-high-availability-and-clustering.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API