Подключение к серверу управления

Подключается к серверу управления, указанному в строке подключения. Если клиент уже подключен к этому серверу, клиент переподключается.

Создание новой группы узлов

Создаёт новую группу узлов NDB кластера и заставляет узлы данных присоединиться к ней.

Эта команда используется после добавления новых узлов данных в NDB кластер онлайн, и заставляет их присоединиться к новой группе узлов, тем самым, начать полностью участвовать в кластере. Команда принимает в качестве единственного параметра список идентификаторов узлов, разделённых запятыми — это идентификаторы только что добавленных и запущенных узлов, которые должны присоединиться к новой группе узлов. Список не должен содержать дублирующих идентификаторов; наличие дубликатов приводит к ошибке команды. Количество узлов в списке должно быть таким же, как и количество узлов в каждой группе узлов, которая уже является частью кластера (каждая группа узлов NDB кластера должна иметь одинаковое количество узлов). Другими словами, если NDB кластер состоит из 2 групп узлов, каждая из которых имеет 2 узла данных, то новая группа узлов также должна иметь 2 узла данных.

Идентификатор группы узлов новой группы узлов, созданной этой командой, определяется автоматически и всегда является следующим по порядку неиспользованным идентификатором группы узлов в кластере; его нельзя установить вручную.

Для получения дополнительной информации см. Раздел 25.6.7, «Добавление узлов данных NDB кластера онлайн».

Удаление группы узлов

Удаляет группу узлов NDB кластера с заданным nodegroup_id.

Эта команда может быть использована для удаления группы узлов из NDB кластера. DROP NODEGROUP принимает в качестве единственного аргумента идентификатор группы узлов группы узлов, подлежащей удалению.

DROP NODEGROUP выполняет только удаление узлов данных в затронутой группе узлов из этой группы узлов. Она не останавливает узлы данных, не назначает их в другую группу узлов и не удаляет их из конфигурации кластера. Узел данных, не принадлежащий группе узлов, указывается в выводе клиента управления SHOW командой с no nodegroup вместо идентификатора группы узлов, например так (указано жирным шрифтом):

id=3    @10.100.2.67  (9.2.0-ndb-9.2.0, no nodegroup)

DROP NODEGROUP работает только в том случае, если все узлы данных в подлежащей удалению группе узлов полностью пусты от данных таблиц и определений таблиц. Поскольку в настоящее время нет способа с помощью ndb_mgm или клиента mysql удалить все данные с конкретного узла данных или группы узлов, это означает, что команда выполняется только в двух следующих случаях:

Для получения дополнительной информации о DROP NODEGROUP см. Раздел 25.6.7, «Добавление узлов данных NDB кластера онлайн».

Переход в режим одного пользователя

Переходит в режим одного пользователя, в котором только сервер MySQL, идентифицированный по идентификатору узла node_id, имеет разрешение на доступ к базе данных.

Клиент ndb_mgm предоставляет ясное подтверждение того, что эта команда была выдана и принята, как показано здесь:

ndb_mgm> ENTER SINGLE USER MODE 100
Single user mode entered
Access is granted for API node 100 only.

Кроме того, узел API или SQL, имеющий эксклюзивный доступ при работе в режиме одного пользователя, указывается в выводе команды SHOW, например так:

ndb_mgm> SHOW
Cluster Configuration
---------------------
[ndbd(NDB)]     2 node(s)
id=5    @127.0.0.1  (mysql-9.2.0 ndb-9.2.0, single user mode, Nodegroup: 0, *)
id=6    @127.0.0.1  (mysql-9.2.0 ndb-9.2.0, single user mode, Nodegroup: 0)

[ndb_mgmd(MGM)] 1 node(s)
id=50   @127.0.0.1  (mysql-9.2.0 ndb-9.2.0)

[mysqld(API)]   2 node(s)
id=100  @127.0.0.1  (mysql-9.2.0 ndb-9.2.0, allowed single user)
id=101 (not connected, accepting connect from any host)

Выход из режима одного пользователя

Выходит из режима одного пользователя, позволяя всем узлам SQL (то есть всем запущенным процессам mysqld) получить доступ к базе данных.

Помощь

Отображает информацию обо всех доступных командах.

Включение/отключение отладки в журнале узла

Включает или отключает отладку в журнале узла, как если бы затронутый узел данных или узлы были запущены с опцией --verbose. NODELOG DEBUG ON включает отладку; NODELOG DEBUG OFF выключает отладку.

Изменение подсказки

Изменяет подсказку, отображаемую клиентом ndb_mgm, на строковый литерал prompt.

prompt не следует заключать в кавычки (если вы не хотите, чтобы подсказка включала кавычки). В отличие от клиента mysql, специальные последовательности символов и escapes не распознаются. Если вызывается без аргумента, команда сбрасывает подсказку до значения по умолчанию (ndb_mgm>).

Некоторые примеры показаны здесь:

ndb_mgm> PROMPT mgm#1:
mgm#1: SHOW
Cluster Configuration
...
mgm#1: PROMPT mymgm >
mymgm > PROMPT 'mymgm:'
'mymgm:' PROMPT  mymgm:
mymgm: PROMPT
ndb_mgm> EXIT
$>

Обратите внимание, что ведущие пробелы и пробелы внутри строки prompt не обрезаются. Конечные пробелы удаляются.

Выход из клиента управления, Выход из клиента управления

Завершает работу клиента управления.

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

Отчёт

Отображает отчёт типа report-type для узла данных, идентифицированного по node_id, или для всех узлов данных с использованием ALL.

В настоящее время для report-type принимаются три значения:

report-type не чувствительно к регистру и “размыто”; для MemoryUsage можно использовать MEMORY (как показано в предыдущем примере), memory или даже просто MEM (или mem). Можно сократить BackupStatus аналогичным образом.

node_id RESTART [-n] [-i] [-a] [-f]

Перезапускает узел данных, идентифицированный значением node_id (или все узлы данных).

Использование опции -i с опцией RESTART заставляет узел данных выполнить начальный перезапуск; то есть файловая система узла удаляется и воссоздаётся. Эффект такой же, как при остановке процесса узла данных и его последующем запуске с помощью ndbd --initial из командной строки системы.

Использование опции -n приводит к перезапуску процесса узла данных, но сам узел данных не включается в работу до тех пор, пока не будет выполнена соответствующая команда START. Эффект этой опции такой же, как при остановке узла данных и его последующем запуске с помощью ndbd --nostart или ndbd -n из командной строки системы.

Использование -a приводит к прерыванию всех текущих транзакций, зависящих от этого узла. Проверка GCP не выполняется при повторном подключении узла к кластеру.

Обычно RESTART завершается неудачей, если отключение узла приведёт к неполному кластеру. Опция -f вынуждает узел перезапуститься без проверки этого. Если эта опция используется, и результатом является неполный кластер, весь кластер перезапускается.

SHOW

Отображает основную информацию о кластере и узлах кластера. Для всех узлов вывод включает идентификатор узла, тип и NDB версию программного обеспечения. Если узел подключен, также отображается его IP-адрес; в противном случае вывод показывает not connected, accepting connect from ip_address, при этом any host используется для узлов, которые могут подключаться с любого адреса.

Кроме того, для узлов данных вывод включает starting, если узел ещё не запущен, и показывает группу узлов, членом которой является данный узел. Если узел данных работает как мастер-узел, это обозначается звёздочкой (*).

Рассмотрим кластер, файл конфигурации которого содержит указанную здесь информацию (возможные дополнительные настройки опушены для ясности):

[ndbd default]
DataMemory= 128G
NoOfReplicas= 2

[ndb_mgmd]
NodeId=50
HostName=198.51.100.150

[ndbd]
NodeId=5
HostName=198.51.100.10
DataDir=/var/lib/mysql-cluster

[ndbd]
NodeId=6
HostName=198.51.100.20
DataDir=/var/lib/mysql-cluster

[ndbd]
NodeId=7
HostName=198.51.100.30
DataDir=/var/lib/mysql-cluster

[ndbd]
NodeId=8
HostName=198.51.100.40
DataDir=/var/lib/mysql-cluster

[mysqld]
NodeId=100
HostName=198.51.100.100

[api]
NodeId=101

После запуска этого кластера (включая один SQL-узел) SHOW отображает следующий вывод:

ndb_mgm> SHOW
Connected to Management Server at: localhost:1186 (using cleartext)
Cluster Configuration
---------------------
[ndbd(NDB)]     4 node(s)
id=5    @198.51.100.10  (mysql-9.2.0 ndb-9.2.0, Nodegroup: 0, *)
id=6    @198.51.100.20  (mysql-9.2.0 ndb-9.2.0, Nodegroup: 0)
id=7    @198.51.100.30  (mysql-9.2.0 ndb-9.2.0, Nodegroup: 1)
id=8    @198.51.100.40  (mysql-9.2.0 ndb-9.2.0, Nodegroup: 1)

[ndb_mgmd(MGM)] 1 node(s)
id=50   @198.51.100.150  (mysql-9.2.0 ndb-9.2.0)

[mysqld(API)]   2 node(s)
id=100  @198.51.100.100  (mysql-9.2.0 ndb-9.2.0)
id=101 (not connected, accepting connect from any host)

Вывод этой команды также указывает, когда кластер находится в режиме одного пользователя (см. описание команды ENTER SINGLE USER MODE, а также Раздел 25.6.6, «Режим одного пользователя NDB Cluster»). Он также указывает, какой API- или SQL-узел имеет исключительный доступ, когда этот режим активен.

SHUTDOWN

Останавливает все узлы данных и узлы управления кластера. Для выхода из клиента управления после этого используйте EXIT или QUIT.

Эта команда не останавливает подключенные к кластеру узлы SQL или API.

node_id START

Включает в работу узел данных, идентифицированный значением node_id (или все узлы данных).

ALL START работает только с узлами данных и не влияет на узлы управления.

node_id STATUS

Отображает информацию о состоянии узла данных, идентифицированного значением node_id (или всех узлов данных).

Возможные значения состояния узла включают UNKNOWN, NO_CONTACT, NOT_STARTED, STARTING, STARTED, SHUTTING_DOWN и RESTARTING.

Вывод этой команды также указывает, когда кластер находится в режиме одного пользователя.

node_id STOP [-a] [-f]

Останавливает узел данных или управления, идентифицированный значением node_id.

Затронутый этой командой узел отключается от кластера, и связанный с ним процесс ndbd или ndb_mgmd завершается.

Опция -a заставляет узел остановиться немедленно, не дожидаясь завершения каких-либо ожидающих транзакций.

Обычно STOP завершается неудачей, если результатом является неполный кластер. Опция -f принуждает узел к завершению работы без проверки этого. Если эта опция используется, и результатом является неполный кластер, кластер немедленно завершается.

TLS INFO

Отображает информацию о TLS кластера, такую как использование TLS текущим подключением, сертификаты TLS, которые в настоящее время известны узлу управления, и количество подключений узла управления, подключений, обновленных до TLS, и неудач авторизации. Пример вывода показан здесь:

ndb_mgm> TLS INFO

Session ID:          1
Peer address:        127.0.0.1
Certificate name:    NDB Management Node Jun 2023
Certificate serial:  B5:23:8F:D1:11:85:E5:93:ED
Certificate expires: 23-Nov-2023

Server statistics since restart
Total accepted connections:        6
Total connections upgraded to TLS: 2
Current connections:               3
Current connections using TLS:     2
Authorization failures:            0

ndb_mgm>

Дополнительную информацию см. в Разделе 25.6.15, «Шифрование TLS для связи NDB Cluster».