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