DISABLE_DATASOURCE

Содержание раздела
  1. Результат выполнения
  2. Синтаксис
  3. Варианты ответа
  4. Ограничения
  5. Примеры
    1. Отключение датасорса для одной логической БД
    2. Отключение датасорса для всех логических БД окружения

Поддерживается в версиях:  6.12 / 6.11 / 6.10 / 6.9 / 6.8 / 6.7 / 6.6 / 6.5.

Запрос отключает датасорс для указанной или всех логических БД окружения. Отключить датасорс можно, например, при сбое СУБД датасорса для проведения технических работ.

После отключения датасорс можно восстановить.

Подробнее о функции восстановления датасорсов и действиях по восстановлению см. в разделе Восстановление датасорсов.

Результат выполнения

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

Синтаксис

DISABLE_DATASOURCE(datasource_alias[, db_name])

Параметры:

datasource_alias

Имя отключаемого датасорса. Указывается в одинарных кавычках (например, 'adp').

db_name

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

Варианты ответа

В ответе возвращается:

  • пустой объект ResultSet при успешном выполнении запроса;
  • исключение при неуспешном выполнении запроса.

Ограничения

  • Запрос доступен только для СУБД ADB и ADP.

Примеры

Отключение датасорса для одной логической БД

DISABLE_DATASOURCE('adp2', marketing)

Отключение датасорса для всех логических БД окружения

DISABLE_DATASOURCE('adp2')