21.5.5 ndb_mgm — The NDB Cluster Management Client — MySQL 5.7

21.5.5 ndb_mgm — Клиент управления кластером NDB

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

Для запуска клиента управления необходимо указать имя хоста и номер порта сервера управления:

$> ndb_mgm [host_name [port_num]]

Например:

$> ndb_mgm ndb_mgmd.mysql.com 1186

Значения по умолчанию для имени хоста и номера порта — localhost и 1186 соответственно.

Параметры, которые можно использовать с ndb_mgm, показаны в следующей таблице. Дополнительные описания следуют за таблицей.

Таблица 21.25 Параметры командной строки, используемые с программой ndb_mgm

Таблица 21.25 Параметры командной строки, используемые с программой ndb_mgm
Формат	Описание	Добавлен, устарел или удален
`--character-sets-dir=path`	Директория, содержащая наборы символов	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--connect-retry-delay=#`	Количество секунд ожидания между попытками связи с сервером управления	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--connect-string=connection_string`, `-c connection_string`	То же, что и --ndb-connectstring	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--core-file`	Запись файла core при ошибке; используется при отладке	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--defaults-extra-file=path`	Чтение заданного файла после чтения глобальных файлов	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--defaults-file=path`	Чтение параметров по умолчанию только из заданного файла	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--defaults-group-suffix=string`	Также чтение групп с concat(group, suffix)	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--execute=command`, `-e command`	Выполнение команды и выход	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--help`, `-?`	Вывод справки и выход	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--login-path=path`	Чтение заданного пути из файла входа	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--ndb-connectstring=connection_string`, `-c connection_string`	Установка строки подключения для подключения к ndb_mgmd. Синтаксис: "[nodeid=id;][host=]hostname[:port]". Переопределяет записи в NDB_CONNECTSTRING и my.cnf	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--ndb-mgmd-host=connection_string`, `-c connection_string`	То же, что и --ndb-connectstring	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--ndb-nodeid=#`	Установка идентификатора узла для этого узла, переопределяя любой идентификатор, установленный --ndb-connectstring	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--ndb-optimized-node-selection`	Включение оптимизаций для выбора узлов для транзакций. Включено по умолчанию; используйте --skip-ndb-optimized-node-selection для отключения	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--no-defaults`	Не читать параметры по умолчанию из каких-либо файлов параметров, кроме файла входа	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--print-defaults`	Вывод списка аргументов программы и выход	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--try-reconnect=#`, `-t #`	Устанавливает количество попыток повторного подключения перед отказом; синоним для --connect-retries	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--usage`, `-?`	Вывод справки и выход; то же, что и --help	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)
`--version`, `-V`	Вывод информации о версии и выход	(Поддерживается во всех выпусках NDB, основанных на MySQL 5.7)

--character-sets-dir

Формат командной строки --character-sets-dir=path

Каталог, содержащий кодировки символов.

Формат командной строки	`--character-sets-dir=path`

--connect-retries=#

Формат командной строки	`--connect-retries=#`
Тип	Numeric
Значение по умолчанию	`3`
Минимальное значение	`0`
Максимальное значение	`4294967295`

Этот параметр указывает количество попыток повторного подключения после первой неудачной попытки, прежде чем произойдет отказ (клиент всегда пытается установить подключение хотя бы один раз). Время ожидания для каждой попытки устанавливается с помощью --connect-retry-delay.

Этот параметр является синонимом параметра --try-reconnect, который теперь устарел.

--connect-retry-delay

Формат командной строки	`--connect-retry-delay=#`
Тип	Integer
Значение по умолчанию	`5`
Минимальное значение	`0`
Максимальное значение	`5`

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

--connect-string

Формат командной строки --connect-string=connection_string

Тип String

Значение по умолчанию [none]

То же самое, что и --ndb-connectstring.
--core-file

Формат командной строки --core-file

Записать дамп памяти при ошибке; используется при отладке.
--defaults-extra-file

Формат командной строки --defaults-extra-file=path

Тип String

Значение по умолчанию [none]

Прочитать заданный файл после чтения глобальных файлов.
--defaults-file

Формат командной строки --defaults-file=path

Тип String

Значение по умолчанию [none]

Прочитать параметры по умолчанию только из заданного файла.
--defaults-group-suffix

Формат командной строки --defaults-group-suffix=string

Тип String

Значение по умолчанию [none]

Также читать группы с concat(group, suffix).
--execute=command, -e command

Формат командной строки --execute=command

Этот параметр можно использовать для отправки команды клиенту управления кластером NDB из системной оболочки. Например, любая из следующих команд эквивалентна выполнению SHOW в клиенте управления:
```
$> ndb_mgm -e "SHOW"

$> ndb_mgm --execute="SHOW"
```
Это аналогично тому, как работает параметр --execute или -e с командной строкой mysql. См. Раздел 4.2.2.1, «Использование параметров в командной строке».

Примечание

Если команда клиента управления, передаваемая с помощью этого параметра, содержит какие-либо пробелы, то команда должна быть заключена в кавычки. Можно использовать одинарные или двойные кавычки. Если команда клиента управления не содержит пробелов, кавычки являются необязательными.
--help

Формат командной строки --help

Вывести справку и завершить работу.
--login-path

Формат командной строки --login-path=path

Тип String

Значение по умолчанию [none]

Прочитать заданный путь из файла входа.
--ndb-connectstring

Формат командной строки --ndb-connectstring=connection_string

Тип String

Значение по умолчанию [none]

Установить строку подключения для подключения к ndb_mgmd. Синтаксис: [nodeid=id;][host=]hostname[:port]. Переопределяет записи в NDB_CONNECTSTRING и my.cnf.
--ndb-mgmd-host

Формат командной строки --ndb-mgmd-host=connection_string

Тип String

Значение по умолчанию [none]

То же самое, что и --ndb-connectstring.
--ndb-nodeid

Формат командной строки --ndb-nodeid=#

Тип Integer

Значение по умолчанию [none]

Установить ID узла для этого узла, переопределяя любой ID, установленный с помощью --ndb-connectstring.
--ndb-optimized-node-selection

Формат командной строки --ndb-optimized-node-selection

Включить оптимизацию выбора узлов для транзакций. Включено по умолчанию; используйте --skip-ndb-optimized-node-selection для отключения.
--no-defaults

Формат командной строки --no-defaults

Не читать параметры по умолчанию из любого файла параметров, кроме файла входа.
--print-defaults

Формат командной строки --print-defaults

Распечатать список аргументов программы и завершить работу.

Формат командной строки	`--connect-string=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--core-file`

Формат командной строки	`--defaults-extra-file=path`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--defaults-file=path`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--defaults-group-suffix=string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--execute=command`

Формат командной строки	`--help`

Формат командной строки	`--login-path=path`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-connectstring=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-mgmd-host=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-nodeid=#`
Тип	Integer
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-optimized-node-selection`

Формат командной строки	`--no-defaults`

Формат командной строки	`--print-defaults`

--try-reconnect=number

Формат командной строки	`--try-reconnect=#`
Устарел	Да
Тип (≥ 5.7.10-ndb-7.5.0)	Numeric
Тип	Integer
Значение по умолчанию (≥ 5.7.10-ndb-7.5.0)	`12`
Значение по умолчанию	`3`
Минимальное значение	`0`
Максимальное значение	`4294967295`

Если соединение с сервером управления разорвано, узел пытается переподключиться к нему каждые 5 секунд, пока это не удастся. Используя этот параметр, можно ограничить количество попыток до number, прежде чем отказаться и сообщить об ошибке.

Этот параметр устарел и будет удален в будущей версии. Используйте вместо него --connect-retries.

--usage

Формат командной строки --usage

Отобразить текст справки и завершить; эквивалентно --help.
--version

Формат командной строки --version

Отобразить информацию о версии и завершить.

Формат командной строки	`--usage`

Формат командной строки	`--version`

Дополнительную информацию об использовании ndb_mgm можно найти в разделе 21.6.1, «Команды клиента управления кластером NDB».