运行集群实际上不需要ndb_mgm管理客户端进程 。它的价值在于提供一组用于检查集群状态、启动备份和执行其他管理功能的命令。管理客户端使用 C API 访问管理服务器。高级用户还可以使用此 API 对专用管理进程进行编程,以执行类似于ndb_mgm执行的任务。
要启动管理客户端,需要提供管理服务器的主机名和端口号:
$> ndb_mgm [host_name [port_num]]例如:
$> ndb_mgm ndb_mgmd.mysql.com 1186
默认主机名和端口号分别为
localhost和 1186。
下表显示了 可以与ndb_mgm一起使用的选项。表后有其他说明。
表 21.25 与程序 ndb_mgm 一起使用的命令行选项
| 格式 | 描述 | 添加、弃用或删除 |
|---|---|---|
| 包含字符集的目录 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 尝试联系管理服务器之间等待的秒数 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 与 --ndb-connectstring 相同 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 写入核心文件出错;用于调试 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 读取全局文件后读取给定文件 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 仅从给定文件中读取默认选项 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 还阅读带有 concat(group, suffix) 的组 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 执行命令并退出 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 显示帮助文本并退出 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 从登录文件中读取给定路径 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 设置用于连接到 ndb_mgmd 的连接字符串。语法:“[nodeid=id;][host=]hostname[:port]”。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 与 --ndb-connectstring 相同 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 为此节点设置节点 ID,覆盖 --ndb-connectstring 设置的任何 ID | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 为交易节点的选择启用优化。默认启用;使用 --skip-ndb-optimized-node-selection 禁用 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 不要从登录文件以外的任何选项文件中读取默认选项 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 打印程序参数列表并退出 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 设置放弃前重试连接的次数;--connect-retries 的同义词 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 显示帮助文本并退出;与 --help 相同 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
|
| 显示版本信息并退出 | (支持所有基于 MySQL 5.7 的 NDB 版本) |
-
命令行格式 --character-sets-dir=path包含字符集的目录。
-
命令行格式 --connect-retries=#类型 数字 默认值 3最小值 0最大值 4294967295此选项指定在放弃之前第一次尝试重试连接的次数(客户端总是至少尝试连接一次)。每次尝试等待的时间长度使用 设置
--connect-retry-delay。--try-reconnect此选项与现在已弃用 的选项同义 。 -
命令行格式 --connect-retry-delay=#类型 整数 默认值 5最小值 0最大值 5尝试联系管理服务器之间等待的秒数。
-
命令行格式 --connect-string=connection_string类型 细绳 默认值 [none]与 相同
--ndb-connectstring。 -
命令行格式 --core-file写入核心文件出错;在调试中使用。
-
命令行格式 --defaults-extra-file=path类型 细绳 默认值 [none]读取全局文件后读取给定文件。
-
命令行格式 --defaults-file=path类型 细绳 默认值 [none]仅从给定文件中读取默认选项。
-
命令行格式 --defaults-group-suffix=string类型 细绳 默认值 [none]还可以阅读带有 concat(group, suffix) 的组。
-
命令行格式 --execute=command此选项可用于从系统 shell 向 NDB Cluster 管理客户端发送命令。例如,以下任一项都相当于
SHOW在管理客户端中执行:$> ndb_mgm -e "SHOW" $> ndb_mgm --execute="SHOW"这类似于
--executeor-e选项如何与 mysql命令行客户端一起工作。请参阅 第 4.2.2.1 节,“在命令行上使用选项”。笔记如果要使用此选项传递的管理客户端命令包含任何空格字符,则该命令 必须用引号引起来。可以使用单引号或双引号。如果管理客户端命令不包含空格字符,则引号是可选的。
-
命令行格式 --help显示帮助文本并退出。
-
命令行格式 --login-path=path类型 细绳 默认值 [none]从登录文件中读取给定路径。
-
命令行格式 --ndb-connectstring=connection_string类型 细绳 默认值 [none]设置用于连接到 ndb_mgmd的连接字符串。语法:[ ][ ] [ ]。覆盖 和中的条目。
nodeid=id;host=hostname:portNDB_CONNECTSTRINGmy.cnf -
命令行格式 --ndb-mgmd-host=connection_string类型 细绳 默认值 [none]与 相同
--ndb-connectstring。 -
命令行格式 --ndb-nodeid=#类型 整数 默认值 [none]为此节点设置节点 ID,覆盖由 设置的任何 ID
--ndb-connectstring。 --ndb-optimized-node-selection命令行格式 --ndb-optimized-node-selection为交易节点的选择启用优化。默认启用;用于
--skip-ndb-optimized-node-selection禁用。-
命令行格式 --no-defaults不要从登录文件以外的任何选项文件中读取默认选项。
-
命令行格式 --print-defaults打印程序参数列表并退出。
-
命令行格式 --try-reconnect=#弃用 是的 类型 (≥ 5.7.10-ndb-7.5.0) 数字 类型 整数 默认值(≥ 5.7.10-ndb-7.5.0) 12默认值 3最小值 0最大值 4294967295如果与管理服务器的连接中断,该节点将每 5 秒尝试重新连接一次,直到成功。
number通过使用此选项,可以限制在放弃和报告错误之前 的尝试次数。此选项已弃用,并会在未来版本中删除。使用
--connect-retries, 代替。 -
命令行格式 --usage显示帮助文本并退出;一样
--help。 -
命令行格式 --version显示版本信息并退出。
有关使用ndb_mgm的其他信息 可以在 第 21.6.1 节,“NDB Cluster Management Client 中的命令”中找到。