Documentation Home
MySQL 8.0 参考手册
MySQL 8.0 参考手册  / 第 23 章 MySQL NDB Cluster 8.0  / 23.5 NDB 集群程序  /  23.5.30 ndb_waiter — 等待 NDB Cluster 达到给定状态

23.5.30 ndb_waiter — 等待 NDB Cluster 达到给定状态

ndb_waiter重复（每 100 毫秒）打印出所有集群数据节点的状态，直到集群达到给定状态或 --timeout超过限制，然后退出。默认情况下，它等待集群达到 STARTED所有节点都已启动并连接到集群的状态。这可以使用--no-contact和 --not-started选项覆盖。

该实用程序报告的节点状态如下：

  • NO_CONTACT: 无法联系到该节点。

  • UNKNOWN：可以联系到节点，但其状态尚不清楚。通常，这意味着节点已从管理服务器接收到 START或 RESTART命令，但尚未对其执行操作。

  • NOT_STARTED：节点已停止，但仍与集群保持联系。RESTART使用管理客户端的命令 重新启动节点时可以看到这一点 。

  • STARTING: 节点的 ndbd进程已经启动，但是节点还没有加入集群。

  • STARTED：节点可操作，并已加入集群。

  • SHUTTING_DOWN: 节点正在关闭。

  • SINGLE USER MODE：当集群处于单用户模式时，将显示所有集群数据节点。

下表显示了 可以与ndb_waiter一起使用的选项。表后有其他说明。

表 23.51 与程序 ndb_waiter 一起使用的命令行选项

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

--character-sets-dir=path

包含字符集的目录

删除：8.0.31

--connect-retries=#

放弃前重试连接的次数

删除：8.0.31

--connect-retry-delay=#

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

删除：8.0.31

--connect-string=connection_string,

-c connection_string

与 --ndb-connectstring 相同

（支持所有基于 MySQL 8.0 的 NDB 版本）

--core-file

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

删除：8.0.31

--defaults-extra-file=path

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

（支持所有基于 MySQL 8.0 的 NDB 版本）

--defaults-file=path

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

（支持所有基于 MySQL 8.0 的 NDB 版本）

--defaults-group-suffix=string

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

（支持所有基于 MySQL 8.0 的 NDB 版本）

--help,

-?

显示帮助文本并退出

（支持所有基于 MySQL 8.0 的 NDB 版本）

--login-path=path

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

（支持所有基于 MySQL 8.0 的 NDB 版本）

--ndb-connectstring=connection_string,

-c connection_string

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

（支持所有基于 MySQL 8.0 的 NDB 版本）

--ndb-mgmd-host=connection_string,

-c connection_string

与 --ndb-connectstring 相同

（支持所有基于 MySQL 8.0 的 NDB 版本）

--ndb-nodeid=#

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

删除：8.0.31

--ndb-optimized-node-selection

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

删除：8.0.31

--no-contact,

-n

等待集群达到 NO CONTACT 状态

（支持所有基于 MySQL 8.0 的 NDB 版本）

--no-defaults

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

（支持所有基于 MySQL 8.0 的 NDB 版本）

--not-started

等待集群达到 NOT STARTED 状态

（支持所有基于 MySQL 8.0 的 NDB 版本）

--nowait-nodes=list

不等待的节点列表

（支持所有基于 MySQL 8.0 的 NDB 版本）

--print-defaults

打印程序参数列表并退出

（支持所有基于 MySQL 8.0 的 NDB 版本）

--single-user

等待集群进入单用户模式

（支持所有基于 MySQL 8.0 的 NDB 版本）

--timeout=#,

-t #

等待这么多秒，然后退出集群是否已达到所需状态

（支持所有基于 MySQL 8.0 的 NDB 版本）

--usage,

-?

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

（支持所有基于 MySQL 8.0 的 NDB 版本）

--version,

-V

显示版本信息并退出

（支持所有基于 MySQL 8.0 的 NDB 版本）

--wait-nodes=list,

-w list

要等待的节点列表

（支持所有基于 MySQL 8.0 的 NDB 版本）


用法

ndb_waiter [-c connection_string]

附加选项

  • --character-sets-dir

    命令行格式 --character-sets-dir=path
    删除 8.0.31

    包含字符集的目录。

  • --connect-retries

    命令行格式 --connect-retries=#
    删除 8.0.31
    类型 整数
    默认值 12
    最小值 0
    最大值 12

    放弃前重试连接的次数。

  • --connect-retry-delay

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

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

  • --connect-string

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

    与 相同 --ndb-connectstring。

  • --core-file

    命令行格式 --core-file
    删除 8.0.31

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

  • --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) 的组。

  • --login-path

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

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

  • --help

    命令行格式 --help

    显示帮助文本并退出。

  • --ndb-connectstring

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

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

  • --ndb-mgmd-host

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

    与 - 相同ndb-connectstring。

  • --ndb-nodeid

    命令行格式 --ndb-nodeid=#
    删除 8.0.31
    类型 整数
    默认值 [none]

    为此节点设置节点 ID，覆盖由 设置的任何 ID --ndb-connectstring。

  • --ndb-optimized-node-selection

    命令行格式 --ndb-optimized-node-selection
    删除 8.0.31

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

  • --no-contact, -n

    ndb_waiter 不是等待STARTED状态， 而是继续运行，直到集群达到状态才退出。 NO_CONTACT

  • --no-defaults

    命令行格式 --no-defaults

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

  • --not-started

    ndb_waiter 不是等待STARTED状态， 而是继续运行，直到集群达到状态才退出。 NOT_STARTED

  • --nowait-nodes=list

    使用此选项时，ndb_waiter不会等待列出 ID 的节点。该列表以逗号分隔；范围可以用破折号表示，如下所示： 

    $> ndb_waiter --nowait-nodes=1,3,7-9
    重要的

    不要将此选项与选项一起使用--wait-nodes 。

  • --print-defaults

    命令行格式 --print-defaults

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

  • --timeout=seconds, -t seconds

    是时候等待了。如果在此秒数内未达到所需状态，程序将退出。默认值为 120 秒（1200 个报告周期）。

  • --single-user

    该程序等待集群进入单用户模式。

  • --usage

    命令行格式 --usage

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

  • --version

    命令行格式 --version

    显示版本信息并退出。

  • --wait-nodes=list, -w list

    使用此选项时，ndb_waiter 仅等待列出 ID 的节点。该列表以逗号分隔；范围可以用破折号表示，如下所示： 

    $> ndb_waiter --wait-nodes=2,4-6,10
    重要的

    不要将此选项与选项一起使用--nowait-nodes 。

示例输出。 此处显示的是针对 4 节点集群运行时ndb_waiter 的输出 ，其中两个节点已关闭，然后手动重新启动。...省略 重复的报告（用 表示）。

$> ./ndb_waiter -c localhost

Connecting to mgmsrv at (localhost)
State node 1 STARTED
State node 2 NO_CONTACT
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 UNKNOWN
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 NO_CONTACT
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 UNKNOWN
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTING
State node 3 STARTED
State node 4 STARTING
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTED
State node 3 STARTED
State node 4 STARTING
Waiting for cluster enter state STARTED

...

State node 1 STARTED
State node 2 STARTED
State node 3 STARTED
State node 4 STARTED
Waiting for cluster enter state STARTED
笔记

如果未指定连接字符串，则 ndb_waiter 会尝试连接到管理localhost，并报告 Connecting to mgmsrv at (null)。

在 NDB 8.0.20 之前 ，由于对 测试库的不必要依赖，该程序在运行完成后打印。这种依赖性已被移除，从而消除了无关的输出。 NDBT_ProgramExit - statusNDBT