### 23.5.5 ndb_mgm — NDB 集群管理客户端

[](<>)[](<>)[](<>)[](<>)[](<>)[](<>)[](<>)

这[**数据库\_毫克**](mysql-cluster-programs-ndb-mgm.html)管理客户端进程实际上不需要运行集群。它的价值在于提供一组用于检查集群状态、启动备份和执行其他管理功能的命令。管理客户端使用 C API 访问管理服务器。高级用户还可以使用此 API 对专用管理流程进行编程，以执行类似于由[**数据库\_毫克**](mysql-cluster-programs-ndb-mgm.html).

要启动管理客户端，需要提供管理服务器的主机名和端口号：

```
$> ndb_mgm [host_name [port_num]]
```

例如：

```
$> ndb_mgm ndb_mgmd.mysql.com 1186
```

默认主机名和端口号是`本地主机`和 1186，分别。

[](<>)[](<>)[](<>)[](<>)

可以使用的所有选项[**数据库\_毫克**](mysql-cluster-programs-ndb-mgm.html)如下表所示。附加说明如下表。

[](<>)

**表 23.27 与程序 ndb 一起使用的命令行选项\_毫克**

| 格式 | 描述 | 添加、弃用或删除 |
| --- | --- | -------- |
| `[--backup-password-from-stdin](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_backup-password-from-stdin)` | 从 STDIN 以安全的方式获取解密密码；与 --execute 和 ndb 一起使用\_mgm 开始备份命令 | 添加：新开发银行 8.0.24 |
| `[--character-sets-dir=path](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_character-sets-dir)` | 包含字符集的目录 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--connect-retries=#](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_connect-retries)` | 设置放弃前重试连接的次数；0 表示仅尝试 1 次（不重试） | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--connect-retry-delay=#](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_connect-retry-delay)` | 尝试联系管理服务器之间等待的秒数 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--connect-string=connection_string](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_connect-string)`,<br/><br/>`[-c connection_string](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_connect-string)` | 与 --ndb-connectstring 相同 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--core-file](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_core-file)` | 错误时写入核心文件；用于调试 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-extra-file=path](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_defaults-extra-file)` | 读取全局文件后读取给定文件 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-file=path](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_defaults-file)` | 仅从给定文件中读取默认选项 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-group-suffix=string](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_defaults-group-suffix)` | 还阅读带有 concat(group, suffix) 的组 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--encrypt-backup](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_encrypt-backup)` | 使启动备份在进行备份时进行加密，如果用户未提供密码，则提示输入密码 | 新增：NDB 8.0.24 |
| `[--execute=command]（mysql集群程序ndb mgm.html#option_ndb_mgm_execute）`,<br/><br/>`[-e命令]（mysql集群程序ndb mgm.html#选项_ndb_mgm_执行）` | 执行命令并退出 | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--help]（mysql集群程序ndb mgm.html#option_ndb_mgm_help）`,<br/><br/>`[-?]（mysql集群程序ndb mgm.html#选项_ndb_mgm_帮助）` | 显示帮助文本并退出 | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--login path=path]（mysql集群程序ndb mgm.html#option_ndb_mgm_login-path）` | 从登录文件读取给定路径 | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--ndb connectstring=connection_string]（mysql集群程序ndb mgm.html#option_ndb_mgm_ndb-connectstring）`,<br/><br/>`[-c connection_string]（mysql集群程序ndb mgm.html#option_ndb_mgm_ndb-connectstring）` | 设置连接到ndb的连接字符串\_mgmd。语法：“[nodeid=id；][host=]主机名[：端口:]“。覆盖NDB中的条目\_连接字符串和我的。cnf | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--ndb mgmd host=connection_string]（mysql集群程序ndb mgm.html#option_ndb_mgm_ndb-mgmd-host）`,<br/><br/>`[-c connection_string]（mysql集群程序ndb mgm.html#option_ndb_mgm_ndb-mgmd-host）` | 与--ndb connectstring相同 | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--ndb nodeid=#]（mysql集群程序ndb mgm.html#option_ndb_mgm_ndb-nodeid）` | 设置此节点的节点ID，覆盖由--ndb connectstring设置的任何ID | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--ndb优化节点选择]（mysql集群程序ndb mgm.html#option_ndb_mgm_ndb-optimized-node-selection）` | 启用事务节点选择的优化。默认启用；使用--跳过ndb优化节点选择以禁用 | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--无默认值]（mysql集群程序ndb mgm.html#选项_ndb_mgm_无默认值）` | 不要从登录文件以外的任何选项文件中读取默认选项 | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--print defaults]（mysql集群程序ndb mgm.html#option_ndb_mgm_print-defaults）` | 打印程序参数列表并退出 | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--try reconnect=#]（mysql集群程序ndb mgm.html#option_ndb_mgm_try-reconnect）`,<br/><br/>`[-t#]（mysql集群程序ndb mgm.html#option_ndb_mgm_try-reconnect）` | 设置放弃前重试连接的次数；同义词--connect retries | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--用法]（mysql集群程序ndb mgm.html#option_ndb_mgm_用法）`,<br/><br/>`[-?]（mysql集群程序ndb mgm.html#选项_ndb_mgm_用法）` | 显示帮助文本并退出；跟…救命 | （所有基于MySQL 8.0的NDB版本都支持） |
| `[--version]（mysql集群程序ndb mgm.html#option_ndb_mgm_version）`,<br/><br/>`[-V]（mysql集群程序ndb mgm.html#option_ndb_mgm_版本）` | 显示版本信息并退出 | （所有基于MySQL 8.0的NDB版本都支持） |

-   [](<>) `--backup-password-from-stdin[=TRUE|FALSE]`

    [](<>)[](<>)

    | 命令行格式 | `--backup-password-from-stdin` |
    | ----- | ------------------------------ |
    | 介绍 | 8.0.24-ndb-8.0.24 |

    此选项允许从系统 shell 输入备份密码 (`标准输入`) 使用时`--执行“开始备份”`或类似的创建备份。使用此选项需要使用[`- 执行`](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_execute)也是。

-   [](<>) `--字符集目录`

    [](<>)[](<>)

    | 命令行格式 | `--character-sets-dir=路径` |
    | ----- | ------------------------- |

    包含字符集的目录。

-   [](<>) `--连接重试=*`#`*`

    [](<>)[](<>)

    | 命令行格式 | `--连接重试=#` |
    | ----- | ---------- |
    | 类型 | 数字 |
    | 默认值 | `3` |
    | 最小值 | `0` |
    | 最大值 | `4294967295` |

    此选项指定在放弃之前第一次尝试重试连接的次数（客户端总是至少尝试一次连接）。每次尝试等待的时间长度是使用设置的[`--连接重试延迟`](mysql-cluster-programs-ndb-mgmd.html#option_ndb_mgmd_connect-retry-delay).

    此选项与[`--尝试重新连接`](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_try-reconnect)选项，现在已弃用。

-   [](<>) `--连接重试延迟`

    [](<>)[](<>)

    | 命令行格式 | `--连接重试延迟=#` |
    | ----- | ------------ |
    | 类型 | 整数 |
    | 默认值 | `5` |
    | 最小值 | `0` |
    | 最大值 | `5` |

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

-   [](<>) `--连接字符串`

    [](<>)[](<>)

    | 命令行格式 | `--connect-string=connection_string` |
    | ----- | ------------------------------------ |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

    与...一样[`--ndb-连接字符串`](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_ndb-connectstring).

-   [](<>) `--核心文件`

    [](<>)[](<>)

    | 命令行格式 | `--核心文件` |
    | ----- | -------- |

    错误时写入核心文件；用于调试。

-   [](<>) `--defaults-额外文件`

    [](<>)[](<>)

    | 命令行格式 | `--defaults-extra-file=路径` |
    | ----- | -------------------------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

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

-   [](<>) `--defaults 文件`

    [](<>)[](<>)

    | 命令行格式 | `--defaults-file=路径` |
    | ----- | -------------------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

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

-   [](<>) `--defaults-组后缀`

    [](<>)[](<>)

    | 命令行格式 | `--defaults-group-suffix=字符串` |
    | ----- | ----------------------------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

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

-   [](<>) `--加密备份`

    [](<>)[](<>)

    | 命令行格式 | `--加密备份` |
    | ----- | -------- |
    | 介绍 | 8.0.24-ndb-8.0.24 |

    使用此选项时，会加密所有备份。为了做到这一点，无论何时[**数据库\_毫克**](mysql-cluster-programs-ndb-mgm.html)运行，把选项放在`[ndb_mgm]`的部分`我的.cnf`文件。

-   [](<>) `--执行=`命令``, `-e` 命令``

    [](<>)[](<>)[](<>)[](<>)

    | 命令行格式 | `--执行=命令` |
    | ----- | --------- |

    此选项可用于从系统 shell 向 NDB Cluster 管理客户端发送命令。例如，以下任何一个都等价于执行[`显示`](mysql-cluster-mgm-client-commands.html#ndbclient-show)在管理客户端中：

    ```
    $> ndb_mgm -e "SHOW"

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

    这类似于[`- 执行`](mysql-command-options.html#option_mysql_execute)要么`-e`选项适用于[**mysql**](mysql.html)命令行客户端。看[第 4.2.2.1 节，“在命令行上使用选项”](command-line-options.html).

    笔记

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

-   [](<>) `- 帮助`

    [](<>)[](<>)

    | 命令行格式 | `- 帮助` |
    | ----- | ------ |

    显示帮助文本并退出。

-   [](<>) `--登录路径`

    [](<>)[](<>)

    | 命令行格式 | `--登录路径=路径` |
    | ----- | ----------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

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

-   [](<>) `--ndb-连接字符串`

    [](<>)[](<>)

    | 命令行格式 | `--ndb-connectstring=connection_string` |
    | ----- | --------------------------------------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

    设置连接字符串以连接到[**数据库\_管理**](mysql-cluster-programs-ndb-mgmd.html).句法：[`节点ID=*`id`*;`][`host=`]`*`主机名`*`[`:*`港口`*`].覆盖中的条目`NDB_CONNECTSTRING`和`我的.cnf`.

-   [](<>) `--ndb-nodeid`

    [](<>)[](<>)

    | 命令行格式 | `--ndb-nodeid=#` |
    | ----- | ---------------- |
    | 类型 | 整数 |
    | 默认值 | `[没有]` |

    设置此节点的节点 ID，覆盖由设置的任何 ID[`--ndb-连接字符串`](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_ndb-connectstring).

-   [](<>) `--ndb-mgmd-主机`

    [](<>)[](<>)

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

    与...一样[`--ndb-连接字符串`](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_ndb-connectstring).

-   [](<>) `--ndb-optimized-node-selection`

    [](<>)[](<>)

    | 命令行格式 | `--ndb-optimized-node-selection` |
    | ----- | -------------------------------- |

    启用优化以选择交易节点。默认启用；采用`--skip-ndb-optimized-node-selection`禁用。

-   [](<>) `--no-defaults`

    [](<>)[](<>)

    | 命令行格式 | `--no-defaults` |
    | ----- | --------------- |

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

-   [](<>) `--打印默认值`

    [](<>)[](<>)

    | 命令行格式 | `--打印默认值` |
    | ----- | --------- |

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

-   [](<>) `--尝试重新连接=*`数字`*`

    | 命令行格式 | `--尝试重新连接=#` |
    | ----- | ------------ |
    | 已弃用 | 是的 |
    | 类型 | 数字 |
    | 类型 | 整数 |
    | 默认值 | `12` |
    | 默认值 | `3` |
    | 最小值 | `0` |
    | 最大值 | `4294967295` |

    如果与管理服务器的连接中断，则节点每 5 秒尝试重新连接一次，直到连接成功。通过使用此选项，可以限制尝试的次数*`数字`*在放弃并报告错误之前。

    此选项已弃用，可能会在将来的版本中删除。采用[`--连接重试`](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_connect-retries)， 反而。

-   [](<>) `- 用法`

    [](<>)[](<>)

    | 命令行格式 | `- 用法` |
    | ----- | ------ |

    显示帮助文本并退出；与...一样[`- 帮助`](mysql-cluster-programs-ndb-mgm.html#option_ndb_mgm_help).

-   [](<>) `- 版本`

     [](<>)[](<>)

    | 命令行格式 | `- 版本` |
    | ----- | ------ |

    显示版本信息并退出。

    有关使用的其他信息[**数据库\_毫克**](mysql-cluster-programs-ndb-mgm.html)可以在[第 23.6.1 节，“NDB 集群管理客户端中的命令”](mysql-cluster-mgm-client-commands.html).
