CONNECT connection-string

将客户端连接到由连接字符串指定的管理服务器。如果客户端已经连接到这个服务器，客户端重新连接。

CREATE NODEGROUP nodeid[, nodeid, ...]

创建一个新的 NDB 集群节点组，并使数据节点加入该组。

这个命令在在线添加新数据节点到 NDB 集群后使用，用于使它们加入新的节点组并开始完全参与集群。命令的唯一参数是逗号分隔的节点 ID 列表，这些 ID 是刚添加和启动的节点的 ID，以及要加入新的节点组的节点 ID。列表中不能包含重复的 ID；出现任何 duplicates 将导致命令返回错误。列表中的节点数必须与集群中已经存在的每个节点组中的节点数相同（每个 NDB 集群节点组都必须有相同数量的节点）。换言之，如果 NDB 集群由 2 个节点组，每个节点组都有 2 个数据节点，那么新的节点组也必须有 2 个数据节点。

新创建的节点组的节点组 ID 由这个命令自动确定，总是集群中下一个未使用的节点组 ID；不能手动设置它。

更多信息，请见第 25.6.7 节，“在线添加 NDB 集群数据节点”。

DROP NODEGROUP nodegroup_id

删除具有给定nodegroup_id的 NDB 集群节点组。

可以使用该命令从 NDB 集群中删除一个节点组。DROP NODEGROUP 只需要一个参数，即要删除的节点组 ID。

DROP NODEGROUP 只是将数据节点从受影响的节点组中移除，不会停止数据节点、将它们分配到另一个节点组或从集群配置中删除。没有属于节点组的数据节点在管理客户端SHOW命令的输出中被表示为no nodegroup，例如：

id=3    @10.100.2.67  (8.4.0-ndb-8.4.0, no nodegroup)

DROP NODEGROUP 只能在要删除的节点组中的所有数据节点完全为空时工作，因为当前没有使用ndb_mgm或mysql客户端可以从特定的数据节点或节点组中删除所有数据，这意味着该命令只能在以下两个情况下成功：

关于Section 25.6.7, “Adding NDB Cluster Data Nodes Online”的更多信息，请查看。

ENTER SINGLE USER MODE node_ id

进入单用户模式，仅允许 MySQL 服务器（identified by the node ID node_ id）访问数据库。

NDB 集群管理客户端ndb_mgm提供了明确的确认，这个命令已经被发出并生效，如下所示：

ndb_mgm> ENTER SINGLE USER MODE 100
Single user mode entered
Access is granted for API node 100 only.

此外，在单用户模式下拥有独占访问权限的 API 或 SQL 节点在 SHOW 命令的输出中被指示，如下所示：

ndb_mgm> SHOW
Cluster Configuration
---------------------
[ndbd(NDB)]     2 node(s)
id=5    @127.0.0.1  (mysql-8.4.0 ndb-8.4.0, single user mode, Nodegroup: 0, *)
id=6    @127.0.0.1  (mysql-8.4.0 ndb-8.4.0, single user mode, Nodegroup: 0)

[ndb_mgmd(MGM)] 1 node(s)
id=50   @127.0.0.1  (mysql-8.4.0 ndb-8.4.0)

[mysqld(API)]   2 node(s)
id=100  @127.0.0.1  (mysql-8.4.0 ndb-8.4.0, allowed single user)
id=101 (not connected, accepting connect from any host)

EXIT SINGLE USER MODE

退出单用户模式，启用所有 SQL 节点（即所有运行 mysqld 进程）的访问数据库。

HELP

显示所有可用命令的信息。

node_id 节点日志调试 {ON|OFF}

在节点日志中启用或禁用调试记录，类似于使用--verbose选项启动数据节点。节点日志调试 ON启用调试记录，节点日志调试 OFF禁用调试记录。

PROMPT [prompt]

将ndb_mgm的提示字符串更改为字面量prompt。

prompt不应该被引号括起来（除非您想让提示包含引号）。与mysql客户端不同，特殊字符序列和转义序列不被识别。如果没有提供参数，该命令将重置提示到默认值（ndb_mgm>）。

以下是一些示例：

ndb_mgm> PROMPT mgm#1:
mgm#1: SHOW
Cluster Configuration
...
mgm#1: PROMPT mymgm >
mymgm > PROMPT 'mymgm:'
'mymgm:' PROMPT  mymgm:
mymgm: PROMPT
ndb_mgm> EXIT
$>

注意，leading spaces 和在prompt字符串中的空格不被截断。尾部空格将被删除。

QUIT, EXIT

终止管理客户端。

这个命令不会影响已连接到集群的任何节点。

node_id REPORT report_type

显示类型为report_type的报告，对于数据节点node_id进行标识，或者使用ALL对所有数据节点进行报告。

当前，有三个被接受的值为report_type:

report-type 是不区分大小写的，且可以使用“模糊”；对于 MemoryUsage，您可以使用 MEMORY（如前一例所示），memory，或甚至简单地使用 MEM（或 mem）。您也可以类似地简化 BackupStatus。

node_ id RESTART [-n] [-i] [-a] [-f]

重启由 node_id 标识的数据节点（或所有数据节点）。

使用 -i 选项与 RESTART 可以使数据节点执行初始重启，即文件系统被删除并重新创建。该效果与停止数据节点进程，然后使用 ndbd --initial 从系统shell启动数据节点相同。

使用-n选项将数据节点进程重新启动，但是直到发出适当的START命令，数据节点才实际上线。该选项的效果与使用ndbd--nostart或ndbd-n从系统shell停止和重新启动数据节点相同。

使用-a选项将当前依赖于该节点的所有事务都中止。节点重新加入集群时不执行GCP检查。

通常，RESTART在将节点offline时失败。如果使用-f选项强制节点重新启动，而结果是一个不完整的集群，则整个集群将重新启动。

SHOW

显示集群和节点的基本信息。对于所有节点，输出包括节点的ID、类型和NDB软件版本。如果节点已连接，则还显示其IP地址；否则，输出将显示not connected, accepting connect from ip_address，其中any host用于允许从任何地址连接的节点。

此外，对于数据节点，输出还包括starting，如果节点尚未启动，并显示该节点所属的组。如果数据节点正在充当主节点，这将以星号(*)表示。

考虑一个配置文件包含以下信息的集群（可能省略其他设置以提高清晰度）：

[ndbd default]
DataMemory= 128G
NoOfReplicas= 2

[ndb_mgmd]
NodeId=50
HostName=198.51.100.150

[ndbd]
NodeId=5
HostName=198.51.100.10
DataDir=/var/lib/mysql-cluster

[ndbd]
NodeId=6
HostName=198.51.100.20
DataDir=/var/lib/mysql-cluster

[ndbd]
NodeId=7
HostName=198.51.100.30
DataDir=/var/lib/mysql-cluster

[ndbd]
NodeId=8
HostName=198.51.100.40
DataDir=/var/lib/mysql-cluster

[mysqld]
NodeId=100
HostName=198.51.100.100

[api]
NodeId=101

在这个集群（包括一个SQL节点）启动后，SHOW命令显示以下输出：

ndb_mgm> SHOW
Connected to Management Server at: localhost:1186 (using cleartext)
Cluster Configuration
---------------------
[ndbd(NDB)]     4 node(s)
id=5    @198.51.100.10  (mysql-8.4.0 ndb-8.4.0, Nodegroup: 0, *)
id=6    @198.51.100.20  (mysql-8.4.0 ndb-8.4.0, Nodegroup: 0)
id=7    @198.51.100.30  (mysql-8.4.0 ndb-8.4.0, Nodegroup: 1)
id=8    @198.51.100.40  (mysql-8.4.0 ndb-8.4.0, Nodegroup: 1)

[ndb_mgmd(MGM)] 1 node(s)
id=50   @198.51.100.150  (mysql-8.4.0 ndb-8.4.0)

[mysqld(API)]   2 node(s)
id=100  @198.51.100.100  (mysql-8.4.0 ndb-8.4.0)
id=101 (not connected, accepting connect from any host)

该命令的输出还指示集群是否处于单用户模式（请参阅ENTER SINGLE USER MODE命令的描述，以及第25.6.6节，“NDB Cluster Single User Mode”）。它还指示在该模式下哪个API或SQL节点具有独占访问权限。

SHUTDOWN

关闭所有集群数据节点和管理节点。退出管理客户端后，使用EXIT或QUIT。

这个命令不会关闭任何与集群连接的SQL节点或API节点。

node_id START

将数据节点node_id(或所有数据节点)带在线。

ALL START只对所有数据节点有效，不影响管理节点。

node_id STATUS

显示数据节点node_id(或所有数据节点)的状态信息。

可能的节点状态值包括UNKNOWN、NO_CONTACT、NOT_STARTED、STARTING、STARTED、SHUTTING_DOWN和RESTARTING。

该命令的输出还会指示集群是否处于单用户模式。

node_id STOP [-a] [-f]

停止由node_id标识的数据或管理节点。

受到该命令影响的节点将从集群中断开连接，并且其关联的ndbd或ndb_mgmd进程将终止。

-a选项会立即停止节点，而不等待任何挂起事务的完成。

通常，STOP命令在结果将导致集群不完整时失败。-f选项强制节点关闭，不检查是否会导致集群不完整。如果使用该选项并且结果是一个不完整的集群，集群将立即关闭。

TLS INFO

显示集群 TLS 信息，如当前连接是否使用 TLS、管理节点当前知晓的 TLS 证书和管理节点对总连接数、升级到 TLS 的连接数和授权失败次数。示例输出如下：

ndb_mgm> TLS INFO

Session ID:          1
Peer address:        127.0.0.1
Certificate name:    NDB Management Node Jun 2023
Certificate serial:  B5:23:8F:D1:11:85:E5:93:ED
Certificate expires: 23-Nov-2023

Server statistics since restart
Total accepted connections:        6
Total connections upgraded to TLS: 2
Current connections:               3
Current connections using TLS:     2
Authorization failures:            0

ndb_mgm>

更多信息，请见第25.6.15节，“NDB 集群 TLS 链路加密”。

START BACKUP 用于在 ndb_mgm 客户端中执行在线备份；ABORT BACKUP 命令用于取消已经在进行中的备份。更多信息，请见 第 25.6.8 节，“NDB 集群在线备份”。

CLUSTERLOG 命令用于执行各种日志函数。更多信息和示例，请见 第 25.6.3 节，“NDB 集群事件报告”。NODELOG DEBUG 激活或停用节点日志中的调试打印语句，如前一节中所述。

为了测试和诊断工作，客户端支持一个 DUMP 命令，可以用来在集群上执行内部命令。除非 MySQL 支持团队明确指示，否则不应该在生产环境中使用它。更多信息，请见 NDB 集群管理客户端 DUMP 命令。