ERASE_READ_BALANCE

Содержание раздела
  1. Как работает запрос
  2. Связанные запросы
  3. Синтаксис
  4. Варианты ответа
  5. Примеры
    1. Удаление настроек по одному приоритету запросов в одном датасорсе
    2. Удаление настроек по одному приоритету запросов во всех датасорсах
    3. Удаление настроек по всем приоритетам запросов во всех датасорсах

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

Запрос удаляет настройки балансировки чтения.

Возможно удаление настроек:

Как работает запрос

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

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

  • SET_READ_BALANCE — добавляет или обновляет настройку балансировки;
  • GET_READ_BALANCE — возвращает текущие настройки балансировки;
  • CHECK_READ_SLOTS — возвращает текущее состояние слотов на чтение;
  • RESET_READ_SLOTS — обнуляет счетчики занятых слотов на чтение.

Синтаксис 

ERASE_READ_BALANCE([sql_request_priority[, datasource_name]])

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

Параметры:

sql_request_priority (varchar | char | string)

Приоритет запросов на чтение, для которого удаляется настройка.

Если указан приоритет, для которого отсутствуют настройки балансировки, возвращается пустой ответ.

datasource_name (varchar | char | string)

Имя датасорса, для которого удаляется настройка указанного приоритета запросов.

Если указанное имя не соответствует конфигурации, возвращается пустой ответ. Если имя датасорса не указано, удаляются настройки по всем датасорсам:

  • указанного приоритета запросов — если sql_request_priority указан;
  • всех приоритетов запросов — если sql_request_priority не указан.

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

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

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

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

Примеры

Удаление настроек по одному приоритету запросов в одном датасорсе 

ERASE_READ_BALANCE('high', 'adp2')

Удаление настроек по одному приоритету запросов во всех датасорсах 

ERASE_READ_BALANCE('high')

Удаление настроек по всем приоритетам запросов во всех датасорсах 

ERASE_READ_BALANCE()