Pool¶

class Configuration.Databases.Database.ExtraConnectionPools.Pool¶: В разделе указываются параметры дополнительных пулов соединений с БД для решения.

Атрибуты:

attr name → String¶: Системное имя пула. Имя должно быть уникально в рамках конфигурации решения.

attr url → String¶

Строка адреса БД.

Для PostgreSQL: <database url=”jdbc:postgresql://{server}:5432/{database}”/>.

attr schema → String¶

Схема базы данных.

По умолчанию: схема, заданная в основных настройках БД

attr acceptPrimary → Boolean¶

Флаг определяет, что пул может принимать запросы на получение первого sql-соединения для текущего потока.

Значение по умолчанию: true

attr acceptSecondary → Boolean¶

Флаг определяет, что пул может принимать запросы на получение второго и последующих sql-соединений для текущего потока.

Значение по умолчанию: true

attr acceptTxSession → Boolean¶

Флаг определяет, что пул может принимать запросы на получение соединения, которое будет использоваться для работы с данными в рамках транзакции базы данных.

Значение по умолчанию: true

attr acceptNoTxSession → Boolean¶

Флаг определяет, что пул может принимать запросы на получение соединения, которое будет использоваться для обращения к данным вне транзакции базы данных.

Значение по умолчанию: true

attr priority → Integer¶

Приоритет пула.

Если в конфигурации решения определены несколько дополнительных пулов, способных обрабатывать запросы на получение SQL-соединения по некому набору критериев, например: acceptPrimary == true && acceptTxSession == true, эти пулы будут отсортированы в порядке уменьшения приоритета, и запрос на получение соединения будет отправлен в пул с большим приоритетом (пул по умолчанию всегда будет последним, с минимальным приоритетом).

Минимальное значение: 0

Значение по умолчанию: 1

attr usageRatio → Double¶

Коэффициент использования пула.

Коэффициент определяет процент обработки данным пулом запросов на получение SQL-соединения.

Допустимые значения: 0.0 - 1.0

Значение по умолчанию: 1 (100% запросов будет обработано текущим пулом)

attr minPoolSize → Integer¶

Минимальное число свободных соединений в пуле.

Значение по умолчанию: 2.

See also

PoolProperties.getMinIdle()

attr maxPoolSize → Integer¶

Максимальное число соединений доступное для получения из пула.

Значение по умолчанию: 200.

При работе сервера приложений в режиме обучения и тестирования Edition.Student:

Значение по умолчанию: 20.

Максимальное значение: 20.

See also

PoolProperties.getMaxActive()

attr initialPoolSize → Integer¶

Начальное число соединений, которые будут открыты при старте пула.

Значение по умолчанию: 2.

See also

PoolProperties.getInitialSize()

attr inactiveConnectionTimeout → Integer¶

Время в течении которого сессия остаётся в пуле после освобождения, в секундах.

Значение по умолчанию: 60 секунд.

attr poolTimeout → Integer¶

Максимальное время ожидания получения соединения из пула, в секундах.

Значение по умолчанию: 10 секунд.

See also

PoolProperties.getMaxWait()

attr maxIdle → Integer¶

Максимальное количество свободных соединений, которое должно оставаться в пуле, если активен алгоритм вытеснения простаивающих соединений из пула. Алгоритм вытеснения активируется если выполнено одно из условий:

timeBetweenEvictionRunsMillis > 0 && testWhileIdle == true
inactiveConnectionTimeout > 0
maxAge > 0

Значение по умолчанию: Configuration.Databases.Database.maxPoolSize.

New in version AS: 1.22.0-ms3

See also

PoolProperties.getMaxIdle()

attr maxAge → Long¶

Максимальное время жизни соединения. Если, для соединения находящегося в пуле или возвращаемого в пул, интервал времени с момента открытия соединения превысит указанное значение, соединение будет переоткрыто.

Обратите внимание, что возраст простаивающих соединений будет проверяться только в том случае, если timeBetweenEvictionRunsMillis возвращает значение больше 0.

Значение по умолчанию: 0.

New in version AS: 1.22.0-ms3

See also

PoolProperties.getMaxAge()

attr validationIntervalMills → Long¶

Значение ограничивает частоту валидации соединений. Если соединение подлежит проверке, но уже было проверено ранее в течение этого интервала, оно не будет проверено повторно.

Значение по умолчанию: 3000 миллисекунд.

New in version AS: 1.22.0-ms3

See also

PoolProperties.getValidationInterval()

attr testOnBorrow → Boolean¶

Свойство определяет, будут ли соединения проверяться при взятии из пула.

Значение по умолчанию: false.

New in version AS: 1.22.0-ms3

See also

PoolProperties.isTestOnBorrow()

attr testOnReturn → Boolean¶

Свойство определяет, будут ли соединения проверяться после возвращения в пул.

Значение по умолчанию: true.

New in version AS: 1.22.0-ms3

See also

PoolProperties.isTestOnReturn()

attr testOnConnect → Boolean¶

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

Значение по умолчанию: false.

New in version AS: 1.22.0-ms3

See also

PoolProperties.isTestOnConnect()

attr testWhileIdle → Boolean¶

Свойство определяет, будут ли соединения проверяться в течении их нахождения в пуле.

Значение по умолчанию: false.

New in version AS: 1.22.0-ms3

See also

PoolProperties.isTestWhileIdle()

attr timeBetweenEvictionRunsMillis → Integer¶

Количество миллисекунд ожидания между запусками проверки простоя соединения, очистки заброшенных соединений. и изменение размера неактивного пула. Это значение определяет, как часто мы проверяем простаивающие, прерванные соединения, а также как часто мы проверяем простаивающие соединения и изменяем размер простаивающего пула.

Значение не должно быть установлено ниже 1 секунды.

Значение по умолчанию: 5000 миллисекунд

New in version AS: 1.22.0-ms3

attr validationQuery → String¶

SQL-запрос, который будет использоваться для проверки соединений из этого пула перед возвратом их вызывающей стороне или пулу. Если указано, этот запрос не должен возвращать никаких данных, он просто не должен выдать исключение SQLException.

Значение по умолчанию: null

New in version AS: 1.22.0-ms3

See also

PoolProperties.getValidationQuery()

attr validationQueryTimeout → Integer¶

Тайм-аут выполнения запроса проверки соединения, в секундах.

Значение меньше или равное нулю отключит эту функцию.

Значение по умолчанию: -1

New in version AS: 1.22.0-ms3

attr initSQL → String¶

Пользовательский запрос, который будет выполняться при первом создании соединения. Этот запрос выполняется только один раз для каждого соединения, то есть при установке нового соединения с базой данных. Если это значение не равно нулю, оно заменит запрос проверки во время создания соединения.

Значение по умолчанию: null

New in version AS: 1.22.0-ms3

See also

PoolProperties.getInitSQL()