### 23.5.7 ndb_config — 提取 NDB 集群配置信息

[](<>)

此工具从多个来源之一提取数据节点、SQL 节点和 API 节点的当前配置信息：NDB Cluster 管理节点或其`配置文件`要么`我的.cnf`文件。默认情况下，管理节点是配置数据的来源；要覆盖默认值，请执行 ndb\_配置[`--配置文件`](mysql-cluster-programs-ndb-config.html#option_ndb_config_config-file)要么[`--mycnf`](mysql-cluster-programs-ndb-config.html#option_ndb_config_mycnf)选项。也可以通过指定其节点 ID 来使用数据节点作为源[`--config_from_node=*`node_id`*`](mysql-cluster-programs-ndb-config.html#option_ndb_config_config_from_node).

[**数据库\_配置**](mysql-cluster-programs-ndb-config.html)还可以提供所有可以使用的配置参数的离线转储，以及它们的默认值、最大值和最小值以及其他信息。转储可以以文本或 XML 格式生成；有关更多信息，请参阅[`--configinfo`](mysql-cluster-programs-ndb-config.html#option_ndb_config_configinfo)和[`--xml`](mysql-cluster-programs-ndb-config.html#option_ndb_config_xml)本节后面的选项）。

您可以按部分过滤结果（`D B`,`系统`， 要么`连接`) 使用其中一个选项[`--节点`](mysql-cluster-programs-ndb-config.html#option_ndb_config_nodes),[`- 系统`](mysql-cluster-programs-ndb-config.html#option_ndb_config_system)， 要么[`--连接`](mysql-cluster-programs-ndb-config.html#option_ndb_config_connections).

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

[](<>)

**表 23.29 与程序 ndb 一起使用的命令行选项\_配置**

| 格式 | 描述 | 添加、弃用或删除 |
| --- | --- | -------- |
| `[--character-sets-dir=path](mysql-cluster-programs-ndb-config.html#option_ndb_config_character-sets-dir)` | 包含字符集的目录 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--cluster-config-suffix=name](mysql-cluster-programs-ndb-config.html#option_ndb_config_cluster-config-suffix)` | 读取集群时覆盖默认组后缀\_my.cnf 文件中的配置部分；用于测试 | 添加：新开发银行 8.0.24 |
| `[--config-file=file_name](mysql-cluster-programs-ndb-config.html#option_ndb_config_config-file)` | 设置 config.ini 文件的路径 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--config-from-node=#](mysql-cluster-programs-ndb-config.html#option_ndb_config_config_from_node)` | 从具有该ID的节点获取配置数据（必须是数据节点） | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--configinfo](mysql-cluster-programs-ndb-config.html#option_ndb_config_configinfo)` | 以文本格式转储有关所有 NDB 配置参数的信息，包括默认值、最大值和最小值。与 --xml 一起使用以获取 XML 输出 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--connections](mysql-cluster-programs-ndb-config.html#option_ndb_config_connections)` | 仅打印有关中指定的连接的信息[tcp],[tcp 默认],[科学],[科学默认],[嘘]， 要么[shm 默认]集群配置文件的部分。不能与 --system 或 --nodes 一起使用 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--connect-retries=#](mysql-cluster-programs-ndb-config.html#option_ndb_config_connect-retries)` | 放弃前重试连接的次数 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--connect-retry-delay=#](mysql-cluster-programs-ndb-config.html#option_ndb_config_connect-retry-delay)` | 尝试联系管理服务器之间等待的秒数 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--connect-string=connection_string](mysql-cluster-programs-ndb-config.html#option_ndb_config_connect-string)`,<br/><br/>`[-c connection_string](mysql-cluster-programs-ndb-config.html#option_ndb_config_connect-string)` | 与 --ndb-connectstring 相同 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--core-file](mysql-cluster-programs-ndb-config.html#option_ndb_config_core-file)` | 错误时写入核心文件；用于调试 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-extra-file=path](mysql-cluster-programs-ndb-config.html#option_ndb_config_defaults-extra-file)` | 读取全局文件后读取给定文件 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-file=path](mysql-cluster-programs-ndb-config.html#option_ndb_config_defaults-file)` | 仅从给定文件中读取默认选项 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-group-suffix=string](mysql-cluster-programs-ndb-config.html#option_ndb_config_defaults-group-suffix)` | 还阅读带有 concat(group, suffix) 的组 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--diff-default](mysql-cluster-programs-ndb-config.html#option_ndb_config_diff-default)` | 仅打印具有非默认值的配置参数 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--fields=string](mysql-cluster-programs-ndb-config.html#option_ndb_config_fields)`,<br/><br/>`[-f](mysql-cluster-programs-ndb-config.html#option_ndb_config_fields)` | 字段分隔符 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--help](mysql-cluster-programs-ndb-config.html#option_ndb_config_help)`,<br/><br/>`[-?](mysql-cluster-programs-ndb-config.html#option_ndb_config_help)` | 显示帮助文本并退出 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--host=name](mysql-cluster-programs-ndb-config.html#option_ndb_config_host)` | 指定主机 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--login-path=path](mysql-cluster-programs-ndb-config.html#option_ndb_config_login-path)` | 从登录文件中读取给定路径 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--mycnf](mysql-cluster-programs-ndb-config.html#option_ndb_config_mycnf)` | 从 my.cnf 文件中读取配置数据 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--ndb-connectstring=connection_string](mysql-cluster-programs-ndb-config.html#option_ndb_config_ndb-connectstring)`,<br/><br/>`[-c connection_string](mysql-cluster-programs-ndb-config.html#option_ndb_config_ndb-connectstring)` | 设置连接字符串以连接到 ndb\_毫克。句法： ”[节点ID=ID；][host=]主机名[：港口:]"。覆盖 NDB 中的条目\_CONNECTSTRING 和 my.cnf（所有基于 MySQL 8.0 的 NDB 版本都支持） | \[--ndb-mgmd-host=connection_string](mysql-cluster-programs-ndb-config.html#option_ndb_config_ndb-mgmd-host) |
| `,`\[-c connection_string](mysql-cluster-programs-ndb-config.html#option_ndb_config_ndb-mgmd-host)<br/><br/>`与 --ndb-connectstring 相同` | （所有基于 MySQL 8.0 的 NDB 版本都支持） | \[--ndb-nodeid=#](mysql-cluster-programs-ndb-config.html#option_ndb_config_ndb-nodeid) |
| `设置此节点的节点 ID，覆盖由 --ndb-connectstring 设置的任何 ID` | （所有基于 MySQL 8.0 的 NDB 版本都支持） | \[--ndb-optimized-node-selection](mysql-cluster-programs-ndb-config.html#option_ndb_config_ndb-optimized-node-selection) |
| `启用优化以选择交易节点。` | 默认启用；使用 --skip-ndb-optimized-node-selection 禁用 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--no-defaults](mysql-cluster-programs-ndb-config.html#option_ndb_config_no-defaults)` | 不要从登录文件以外的任何选项文件中读取默认选项 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--nodeid=#](mysql-cluster-programs-ndb-config.html#option_ndb_config_nodeid)` | 获取具有此 ID 的节点的配置 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--nodes](mysql-cluster-programs-ndb-config.html#option_ndb_config_nodes)` | 打印节点信息（[ndbd]要么[ndbd 默认]仅集群配置文件的部分）。不能与 --system 或 --connections 一起使用 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--query=string](mysql-cluster-programs-ndb-config.html#option_ndb_config_query)`,<br/><br/>`[-q 字符串](mysql-cluster-programs-ndb-config.html#option_ndb_config_query)` | 一个或多个查询选项（属性） | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--query-all](mysql-cluster-programs-ndb-config.html#option_ndb_config_query-all)`,<br/><br/>`[-a](mysql-cluster-programs-ndb-config.html#option_ndb_config_query-all)` | 将所有参数和值转储到单个逗号分隔的字符串 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--print-defaults](mysql-cluster-programs-ndb-config.html#option_ndb_config_print-defaults)` | 打印程序参数列表并退出 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--rows=string](mysql-cluster-programs-ndb-config.html#option_ndb_config_rows)`,<br/><br/>`[-r 字符串](mysql-cluster-programs-ndb-config.html#option_ndb_config_rows)` | 行分隔符 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--system](mysql-cluster-programs-ndb-config.html#option_ndb_config_system)` | 仅打印 SYSTEM 部分信息（参见 ndb\_配置 --configinfo 输出）。不能与 --nodes 或 --connections 一起使用 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--type=name](mysql-cluster-programs-ndb-config.html#option_ndb_config_type)` | 指定节点类型 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--usage](mysql-cluster-programs-ndb-config.html#option_ndb_config_usage)`,<br/><br/>`[-?](mysql-cluster-programs-ndb-config.html#option_ndb_config_usage)` | 显示帮助文本并退出；与 --help 相同 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--version](mysql-cluster-programs-ndb-config.html#option_ndb_config_version)`,<br/><br/>`[-V](mysql-cluster-programs-ndb-config.html#option_ndb_config_version)` | 显示版本信息并退出 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--configinfo --xml](mysql-cluster-programs-ndb-config.html#option_ndb_config_xml)` | 使用 --xml 和 --configinfo 以 XML 格式获取所有 NDB 配置参数的转储，包括默认值、最大值和最小值 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |

-   [](<>) `集群配置后缀`

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

    | 命令行格式 | `--cluster-config-suffix=名称` |
    | ----- | ---------------------------- |
    | 介绍 | 8.0.24-ndb-8.0.24 |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

    读取集群配置部分时覆盖默认组后缀`我的.cnf`;用于测试。

-   [](<>) `--configinfo`

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

    这`--configinfo`选项原因[**数据库\_配置**](mysql-cluster-programs-ndb-config.html)转储 NDB Cluster 分布支持的每个 NDB Cluster 配置参数的列表[**数据库\_配置**](mysql-cluster-programs-ndb-config.html)是一个零件，包括以下信息：

    -   每个参数的用途、效果和用法的简要说明

    -   该部分`配置文件`可以使用参数的文件

    -   参数的数据类型或测量单位

    -   适用时，参数的默认值、最小值和最大值

    -   NDB Cluster 发布版本和构建信息

        默认情况下，此输出为文本格式。此处显示了此输出的一部分：

    ```
    $> ndb_config --configinfo

    ****** SYSTEM ******

    Name (String)
    Name of system (NDB Cluster)
    MANDATORY

    PrimaryMGMNode (Non-negative Integer)
    Node id of Primary ndb_mgmd(MGM) node
    Default: 0 (Min: 0, Max: 4294967039)

    ConfigGenerationNumber (Non-negative Integer)
    Configuration generation number
    Default: 0 (Min: 0, Max: 4294967039)

    ****** DB ******

    MaxNoOfSubscriptions (Non-negative Integer)
    Max no of subscriptions (default 0 == MaxNoOfTables)
    Default: 0 (Min: 0, Max: 4294967039)

    MaxNoOfSubscribers (Non-negative Integer)
    Max no of subscribers (default 0 == 2 * MaxNoOfTables)
    Default: 0 (Min: 0, Max: 4294967039)

    …
    ```

    将此选项与[`--xml`](mysql-cluster-programs-ndb-config.html#option_ndb_config_xml)以 XML 格式获取输出的选项。

-   [](<>) `--配置文件=*`文件路径`*`

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

    | 命令行格式 | `--config-file=file_name` |
    | ----- | ------------------------- |
    | 类型 | 文件名 |
    | 默认值 | `` |

    提供管理服务器配置文件的路径 (`配置文件`）。这可能是相对或绝对路径。如果管理节点驻留在与其所在的主机不同的主机上[**数据库\_配置**](mysql-cluster-programs-ndb-config.html)被调用，则必须使用绝对路径。

-   [](<>) `--config_from_node=#`

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

    | 命令行格式 | `--config-from-node=#` |
    | ----- | ---------------------- |
    | 类型 | 数字 |
    | 默认值 | `没有` |
    | 最小值 | `1` |
    | 最大值 | `48` |

    从具有该 ID 的数据节点获取集群的配置数据。

    如果具有此 ID 的节点不是数据节点，[**数据库\_配置**](mysql-cluster-programs-ndb-config.html)失败并出现错误。（要改为从管理节点获取配置数据，只需省略此选项。）

-   [](<>) `--连接`

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

    | 命令行格式 | `--连接` |
    | ----- | ------ |

    告诉[**数据库\_配置**](mysql-cluster-programs-ndb-config.html)打印`连接`仅供参考，即有关参数的信息`[tcp]`,`[tcp 默认]`,`[嘘]`， 要么`[shm 默认]`集群配置文件的部分（见[第 23.4.3.10 节，“NDB 集群 TCP/IP 连接”](mysql-cluster-tcp-definition.html)， 和[第 23.4.3.12 节，“NDB 集群共享内存连接”](mysql-cluster-shm-definition.html)， 了解更多信息）。

    此选项与[`--节点`](mysql-cluster-programs-ndb-config.html#option_ndb_config_nodes)和[`- 系统`](mysql-cluster-programs-ndb-config.html#option_ndb_config_system);只能使用这 3 个选项之一。

-   [](<>) `--diff-默认值`

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

    | 命令行格式 | `--diff-默认值` |
    | ----- | ------------ |

    仅打印具有非默认值的配置参数。

-   [](<>) `--字段=*`分隔符`*`,`-f` *`分隔符`*

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

    | 命令行格式 | `--fields=字符串` |
    | ----- | -------------- |
    | 类型 | 细绳 |
    | 默认值 | `` |

    指定一个*`分隔符`*用于分隔结果中的字段的字符串。默认是`,`（逗号字符）。

    笔记

    如果*`分隔符`*包含空格或转义符（例如`\n`对于换行符），那么它必须被引用。

-   [](<>) `--主机=*`主机名`*`

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

    | 命令行格式 | `--主机=名称` |
    | ----- | --------- |
    | 类型 | 细绳 |
    | 默认值 | `` |

    指定要获取配置信息的节点的主机名。

    笔记

    虽然主机名`本地主机`通常解析为 IP 地址`127.0.0.1`，这可能不一定适用于所有操作平台和配置。这意味着有可能，当`本地主机`用于`配置文件`， 为了[**数据库\_配置`--主机=本地主机`**](mysql-cluster-programs-ndb-config.html)如果失败[**数据库\_配置**](mysql-cluster-programs-ndb-config.html)在不同的主机上运行`本地主机`解析为不同的地址（例如，在某些版本的 SUSE Linux 上，这是`127.0.0.2`）。通常，为了获得最佳结果，您应该对与主机相关的所有 NDB Cluster 配置值使用数字 IP 地址，或验证所有 NDB Cluster 主机是否处理`本地主机`以同样的方式。

-   [](<>) `--mycnf`

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

    | 命令行格式 | `--mycnf` |
    | ----- | --------- |

    读取配置数据`我的.cnf`文件。

-   [](<>) `--ndb-connectstring=*`连接字符串`*`,`-c *`连接字符串`*`

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

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

    指定用于连接到管理服务器的连接字符串。连接字符串的格式与中描述的相同[第 23.4.3.3 节，“NDB 集群连接字符串”](mysql-cluster-connection-strings.html), 默认为`本地主机:1186`.

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

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

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

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

-   [](<>) `--nodeid=*`node_id`*`

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

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

    指定要获取配置信息的节点的节点ID。

-   [](<>) `--节点`

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

    | 命令行格式 | `--节点` |
    | ----- | ------ |

    告诉[**数据库\_配置**](mysql-cluster-programs-ndb-config.html)打印仅与定义的参数有关的信息`[ndbd]`要么`[ndbd 默认]`集群配置文件的部分（参见[第 23.4.3.6 节，“定义 NDB Cluster 数据节点”](mysql-cluster-ndbd-definition.html)）。

    此选项与[`--连接`](mysql-cluster-programs-ndb-config.html#option_ndb_config_connections)和[`- 系统`](mysql-cluster-programs-ndb-config.html#option_ndb_config_system);只能使用这 3 个选项之一。

-   [](<>) `--查询=*`查询选项`*`,`-q` *`查询选项`*

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

    | 命令行格式 | `--查询=字符串` |
    | ----- | ---------- |
    | 类型 | 细绳 |
    | 默认值 | `` |

    这是一个以逗号分隔的查询选项列表，即要返回的一个或多个节点属性的列表。这些包括`节点ID`（节点 ID），类型（节点类型——即，`ndbd`,`mysqld`， 要么`ndb_mgmd`)，以及要获取其值的任何配置参数。

    例如，`--query=nodeid,type,datamemory,datadir`返回节点 ID、节点类型、[`数据存储器`](mysql-cluster-ndbd-definition.html#ndbparam-ndbd-datamemory)， 和[`数据目录`](mysql-cluster-ndbd-definition.html#ndbparam-ndbd-datadir)对于每个节点。

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

    笔记

    如果给定参数不适用于某种类型的节点，则为相应的值返回一个空字符串。有关详细信息，请参阅本节后面的示例。

-   [](<>) `--查询全部`,`-一种`

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

    | 命令行格式 | `--查询全部` |
    | ----- | -------- |
    | 类型 | 细绳 |
    | 默认值 | `` |

    返回所有查询选项（节点属性）的逗号分隔列表；请注意，此列表是单个字符串。

-   [](<>) `--排=*`分离器`*`,`-r` *`分离器`*

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

    | 命令行格式 | `--行=字符串` |
    | ----- | --------- |
    | 类型 | 一串 |
    | 默认值 | `` |

    指定一个*`分离器`*用于分隔结果中的行的字符串。默认值为空格字符。

    笔记

    如果*`分离器`*包含空格或转义符（例如`\n`对于换行符），则必须将其引用。

-   [](<>) `--系统`

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

    | 命令行格式 | `--系统` |
    | ----- | ------ |

    说明[**ndb\_配置**](mysql-cluster-programs-ndb-config.html)印刷`系统`仅供参考。这包括在运行时无法更改的系统变量；因此，它们没有相应的集群配置文件部分。可以看到它们（前缀为`******系统******`)在[**ndb\_配置**](mysql-cluster-programs-ndb-config.html) [`--配置信息`](mysql-cluster-programs-ndb-config.html#option_ndb_config_configinfo).

    此选项与[`--节点`](mysql-cluster-programs-ndb-config.html#option_ndb_config_nodes)和[`--联系`](mysql-cluster-programs-ndb-config.html#option_ndb_config_connections); 只能使用这三个选项中的一个。

-   [](<>) `--类型=*`节点类型`*`

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

    | 命令行格式 | `--类型=名称` |
    | ----- | --------- |
    | 类型 | 列举 |
    | 默认值 | `[无]` |
    | 有效值 | `ndbd`<br/><br/>`mysqld`<br/><br/>`ndb_mgmd` |

    筛选结果，以便仅将配置值应用于指定*`节点类型`* (`ndbd`, `mysqld`或`ndb_mgmd`)他们都回来了。

-   [](<>) `--用法`, `--救命`或`-?`

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

    | 命令行格式 | `--救命` |
    | ----- | ------ |

    原因[**ndb\_配置**](mysql-cluster-programs-ndb-config.html)打印可用选项列表，然后退出。

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

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

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

    原因[**ndb\_配置**](mysql-cluster-programs-ndb-config.html)打印版本信息字符串，然后退出。

-   [](<>) `--配置信息` `--xml`

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

    | 命令行格式 | `--configinfo——xml` |
    | ----- | ------------------- |

    原因[**ndb\_配置**](mysql-cluster-programs-ndb-config.html) [`--配置信息`](mysql-cluster-programs-ndb-config.html#option_ndb_config_configinfo)通过添加此选项以XML形式提供输出。该示例中显示了该输出的一部分：

    ```
    $> ndb_config --configinfo --xml

    <configvariables protocolversion="1" ndbversionstring="5.7.37-ndb-7.5.26"
                        ndbversion="460032" ndbversionmajor="7" ndbversionminor="5"
                        ndbversionbuild="0">
      <section name="SYSTEM">
        <param name="Name" comment="Name of system (NDB Cluster)" type="string"
                  mandatory="true"/>
        <param name="PrimaryMGMNode" comment="Node id of Primary ndb_mgmd(MGM) node"
                  type="unsigned" default="0" min="0" max="4294967039"/>
        <param name="ConfigGenerationNumber" comment="Configuration generation number"
                  type="unsigned" default="0" min="0" max="4294967039"/>
      </section>
      <section name="MYSQLD" primarykeys="NodeId">
        <param name="wan" comment="Use WAN TCP setting as default" type="bool"
                  default="false"/>
        <param name="HostName" comment="Name of computer for this node"
                  type="string" default=""/>
        <param name="Id" comment="NodeId" type="unsigned" mandatory="true"
                  min="1" max="255" deprecated="true"/>
        <param name="NodeId" comment="Number identifying application node (mysqld(API))"
                  type="unsigned" mandatory="true" min="1" max="255"/>
        <param name="ExecuteOnComputer" comment="HostName" type="string"
                  deprecated="true"/>

        …

      </section>

      …

    </configvariables>
    ```

    笔记

    通常情况下[**ndb\_配置**](mysql-cluster-programs-ndb-config.html) `--配置信息` `--xml`每个元素使用一行进行格式化；出于易读性的考虑，我们在上一个示例以及下一个示例中添加了额外的空白。这对使用此输出的应用程序不会产生任何影响，因为大多数XML处理器要么理所当然地忽略不重要的空白，要么会被指示这样做。

    XML输出还指示何时更改给定参数需要使用[`--首字母`](mysql-cluster-programs-ndbd.html#option_ndbd_initial)选项这可以通过一个`initial=“true”`在相应的`<param>`要素此外，重启类型(`系统`或`节点`)还显示了；如果给定参数需要重新启动系统，则会显示`restart=“系统”`在相应的`<param>`要素例如，更改[`无盘`](mysql-cluster-ndbd-definition.html#ndbparam-ndbd-diskless)参数要求系统初始重启，如下所示（使用`重新启动`和`最初的`突出显示的属性（用于可见性）：

    ```
    <param name="Diskless" comment="Run wo/ disk" type="bool" default="false"
              restart="system" initial="true"/>
    ```

    目前没有`最初的`属性包含在的XML输出中`<param>`与不需要初始重启的参数相对应的元素；换句话说，`initial=“false”`是默认值，并且`错误的`如果属性不存在，则应假定。类似地，默认的重启类型是`节点`（即，集群的在线或“滚动”重启），但`重新启动`仅当重新启动类型为`系统`（这意味着必须同时关闭所有群集节点，然后重新启动）。

    不推荐使用的参数在XML输出中由`反对`属性，如下所示：

    ```
    <param name="NoOfDiskPagesToDiskAfterRestartACC" comment="DiskCheckpointSpeed"
           type="unsigned" default="20" min="1" max="4294967039" deprecated="true"/>
    ```

    在这种情况下`议论`指一个或多个取代已弃用参数的参数。类似于`最初的`这个`反对`属性仅在参数不推荐使用时才指示，带有`deprecated=“true”`，对于未弃用的参数，根本不显示。（Bug#21127135）

    所需的参数用`mandatory=“true”`，如图所示：

    ```
    <param name="NodeId"
              comment="Number identifying application node (mysqld(API))"
              type="unsigned" mandatory="true" min="1" max="255"/>
    ```

    就像`最初的`或`反对`属性仅针对需要初始重新启动或已弃用的参数显示`强制性的`属性仅在实际需要给定参数时才包含。

    重要的

    这个`--xml`选项只能与`--配置信息`选项使用`--xml`没有`--配置信息`由于一个错误而失败。

    与此程序用于获取当前配置数据的选项不同，`--配置信息`和`--xml`在以下情况下使用从NDB群集源获得的信息：[**ndb\_配置**](mysql-cluster-programs-ndb-config.html)是汇编的。因此，无法连接到正在运行的NDB群集或访问`配置。伊尼`或`我的cnf`这两个选项都需要文件。

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

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

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

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

-   [](<>) `--默认文件`

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

    | 命令行格式 | `--默认文件=路径` |
    | ----- | ----------- |
    | 类型 | 一串 |
    | 默认值 | `[无]` |

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

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

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

    | 命令行格式 | `--默认额外文件=路径` |
    | ----- | ------------- |
    | 类型 | 一串 |
    | 默认值 | `[无]` |

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

-   [](<>) `--默认组后缀`

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

    | 命令行格式 | `--默认组后缀=字符串` |
    | ----- | ------------- |
    | 类型 | 一串 |
    | 默认值 | `[无]` |

    同时阅读带有concat（组，后缀）的组。

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

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

    | 命令行格式 | `--登录路径=路径` |
    | ----- | ----------- |
    | 类型 | 一串 |
    | 默认值 | `[无]` |

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

-   [](<>) `--救命`

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

    | 命令行格式 | `--救命` |
    | ----- | ------ |

    显示帮助文本并退出。

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

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

    | 命令行格式 | `--连接字符串=连接字符串` |
    | ----- | --------------- |
    | 类型 | 一串 |
    | 默认值 | `[无]` |

    等同于[`--ndb连接字符串`](mysql-cluster-programs-ndb-config.html#option_ndb_config_ndb-connectstring).

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

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

    | 命令行格式 | `--ndb mgmd主机=连接\u字符串` |
    | ----- | ---------------------- |
    | 类型 | 一串 |
    | 默认值 | `[无]` |

    等同于[`--ndb连接字符串`](mysql-cluster-programs-ndb-config.html#option_ndb_config_ndb-connectstring).

-   [](<>) `--ndb节点ID`

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

    | 命令行格式 | `--ndb节点ID=#` |
    | ----- | ------------- |
    | 类型 | 整数 |
    | 默认值 | `[无]` |

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

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

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

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

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

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

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

    | 命令行格式 | `--字符集dir=path` |
    | ----- | --------------- |

    包含字符集的目录。

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

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

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

    放弃之前重试连接的次数。

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

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

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

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

-   [](<>) `--ndb优化节点选择`

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

    | 命令行格式 | `--ndb优化节点选择` |
    | ----- | ------------- |

    启用事务节点选择的优化。默认启用；使用`--跳过ndb优化节点选择`禁用。

    结合其他[**ndb\_配置**](mysql-cluster-programs-ndb-config.html)选项（例如[`--询问`](mysql-cluster-programs-ndb-config.html#option_ndb_config_query)或[`--类型`](mysql-cluster-programs-ndb-config.html#option_ndb_config_type))与`--配置信息`（带或不带`--xml`选项不受支持。目前，如果你试图这么做，通常的结果是除了`--配置信息`或`--xml`这些都被忽略了。*然而，这种行为不保证，随时可能发生变化*.此外，自从[**ndb\_配置**](mysql-cluster-programs-ndb-config.html)，与`--配置信息`选项，不访问NDB群集或读取任何文件，尝试指定其他选项，例如`--ndb连接字符串`或`--配置文件`具有`--配置信息`毫无用处。

#### 例子

1.  要获取群集中每个节点的节点ID和类型，请执行以下操作：

    ```
    $> ./ndb_config --query=nodeid,type --fields=':' --rows='\n'
    1:ndbd
    2:ndbd
    3:ndbd
    4:ndbd
    5:ndb_mgmd
    6:mysqld
    7:mysqld
    8:mysqld
    9:mysqld
    ```

    在本例中，我们使用[`--田地`](mysql-cluster-programs-ndb-config.html#option_ndb_config_fields)使用冒号字符分隔每个节点的ID和类型的选项(`:`)，以及[`--排`](mysql-cluster-programs-ndb-config.html#option_ndb_config_rows)用于将每个节点的值放置在输出中的新行上的选项。

2.  要生成数据、SQL和API节点可用于连接到管理服务器的连接字符串，请执行以下操作：

    ```
    $> ./ndb_config --config-file=usr/local/mysql/cluster-data/config.ini \
    --query=hostname,portnumber --fields=: --rows=, --type=ndb_mgmd
    198.51.100.179:1186
    ```

3.  这是对[**ndb\_配置**](mysql-cluster-programs-ndb-config.html)仅检查数据节点（使用[`--类型`](mysql-cluster-programs-ndb-config.html#option_ndb_config_type)选项），并显示每个节点的ID和主机名的值，以及为其设置的值[`数据存储器`](mysql-cluster-ndbd-definition.html#ndbparam-ndbd-datamemory)和[`数据目录`](mysql-cluster-ndbd-definition.html#ndbparam-ndbd-datadir)参数：

    ```
    $> ./ndb_config --type=ndbd --query=nodeid,host,datamemory,datadir -f ' : ' -r '\n'
    1 : 198.51.100.193 : 83886080 : /usr/local/mysql/cluster-data
    2 : 198.51.100.112 : 83886080 : /usr/local/mysql/cluster-data
    3 : 198.51.100.176 : 83886080 : /usr/local/mysql/cluster-data
    4 : 198.51.100.119 : 83886080 : /usr/local/mysql/cluster-data
    ```

    在本例中，我们使用了短选项`-f`和`-r`用于分别设置字段分隔符和行分隔符，以及short选项`-q`传递要获取的参数列表。

4.  要排除除特定主机之外的任何主机的结果，请使用[`--主人`](mysql-cluster-programs-ndb-config.html#option_ndb_config_host)选项：

    ```
    $> ./ndb_config --host=198.51.100.176 -f : -r '\n' -q id,type
    3:ndbd
    5:ndb_mgmd
    ```

    在本例中，我们还使用了缩写形式`-q`确定要查询的属性。

    类似地，可以使用[`--诺代德`](mysql-cluster-programs-ndb-config.html#option_ndb_config_nodeid)选项