DISABLE_DATASOURCE

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

Поддерживается в версиях:  6.5.

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

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

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

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

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

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

Синтаксис

DISABLE_DATASOURCE(datasource_alias[, db_name])

Параметры:

datasource_alias

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

db_name

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

Ограничения

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

Примеры

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

DISABLE_DATASOURCE('adp2', marketing)

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

DISABLE_DATASOURCE('adp2')