ALTER SYSTEM

ALTER SYSTEM управляет узлами FE, BE, CN, Broker и снимками метаданных в cluster.

ПРИМЕЧАНИЕ

Только роль cluster_admin имеет привилегию для выполнения этой операции.

Синтаксис и параметры

FE

• Добавить Follower FE.

  ALTER SYSTEM ADD FOLLOWER "<fe_host>:<edit_log_port>"[, ...]

  Вы можете проверить статус нового Follower FE, выполнив SHOW PROC '/frontends'\G.

• Удалить Follower FE.

  ALTER SYSTEM DROP FOLLOWER "<fe_host>:<edit_log_port>"[, ...]

• Добавить Observer FE.

  ALTER SYSTEM ADD OBSERVER "<fe_host>:<edit_log_port>"[, ...]

  Вы можете проверить статус нового Observer FE, выполнив SHOW PROC '/frontends'\G.

• Удалить Observer FE.

  ALTER SYSTEM DROP OBSERVER "<fe_host>:<edit_log_port>"[, ...]

Параметр	Обязательный	Описание
fe_host	Да	Имя хоста или IP-адрес экземпляра FE. Используйте значение параметра конфигурации priority_networks, если у вашего экземпляра несколько IP-адресов.
edit_log_port	Да	Порт связи BDB JE узла FE. По умолчанию: 9010.

BE

• Добавить узел BE.

  ALTER SYSTEM ADD BACKEND "<be_host>:<heartbeat_service_port>"[, ...]

  Вы можете проверить статус нового BE, выполнив SHOW BACKENDS.

• Удалить узел BE.

  ПРИМЕЧАНИЕ

  Вы не можете удалить узел BE, на котором хранятся tablet таблиц с одной replica.

  ALTER SYSTEM DROP BACKEND "<be_host>:<heartbeat_service_port>"[, ...]

• Вывести из эксплуатации узел BE.

  ALTER SYSTEM DECOMMISSION BACKEND "<be_host>:<heartbeat_service_port>"[, ...]

  В отличие от удаления узла BE, которое принудительно удаляет его из cluster, вывод из эксплуатации означает безопасное удаление. Это асинхронная операция. При выводе из эксплуатации данные на BE сначала мигрируются на другие BE, а затем BE удаляется из cluster. Загрузка данных и запросы не будут затронуты во время миграции данных. Вы можете проверить успешность операции с помощью SHOW BACKENDS. Если операция прошла успешно, выведенный из эксплуатации BE не будет возвращён. Если операция не удалась, BE останется в сети. Вы можете вручную отменить операцию с помощью CANCEL DECOMMISSION.

Параметр	Обязательный	Описание
be_host	Да	Имя хоста или IP-адрес экземпляра BE. Используйте значение параметра конфигурации priority_networks, если у вашего экземпляра несколько IP-адресов.
heartbeat_service_port	Да	Порт службы heartbeat BE. BE использует этот порт для получения heartbeat от FE. По умолчанию: 9050.

CN

• Добавить узел CN.

  ALTER SYSTEM ADD COMPUTE NODE "<cn_host>:<heartbeat_service_port>"[, ...]

  Вы можете проверить статус нового CN, выполнив SHOW COMPUTE NODES.

• Удалить узел CN.

  ALTER SYSTEM DROP COMPUTE NODE "<cn_host>:<heartbeat_service_port>"[, ...]

ПРИМЕЧАНИЕ

Вы не можете вывести из эксплуатации узел CN с помощью команды ALTER SYSTEM DECOMMISSION.

Параметр	Обязательный	Описание
cn_host	Да	Имя хоста или IP-адрес экземпляра CN. Используйте значение параметра конфигурации priority_networks, если у вашего экземпляра несколько IP-адресов.
heartbeat_service_port	Да	Порт службы heartbeat CN. CN использует этот порт для получения heartbeat от FE. По умолчанию: 9050.

Broker

• Добавить узлы Broker. Вы можете использовать узлы Broker для загрузки данных из HDFS или облачного хранилища в Selena. Для получения дополнительной информации см. Загрузка.

  ALTER SYSTEM ADD BROKER <broker_name> "<broker_host>:<broker_ipc_port>"[, ...]

  Вы можете добавить несколько узлов Broker одной SQL-командой. Каждая пара <broker_host>:<broker_ipc_port> представляет один узел Broker. Они используют общее имя broker_name. Вы можете проверить статус нового узла Broker, выполнив SHOW BROKER.

• Удалить узлы Broker.

ВНИМАНИЕ

Удаление узла Broker прерывает текущие задачи, выполняющиеся на нём.

• Удалить один или несколько узлов Broker с одинаковым broker_name.

  ALTER SYSTEM DROP BROKER <broker_name> "<broker_host>:<broker_ipc_port>"[, ...]

• Удалить все узлы Broker с одинаковым broker_name.

  ALTER SYSTEM DROP ALL BROKER <broker_name>

Параметр	Обязательный	Описание
broker_name	Да	Имя узла(ов) Broker. Несколько узлов Broker могут использовать одно имя.
broker_host	Да	Имя хоста или IP-адрес экземпляра Broker. Используйте значение параметра конфигурации priority_networks, если у вашего экземпляра несколько IP-адресов.
broker_ipc_port	Да	Порт thrift-сервера на узле Broker. Узел Broker использует его для получения запросов от FE или BE. По умолчанию: 8000.

Создание образа

Создать файл образа. Файл образа — это снимок метаданных FE.

ALTER SYSTEM CREATE IMAGE

Создание образа — это асинхронная операция на Leader FE. Вы можете проверить время начала и окончания операции в файле журнала FE fe.log. Запись типа triggering a new checkpoint manually... указывает на начало создания образа, а запись типа finished save image... указывает на завершение создания образа.

Примечания по использованию

• Добавление и удаление узлов FE, BE, CN или Broker являются синхронными операциями. Вы не можете отменить операции удаления узлов.
• Вы не можете удалить узел FE в cluster с одним FE.
• Вы не можете напрямую удалить Leader FE в cluster с несколькими FE. Чтобы удалить его, необходимо сначала перезапустить его. После того как Selena выберет нового Leader FE, вы сможете удалить предыдущего.
• Вы не можете удалить узлы BE, если количество оставшихся узлов BE меньше количества replica данных. Например, если в вашем cluster три узла BE и вы храните данные в трёх replica, вы не можете удалить ни один из узлов BE. А если у вас четыре узла BE и три replica, вы можете удалить один узел BE.
• Разница между удалением и выводом из эксплуатации узла BE заключается в том, что при удалении узла BE Selena принудительно удаляет его из cluster и восстанавливает удалённые tablet после удаления, а при выводе из эксплуатации узла BE Selena сначала мигрирует tablet с выводимого из эксплуатации узла BE на другие, а затем удаляет узел.

Примеры

Пример 1: Добавить Follower FE узел.

ALTER SYSTEM ADD FOLLOWER "x.x.x.x:9010";

Пример 2: Удалить два Observer FE узла одновременно.

ALTER SYSTEM DROP OBSERVER "x.x.x.x:9010","x.x.x.x:9010";

Пример 3: Добавить узел BE.

ALTER SYSTEM ADD BACKEND "x.x.x.x:9050";

Пример 4: Удалить два узла BE одновременно.

ALTER SYSTEM DROP BACKEND "x.x.x.x:9050", "x.x.x.x:9050";

Пример 5: Вывести из эксплуатации два узла BE одновременно.

ALTER SYSTEM DECOMMISSION BACKEND "x.x.x.x:9050", "x.x.x.x:9050";

Пример 6: Добавить два узла Broker с одинаковым broker_name - hdfs.

ALTER SYSTEM ADD BROKER hdfs "x.x.x.x:8000", "x.x.x.x:8000";

Пример 7: Удалить два узла Broker из amazon_s3.

ALTER SYSTEM DROP BROKER amazon_s3 "x.x.x.x:8000", "x.x.x.x:8000";

Пример 8: Удалить все узлы Broker в amazon_s3.

ALTER SYSTEM DROP ALL BROKER amazon_s3;