CONNECT connection-string

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

CREATE NODEGROUP nodeid[, nodeid, ...]

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

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

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

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

DROP NODEGROUP nodegroup_id

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

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

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

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

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

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

ENTER SINGLE USER MODE node_id

Переходит в режим работы с одним пользователем, в котором только сервер 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-8.4.5 ndb-8.4.5, single user mode, Nodegroup: 0, *)
id=6    @127.0.0.1  (mysql-8.4.5 ndb-8.4.5, single user mode, Nodegroup: 0)

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

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

EXIT SINGLE USER MODE

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

HELP

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

node_id NODELOG DEBUG {ON|OFF}

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

PROMPT [prompt]

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

prompt не должно быть заключено в кавычки (если вы не хотите, чтобы подсказка включала кавычки). В отличие от случая с клиентом mysql, специальные последовательности символов и экранирование не распознаются. Если вызов осуществляется без аргумента, команда сбрасывает подсказку до значения по умолчанию (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 не обрезаются. Конец строки удаляется.

QUIT, EXIT

Прерывает работу клиента управления.

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

node_id REPORT report-type

Отображает отчет типа 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-8.4.5 ndb-8.4.5, Nodegroup: 0, *)
id=6    @198.51.100.20  (mysql-8.4.5 ndb-8.4.5, Nodegroup: 0)
id=7    @198.51.100.30  (mysql-8.4.5 ndb-8.4.5, Nodegroup: 1)
id=8    @198.51.100.40  (mysql-8.4.5 ndb-8.4.5, Nodegroup: 1)

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

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

Вывод этой команды также указывает, когда кластер находится в режиме single user (см. описание команды ENTER SINGLE USER MODE, а также Раздел 25.6.6, «Режим single user кластера NDB»). Он также указывает, какой 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.

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

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».