Database

class Configuration.Databases.Database

Параметры подключения к базе данных.

Вложенные элементы:

elem metaManager → Configuration.Databases.Database.MetaManager

Параметры менеджера метаданных выборок.

elem eclipseLink → Configuration.Databases.Database.EclipseLink

Параметры загрузки EclipseLink.

elem systemUsers → Configuration.Users

Список системных пользователей.

Устарело. Используйте список: <security><users/></security>.

elem amqp → Configuration.Databases.Database.AMQP

Конфигурация подключения к серверу AMQP

elem gtkSessionPools → Configuration.Databases.Database.GtkSessionPools

Пулы gtk-сессий

elem repositories → Configuration.Databases.Database.Repositories

Пулы gtk-сессий

elem extraConnectionPools → Configuration.Databases.Database.ExtraConnectionPools

Дополнительные пулы SQL-соединений с БД.

Added in version AS: 1.22.0-ms3

elem ui → Configuration.Databases.Database.UI

Конфигурация настроек пользовательского интерфейса

elem thin → Configuration.Databases.Database.Thin

Параметры подключения к БД Оракл с использованием Thin-драйвера.

elem ldap → Configuration.Databases.Database.Ldap

Параметры подключения к службе каталогов.

Используются при подключении к службе каталогов для проверки аутентификационных данных пользователя, если в конфигурации указано <databases authenticationType=”ldap”/>

Пример: <ldap url=”ldap://192.168.x.x” domain=”corp.local”/>

elem users → Configuration.Users

Список пользователей БД.

Первый пользователь этого списка используется сервером приложений Global для открытия пула соединений с БД.

elem lockedUsers → Configuration.Databases.Database.LockedUsers

Список заблокированных пользователей.

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

Атрибуты:

attr environmentIndicator → String

Имя индикатора среды рабочего окружения.

(нечувствительно к регистру)

Added in version 1.21.0-ms13.

See also

Configuration.EnvironmentIndicators.Indicator

attr maxActiveThreadCount → Integer

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

Параметр влияет на вероятность возникновения взаимной блокировки пользовательских сессий.

Пример задачи, решаемой указанием данного параметра.

Предположим, оптимальный максимум сессий БД {maxPoolSize}: 60. Если 500 пользователей войдут в систему, они могут захватить все 60 соединений с ДБ. При попытках начала автономных транзакций, сессии заблокируют друг друга, т.к. не смогут получить дополнительные соединения с БД. Во избежание данной ситуации, рекомендуется ограничить число пользователей одновременной работающих с БД. В данном примере, до 40. Таким образом 40 работающих пользователей будут иметь 20 соединений с ДБ для выполнения автономных транзакций. За счёт быстрого выполнения автономных транзакций, взаимные блокировки не будут возникать.

Допустимые значения: от 0 до Integer.MAX_VALUE. По умолчанию: 0.

При значениях value <= 0 и value == Integer.MAX_VALUE ограничение на число потоков не устанавливается.

Added in version AS: 1.22.0-ms3

attr activeThreadTimeout → Integer

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

Допустимые значения: от 1 до 900 секунд. По умолчанию: 15 секунд.

Added in version AS: 1.22.0-ms3

attr alias → String

Алиас (системное имя) базы. Имя должно быть уникально в рамках конфигурации сервера.

attr driver → String

Имя класса драйвера, используемого для открытия соединений с БД.

Для PostgreSQL: <database driver=”org.postgresql.Driver”/>.

По умолчанию: <database driver=”oracle.jdbc.OracleDriver”/>.

attr url → String

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

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

attr schema → String

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

По умолчанию: для Oracle: <database schema=”btk”/> для других БД : <database schema=”PUBLIC”/>.

attr useProxyAuthentication → Boolean

Флаг специфичен для БД Oracle. Указывает, что для подключения к БД будет использоваться прокси-авторизация. Пользовательское подключение будет осуществляться “сквозь” подключение, открытое от имени системного пользователя.

attr connectionType → Configuration.Databases.Database.ConnectionType

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

attr authenticationType → Configuration.Databases.Database.AuthenticationType

Определяет способ проверки аутентификационных данных пользователя.

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 секунд.

See also

PoolProperties.getMinEvictableIdleTimeMillis()

attr poolTimeout → Integer

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

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

See also

PoolProperties.getMaxWait()

attr maxIdle → Integer

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

• timeBetweenEvictionRunsMillis > 0 && testWhileIdle == true

• inactiveConnectionTimeout > 0

• maxAge > 0

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.getMaxIdle()

attr maxAge → Long

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

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.getMaxAge()

attr validationIntervalMills → Long

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.getValidationInterval()

attr testOnBorrow → Boolean

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.isTestOnBorrow()

attr testOnReturn → Boolean

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.isTestOnReturn()

attr testOnConnect → Boolean

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.isTestOnConnect()

attr testWhileIdle → Boolean

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.isTestWhileIdle()

attr timeBetweenEvictionRunsMillis → Integer

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

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.getTimeBetweenEvictionRunsMillis()

attr validationQuery → String

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.getValidationQuery()

attr validationQueryTimeout → Integer

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

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.getValidationQueryTimeout()

attr initSQL → String

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

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

Added in version AS: 1.22.0-ms3

See also

PoolProperties.getInitSQL()