Параметры источника данных WebSphere Application Server

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

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

Ресурсы > JDBC > Источники данных > источник_данных > Свойства источника данных WebSphere Application Server
Ресурсы > JDBC > Провайдеры JDBC > провайдер_JDBC > Источники данных > источник_данных > Свойства источника данных WebSphere Application Server
Приложения > Типы приложений > Приложения предприятий WebSphere > имя-приложения > Ресурсы области приложения > источник-данных > Свойства источника данных WebSphere Application Server.

Размер кэша операторов

Указывает число операторов, доступных для кэширования для одного соединения. Сервер приложений кэширует оператор после того, как пользователь его закрывает.

Источник данных WebSphere Application Server оптимизирует обработку подготовленных утверждений и вызываемых операторов, кэшируя утверждения, не используемые активным соединением. Оба типа операторов помогают максимизировать производительность транзакций между приложением и хранилищем данных.

Подготовленный оператор является предварительно скомпилированным оператором SQL, хранящимся в объекте PreparedStatement. Сервер приложений использует этот объект для выполнения оператора SQL столько раз, сколько требует среда выполнения приложения, и с такими значениями, какие она определяет.
Вызываемый оператор является оператором SQL, содержащим вызов хранящейся процедуры, являющийся серией предварительно скомпилированных операторов, выполняющей задачу и возвращающей результат. Оператор хранится в объекте CallableStatement. Сервер приложений использует этот объект для выполнения хранимой процедуры столько раз, сколько требует среда выполнения приложения, и с такими значениями, какие она определяет.

Если размер кэша операторов является недостаточно большим, полезные записи аннулируются чтобы предоставить место новым записям. Для определения максимального размера кэша и избежания аннулирования кэша добавьте несколько уникальных подготовленных операторов и вызываемых операторов (согласно строке SQL, параллелизму и типу прокрутки) для каждого приложения, использующего этот источник данных на определенном сервере. Это максимальное число возможных операторов, доступных для кэширования для определенного соединения на протяжении срока жизни сервера. Задав для размера кэша это значение вы отмените выполнение аннулирования кэша. Вообще, чем больше операторов у приложения, тем больший размер кэша для него нужно устанавливать.

Для минимизации количества сбросов кэша можно использовать программу Tivoli Performance Viewer. Используйте обычную рабочую нагрузку, представляющую типичное число входящих клиентских запросов, используйте фиксированное число повторений и стандартный набор параметров конфигурации.

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

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

В тестируемых приложениях настройка кэша операторов позволяет увеличить производительность от 10% до 20%. Однако из-за потенциальных ограничений ресурса процесс тонкой настройки возможен не всегда.

Информация	Значение
Тип данных	Целое число
Значение по умолчанию	Значения по умолчанию зависят от базы данных. Обычно значение по умолчанию равно 10. Для Informix версий 7.3, 9.2, 9.3 и 9.4 без соответствующих исправлений значение по умолчанию должно быть равно 0. Значение 0 означает отсутствие оператора кэша.

Информация

Значение

Тип данных

Целое число

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

Значения по умолчанию зависят от базы данных. Обычно значение по умолчанию равно 10. Для Informix версий 7.3, 9.2, 9.3 и 9.4 без соответствующих исправлений значение по умолчанию должно быть равно 0. Значение 0 означает отсутствие оператора кэша.

Включить обнаружение многопоточного доступа

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

J2CA0167W: Обнаружена попытка нескольких нитей одновременно использовать один описатель соединения. Описатель соединения: {0}.

Включить повторную идентификацию базы данных

Если эта опция включена, соединения, извлеченные из пула сервера приложений, никогда точно не совпадают (критерии поиска пула соединений не включают в себя имя пользователя и пароль). Вместо этого выполняется повторная идентификация соединения в doConnectionSetupPerTransaction() класса DataStoreHelper. Сервер приложений не имеет реализации повторной идентификации соединений во время выполнения. Поэтому при выключении этой опции необходимо расширить класс DataStoreHelper для предоставления реализации метода doConnectionSetupPerTransaction() при выполнении повторной идентификации. Если этого не сделать, сервер может возвращать непригодные для использования соединения. См. документацию по API для метода com.ibm.websphere.rsadapter.DataStoreHelper#doConnectionSetupPerTransaction.

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

Предотвращение неполадок: Если для псевдонима конфигурации преобразования выбрано значение TrustedConnectionMapping, включать повторную идентификацию базы данных нельзя.gotcha

Включить поддержку однофазной оптимизации JMS

При включении этого переключателя сервер приложений получает оптимизированные соединения из источника данных с помощью службы сообщений Java (JMS). Это свойство запрещает приложениям JDBC использовать соединения совместно с приложениями CMP. Этот параметр недоступен для провайдера JDBC XA.

Управлять кэшированными описателями

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

Если свойство Управлять кэшированными дескрипторами выбрано в административной консоли, то в случае отмены его выбора это поле станет невидимым для ресурсов сервера приложений версии 7.0 или более поздней версии. Это поле отображается только в том случае, если для свойства manageCachedHandles задано значение true в файле resources.xml. Для того чтобы сделать это поле доступным, измените значение свойства manageCachedHandles с false на true в файле resources.xml, или введите следующую команду Jython с помощью утилиты wsadmin:

AdminConfig.modify(myDataSourceVariable, '[[manageCachedHandles "true"]]')

Прим.: Для всех ресурсов сервера приложений версии 6.x свойство Управлять кэшированными дескрипторами является всегда видимым. Например, если имеется узел версии 6.1, то запись в файле resources.xml не влияет на способ отображения поля в административной консоли.

В качестве другого способа отладки можно использовать многонитевые и межкомпонентные диагностические предупреждения для обнаружения нарушений в модели программирования JCA. Для того чтобы активировать эти предупреждения, выберите соответствующие опции в панели Серверы > Серверы приложений > сервер_приложений > Производительность > Конфигурация Советника по производительности и диагностике > Конфигурация рекомендаций по оптимизации работы. Если эти предупреждения активны, диспетчер соединений управляет кэшированными дескрипторами, обнаруживает состояние соединений и отправляет предупреждения.

Прим.: Для активации этих предупреждений необходимо также выбрать опцию Включить среду Советника по производительности и диагностике (Советник по динамической производительности) в панели Серверы > Серверы приложений > сервер_приложений > Производительность > Конфигурация Советника по производительности и диагностике.

Записывать в протокол отсутствующий контекст транзакций

Указывает, должен ли контейнер создавать запись в протоколе операций при получении приложением соединения без контекста транзакции. Это исключения из требований к соединениям модели программирования Java Platform, Enterprise Edition (Java EE).

Источник данных без поддержки транзакций

Указывает, что сервер приложений не будет задействовать соединения этого источника данных в глобальных и локальных транзакциях. Приложения должны будут явно вызывать setAutoCommit(false) в соединении, если им потребуется запустить локальную транзакцию в соединении, и они должны будут зафиксировать или аннулировать запущенную транзакцию.

Предотвращение неполадок: В редких случаях этому свойству следует присвоить значение true, если приложению Java Persistence API (JPA) необходимы источники JTA и источники без поддержки JTA. Для источников данных без поддержки JTA необходимо, чтобы это свойство равнялось true.gotcha

Использовать модель проверки исключений WebSphere Application Server

Включает использование сервером приложений функции преобразования ошибок, определенной во вспомогательной программе источников данных для идентификации ошибок. Сервер приложений не заменяет исключительные ситуации, возбуждаемые драйвером JDBC, исключительными ситуациями из таблицы преобразования ошибок вспомогательной программы источников данных.

Использовать модель преобразования исключительных ситуаций WebSphere Application Server

Включает использование сервером приложений функции преобразования ошибок, определенной во вспомогательной программе источников данных для идентификации ошибок. Сервер приложений будет заменять исключительные ситуации, возбуждаемые драйвером JDBC, исключительными ситуациями из таблицы преобразования ошибок вспомогательной программы источников данных.

Прим.: Данная модель обнаружения ошибок работает с JDBC версии 3.0 и более ранних версий.

Проверять новые соединения

Включает режим, в котором диспетчер соединений проверяет новые соединения с базой данных.

Число попыток

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

Периодичность опроса

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

Проверять имеющиеся в пуле соединения

Включает режим диспетчера соединений, в котором он проверяет соединения в пуле перед их возвратом приложениям.

Периодичность опроса

Если опция Предварительная проверка имеющихся в пуле соединений выбрана, она определяет, сколько времени в секундах выделяется драйверу JDBC для проверки соединения.

Проверка с помощью драйвера JDBC

Включает режим использования сервером приложений для проверки соединений драйвера JDBC. Для использования этого режима провайдер JDBC должен поддерживать JDBC 4.0 или выше. Этот параметр доступен только в том случае, если выбран параметр Проверить новые соединения или Проверить существующие соединения из пула.

Предотвращение неполадок: Для источника данных Oracle опция Проверка с помощью драйвера JDBC отображается в административной консоли только после добавления свойства validateNewConnectionTimeout в раздел [Updated in September 2013]

Пользовательские свойства для источника данных [Updated in September 2013]

. Свойство validateNewConnectionTimeout применяется для проверки драйвера JDBC 4.0; его можно указать с помощью административной консоли.gotcha

Тайм-аут

Тайм-аут в секундах для проверки соединений с базой данных (новых или помещенных сервером приложений в пул). Если тайм-аут истекает до проверки, соединение считается непригодным для использования. Если настроен режим повторных проверок, значение тайм-аута применяется к каждому повтору в отдельности. Значение 0 означает, что драйвер JDBC не применяет тайм-аут проверки.

Прим.: Эта опция доступна только для драйверов JDBC, совместимых с JDBC 4.0.

Проверка с помощью строки SQL (устарело)

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

Оптимизировать для шаблона получить/использовать/закрыть соединение с помощью гетерогенного пула

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

В случае применения разнородного пула в первую очередь необходимо расширить определение источника данных, чтобы разрешить переопределение небазовых свойств источника данных с помощью других пользовательских свойств и приложений. Дополнительная информация о расширении источников данных приведена в документации по расширению определений источников данных DB2 на уровне приложений.