Documentation Home
MySQL 8.0 参考手册  / 第 23 章 MySQL NDB Cluster 8.0  / 23.5 NDB 集群程序  /  21.5.5 ndb_mgm — NDB 集群管理客户端

21.5.5 ndb_mgm — NDB 集群管理客户端

运行集群实际上不需要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 一起使用的命令行选项

格式 描述 添加、弃用或删除

--character-sets-dir=path

包含字符集的目录

(支持所有基于 MySQL 5.7 的 NDB 版本)

--connect-retry-delay=#

尝试联系管理服务器之间等待的秒数

(支持所有基于 MySQL 5.7 的 NDB 版本)

--connect-string=connection_string,

-c connection_string

与 --ndb-connectstring 相同

(支持所有基于 MySQL 5.7 的 NDB 版本)

--core-file

写入核心文件出错;用于调试

(支持所有基于 MySQL 5.7 的 NDB 版本)

--defaults-extra-file=path

读取全局文件后读取给定文件

(支持所有基于 MySQL 5.7 的 NDB 版本)

--defaults-file=path

仅从给定文件中读取默认选项

(支持所有基于 MySQL 5.7 的 NDB 版本)

--defaults-group-suffix=string

还阅读带有 concat(group, suffix) 的组

(支持所有基于 MySQL 5.7 的 NDB 版本)

--execute=command,

-e command

执行命令并退出

(支持所有基于 MySQL 5.7 的 NDB 版本)

--help,

-?

显示帮助文本并退出

(支持所有基于 MySQL 5.7 的 NDB 版本)

--login-path=path

从登录文件中读取给定路径

(支持所有基于 MySQL 5.7 的 NDB 版本)

--ndb-connectstring=connection_string,

-c connection_string

设置用于连接到 ndb_mgmd 的连接字符串。语法:“[nodeid=id;][host=]hostname[:port]”。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目

(支持所有基于 MySQL 5.7 的 NDB 版本)

--ndb-mgmd-host=connection_string,

-c connection_string

与 --ndb-connectstring 相同

(支持所有基于 MySQL 5.7 的 NDB 版本)

--ndb-nodeid=#

为此节点设置节点 ID,覆盖 --ndb-connectstring 设置的任何 ID

(支持所有基于 MySQL 5.7 的 NDB 版本)

--ndb-optimized-node-selection

为交易节点的选择启用优化。默认启用;使用 --skip-ndb-optimized-node-selection 禁用

(支持所有基于 MySQL 5.7 的 NDB 版本)

--no-defaults

不要从登录文件以外的任何选项文件中读取默认选项

(支持所有基于 MySQL 5.7 的 NDB 版本)

--print-defaults

打印程序参数列表并退出

(支持所有基于 MySQL 5.7 的 NDB 版本)

--try-reconnect=#,

-t #

设置放弃前重试连接的次数;--connect-retries 的同义词

(支持所有基于 MySQL 5.7 的 NDB 版本)

--usage,

-?

显示帮助文本并退出;与 --help 相同

(支持所有基于 MySQL 5.7 的 NDB 版本)

--version,

-V

显示版本信息并退出

(支持所有基于 MySQL 5.7 的 NDB 版本)


  • --character-sets-dir

    命令行格式 --character-sets-dir=path

    包含字符集的目录。

  • --connect-retries=#

    命令行格式 --connect-retries=#
    类型 数字
    默认值 3
    最小值 0
    最大值 4294967295

    此选项指定在放弃之前第一次尝试重试连接的次数(客户端总是至少尝试连接一次)。每次尝试等待的时间长度使用 设置 --connect-retry-delay

    --try-reconnect此选项与现在已弃用 的选项同义 。

  • --connect-retry-delay

    命令行格式 --connect-retry-delay=#
    类型 整数
    默认值 5
    最小值 0
    最大值 5

    尝试联系管理服务器之间等待的秒数。

  • --connect-string

    命令行格式 --connect-string=connection_string
    类型 细绳
    默认值 [none]

    与 相同--ndb-connectstring

  • --core-file

    命令行格式 --core-file

    写入核心文件出错;在调试中使用。

  • --defaults-extra-file

    命令行格式 --defaults-extra-file=path
    类型 细绳
    默认值 [none]

    读取全局文件后读取给定文件。

  • --defaults-file

    命令行格式 --defaults-file=path
    类型 细绳
    默认值 [none]

    仅从给定文件中读取默认选项。

  • --defaults-group-suffix

    命令行格式 --defaults-group-suffix=string
    类型 细绳
    默认值 [none]

    还可以阅读带有 concat(group, suffix) 的组。

  • --execute=command, -e command

    命令行格式 --execute=command

    此选项可用于从系统 shell 向 NDB Cluster 管理客户端发送命令。例如,以下任一项都相当于 SHOW在管理客户端中执行:

    $> ndb_mgm -e "SHOW"
    
    $> ndb_mgm --execute="SHOW"

    这类似于 --executeor -e选项如何与 mysql命令行客户端一起工作。请参阅 第 4.2.2.1 节,“在命令行上使用选项”

    笔记

    如果要使用此选项传递的管理客户端命令包含任何空格字符,则该命令 必须用引号引起来。可以使用单引号或双引号。如果管理客户端命令不包含空格字符,则引号是可选的。

  • --help

    命令行格式 --help

    显示帮助文本并退出。

  • --login-path

    命令行格式 --login-path=path
    类型 细绳
    默认值 [none]

    从登录文件中读取给定路径。

  • --ndb-connectstring

    命令行格式 --ndb-connectstring=connection_string
    类型 细绳
    默认值 [none]

    设置用于连接到 ndb_mgmd的连接字符串。语法:[ ][ ] [ ]。覆盖 和中的条目。 nodeid=id;host=hostname:portNDB_CONNECTSTRINGmy.cnf

  • --ndb-mgmd-host

    命令行格式 --ndb-mgmd-host=connection_string
    类型 细绳
    默认值 [none]

    与 相同--ndb-connectstring

  • --ndb-nodeid

    命令行格式 --ndb-nodeid=#
    类型 整数
    默认值 [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

    打印程序参数列表并退出。

  • --try-reconnect=number

    命令行格式 --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

    命令行格式 --usage

    显示帮助文本并退出;一样 --help

  • --version

    命令行格式 --version

    显示版本信息并退出。

有关使用ndb_mgm的其他信息 可以在 第 21.6.1 节,“NDB Cluster Management Client 中的命令”中找到。