17.5.2. Команды в MySQL Cluster Management Client

В дополнение к центральному конфигурационному файлу кластером можно также управлять через интерфейс командной строки, доступный через клиент управления ndb_mgm. Это - основной административный интерфейс к рабочему кластеру.

Команды для журналов событий даются в Разделе 17.5.6, "Отчеты события, Сгенерированные в MySQL Cluster"; команды для того, чтобы создать резервные копии и восстановить от них обеспечиваются в Разделе 17.5.3, "Онлайновое Резервное копирование MySQL Cluster".

У клиента управления есть следующие основные команды. В перечислении, которое следует, node_id обозначает или ID узла базы данных или ключевое слово ALL, который указывает, что команда должна быть применена ко всем узлам данных кластера.

HELP

Информация о дисплеях обо всех доступных командах.
SHOW

Информация о дисплеях о состоянии кластера. Возможные значения состояния узла включают UNKNOWN, NO_CONTACT, NOT_STARTED, STARTING, STARTED, SHUTTING_DOWN, и RESTARTING. Вывод от этой команды также указывает, когда кластер находится в однопользовательском режиме (состояние SINGLE USER MODE).
node_id START

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

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

Важный

Чтобы использовать эту команду, чтобы принести узел данных онлайн, узел данных, должно быть, был запущен, используя ndbd --nostart или ndbd -n.
node_id STOP [-a] [-f]

Останавливает данные или узел управления, идентифицированный node_id. Отметьте это ALL STOP работы, чтобы остановить все узлы данных только, и не влияют на узлы управления.

Узел, на который влияет эта команда разъединения от кластера, и его связанный ndbd или процесс ndb_mgmd, завершается.

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

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

Предупреждение

Использование -a опция также отключает проверку безопасности, иначе выполняемую когда STOP вызывается, чтобы обеспечить, чтобы остановка узла не вызвала неполный кластер. Другими словами следует осуществить экстремальную заботу при использовании -a опция с STOP команда, вследствие того, что эта опция позволяет кластеру подвергнуться принудительному завершению работы, потому что у этого больше нет полной копии всех данных, хранивших в NDB.
node_id RESTART [-n] [-i] [-a] [-f]

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

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

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

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

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

Информация о статусе дисплеев для узла данных, идентифицированного node_id (или для всех узлов данных).

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

Выводит на экран отчет типа report-type для узла данных, идентифицированного node_id, или для всего использования узлов данных ALL.

В настоящий момент есть два принятых значения для report-type:
- BackupStatus обеспечивает отчет о состоянии относительно происходящего резервного копирования кластера
- MemoryUsage дисплеи, сколько памяти данных и индексирует память, используются каждым узлом данных как показано в этом примере:
```
ndb_mgm> ALL REPORT
                                MEMORYNode 1: Data usage is 5%(177 32K pages of total 3200)Node 1: Index usage is 0%(108 8K pages of total 12832)Node 2: Data usage is 5%(177 32K pages of total 3200)Node 2: Index usage is 0%(108 8K pages of total 12832)
```
  Эта информация также доступна от ndbinfo.memoryusage таблица.
report-type является нечувствительным к регистру и "нечетким"; для MemoryUsage, можно использовать MEMORY (как показано в предшествующем примере), memory, или даже просто MEM (или mem). Можно сократить BackupStatus подобным способом.
ENTER SINGLE USER MODE node_id

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

В настоящий момент для узлов данных не возможно присоединиться к MySQL Cluster, в то время как это работает в однопользовательском режиме. (Ошибка #20395)
EXIT SINGLE USER MODE

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

Отметить

Возможно использовать EXIT SINGLE USER MODE даже когда не в однопользовательском режиме, хотя команда не имеет никакого эффекта в этом случае.
QUIT, EXIT

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

Эта команда не влияет ни на какие узлы, соединенные с кластером.
SHUTDOWN

Завершает работу всех узлов данных кластера и узлов управления. Чтобы выйти из клиента управления после, это было сделано, использовать EXIT или QUIT.

Эта команда не завершает работу никаких узлов SQL или узлов API, которые соединяются с кластером.
CREATE NODEGROUP nodeid[, nodeid, ...]

Создает новую группу узла MySQL Cluster и заставляет узлы данных присоединяться к этому.

Эта команда используется после добавления новых узлов данных онлайн к MySQL Cluster, и заставляет их присоединяться к новой группе узла и таким образом начинать участвовать полностью в кластере. Команда берет в качестве собственного параметра список разделенных запятой значений ID узла — они - ID узлов, только добавленных, и запускались, которые должны присоединиться к новой группе узла. Число узлов должно быть тем же самым как числом узлов в каждой группе узла, которая уже является частью кластера (у каждой группы узла MySQL Cluster должно быть то же самое число узлов). Другими словами, если у MySQL Cluster есть 2 группы узла 2 узлов данных каждый, то у новой группы узла должно также быть 2 узла данных.

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

Для получения дополнительной информации см. Раздел 17.5.13, "Узлы данных Кластера MySQL Adding Онлайн".
DROP NODEGROUP nodegroup_id

Отбрасывает группу узла MySQL Cluster с данным nodegroup_id.

Эта команда может использоваться, чтобы отбросить группу узла от MySQL Cluster. DROP NODEGROUP берет в качестве собственного параметра групповой ID узла группы узла, чтобы быть отброшенным.

DROP NODEGROUP действия только, чтобы удалить узлы данных в произведенной группе узла от той группы узла. Это не останавливает узлы данных, присваивает их различной группе узла, или удаляет их из конфигурации кластера. Узел данных, который не принадлежит группе узла, обозначается в выводе клиента управления SHOW команда с no nodegroup вместо группового ID узла, как это (обозначенный четкий текст использования):
```
id=3    @10.100.2.67  (5.6.11-ndb-7.3.3, no
                    nodegroup)
```
До MySQL Cluster NDB 7.0.4, SHOW вывод не был обновлен правильно после DROP NODEGROUP. (Ошибка #43413)

DROP NODEGROUP работы только, когда все узлы данных в группе узла, которая будет отброшена, абсолютно пусты от любых табличных данных и табличных определений. С тех пор нет в настоящий момент никакого способа использовать ndb_mgm или mysql клиент, чтобы удалить все данные из определенного узла данных или группы узла, это означает, что команда успешно выполняется только в двух после случаев:
1. После издания CREATE NODEGROUP в ndb_mgm клиенте, но прежде, чем выпустить любого ALTER ONLINE TABLE ... REORGANIZE PARTITION операторы в mysql клиенте.
2. После отбрасывания всех NDBCLUSTER табличное использование DROP TABLE.
  
  TRUNCATE TABLE не работает с этой целью, потому что это удаляет только табличные данные; узлы данных продолжают хранить NDBCLUSTER определение таблицы до a DROP TABLE заявление делается, который заставляет табличные метаданные быть отброшенными.
Для получения дополнительной информации о DROP NODEGROUP, см. Раздел 17.5.13, "Узлы данных Кластера MySQL Adding Онлайн".