DISABLE_DATASOURCE
Содержание раздела
Поддерживается в версиях: 7.8 / 7.7 / 7.6 / 7.5 / 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(varchar | char | string)-
Имя отключаемого датасорса.
db_name(строковый идентификатор)-
Имя логической базы данных, для которой отключается датасорс. Если параметр не указан, датасорс отключается для всех логических БД окружения.
Варианты ответа
В ответе возвращается:
- пустой объект ResultSet при успешном выполнении запроса;
- исключение при неуспешном выполнении запроса.
Примеры
Отключение датасорса для одной логической БД
DISABLE_DATASOURCE('adp2', marketing)
Отключение датасорса для всех логических БД окружения
DISABLE_DATASOURCE('adp2')