DISABLE_DATASOURCE

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

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

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

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

Не используйте команду для ADP-датасорсов при включенном механизме auto-failover. Иначе возможно нарушение консистентности данных.

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

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

При успешном выполнении запроса система переводит датасорс в статус disabled («Отключен») и начинает распределять запросы на чтение и запись данных по другим датасорсам хранилища.

Отслеживать статусы датасорсов можно с помощью GET_RECOVER_STATUS.

Синтаксис

DISABLE_DATASOURCE(datasource_name[, db_name])

Параметры:

datasource_name

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

db_name

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

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

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

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

Ограничения

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

Примеры

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

DISABLE_DATASOURCE('adp2', marketing)

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

DISABLE_DATASOURCE('adp2')