MODIFY BACKEND
Описание
Этот оператор используется для изменения атрибутов узлов BE. Изменение атрибутов узлов BE влияет на выполнение запросов, запись и распределение данных на текущем узле. Можно изменить следующие атрибуты:
| Свойство | Влияние |
|---|---|
tag.location | Тег ресурсов узла BE; значение по умолчанию: default. Изменение влияет на балансировку данных между узлами BE в одной группе тегов и на выбор узлов BE для распределения данных при создании таблицы. Подробнее см. в разделе Группа ресурсов. |
disable_query | Определяет, отключено ли выполнение запросов. Значение по умолчанию: false. После установки значения true новые запросы не будут направляться на этот узел BE. |
disable_load | Определяет, отключена ли загрузка данных. Значение по умолчанию: false. После установки значения true новые запросы на импорт не будут направляться на этот узел BE. |
Эта команда не поддерживается в режиме разделения хранения и вычислений.
Синтаксис
ALTER SYSTEM MODIFY BACKEND <be_identifier> [, <be_identifier> ... ]
SET (
"<key>" = "<value>"
)
Где:
be_identifier
: "<be_host>:<be_heartbeat_port>"
| "<backend_id>"
Обязательные параметры
1. <be_host>
Имя хоста или IP-адрес узла BE.
2. <heartbeat_port>
Порт проверки доступности узла BE, по умолчанию 9050.
3. <backend_id>
Идентификатор узла BE.
<be_host>, <be_heartbeat_port> и <backend_id> можно получить с помощью оператора SHOW BACKENDS.
Требования к правам доступа
Пользователь, выполняющий этот SQL, должен иметь как минимум следующие права:
| Право | Объект | Примечания |
|---|---|---|
| NODE_PRIV |
Примечания по использованию
Эта операция затрагивает весь узел BE и имеет широкую область воздействия. При неосторожном выполнении она может нарушить нормальное выполнение запросов, загрузку данных и даже создание таблиц во всём кластере. Выполняйте её с осторожностью.
Примеры
- Изменение тега ресурсов узла BE
ALTER SYSTEM MODIFY BACKEND "127.0.0.1:9050" SET ("tag.location" = "group_a");
- Изменение атрибута
disable_queryузла BE
ALTER SYSTEM MODIFY BACKEND "10002" SET ("disable_query" = "true");
- Изменение атрибута
disable_loadузла BE
ALTER SYSTEM MODIFY BACKEND "127.0.0.1:9050" SET ("disable_load" = "true");