--字符集目录

包含字符集的目录。

集群配置后缀

覆盖默认组后缀时读取集群配置部分在 my.cnf 中；用于测试。

--配置信息

--配置信息 选项使 ndb_config 转储 NDB 集群配置参数的列表，包括以下信息：

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

$> 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 选项结合，以获取 XML 格式的输出。

--config-binary-file=路径-to-file

指定管理服务器的缓存二进制配置文件 (ndb_nodeID_config.bin.seqno) 的路径。可以是相对路径或绝对路径。如果管理服务器和 ndb_config 二进制文件位于不同的主机上，必须使用绝对路径。

以下示例演示了如何将 --config-binary-file 与其他 ndb_config 选项结合以获取有用的输出：

$> ndb_config --config-binary-file=../mysql-cluster/ndb_50_config.bin.1 --diff-default --type=ndbd
config of [DB] node id 5 that is different from default 
CONFIG_PARAMETER,ACTUAL_VALUE,DEFAULT_VALUE 
NodeId,5,(mandatory) 
BackupDataDir,/local/data/8.1,(null) 
DataDir,/local/data/8.1,. 
DataMemory,2G,98M 
FileSystemPath,/local/data/8.1,(null) 
HostName,127.0.0.1,localhost 
Nodegroup,0,(null) 
ThreadConfig,,(null) 

config of [DB] node id 6 that is different from default 
CONFIG_PARAMETER,ACTUAL_VALUE,DEFAULT_VALUE 
NodeId,6,(mandatory) 
BackupDataDir,/local/data/8.1,(null) 
DataDir,/local/data/8.1. 
DataMemory,2G,98M 
FileSystemPath,/local/data/8.1,(null) 
HostName,127.0.0.1,localhost 
Nodegroup,0,(null) 
ThreadConfig,,(null)

$> ndb_config --config-binary-file=../mysql-cluster/ndb_50_config.bin.1 --diff-default --system
config of [SYSTEM] system 
CONFIG_PARAMETER,ACTUAL_VALUE,DEFAULT_VALUE 
Name,MC_20220906060042,(mandatory) 
ConfigGenerationNumber,1,0 
PrimaryMGMNode,50,0

以下是 config.ini 文件的相关部分：

[ndbd default]
DataMemory= 2G
NoOfReplicas= 2

[ndb_mgmd]
NodeId= 50
HostName= 127.0.0.1

[ndbd]
NodeId= 5
HostName= 127.0.0.1
DataDir= /local/data/8.1

[ndbd]
NodeId= 6
HostName= 127.0.0.1
DataDir= /local/data/8.1

通过比较输出与配置文件，可以看到文件中的所有设置都被管理服务器写入二进制缓存，从而应用于集群。

--config-file=路径-to-file

指定集群配置文件 (config.ini) 的路径。可以是相对路径或绝对路径。如果管理服务器和 ndb_config 二进制文件位于不同的主机上，必须使用绝对路径。

--config_from_node=#

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

如果具有此 ID 的节点不是数据节点，ndb_config 将失败并显示错误。(要从管理节点获取配置数据，请省略此选项。)

--connect-retries

在放弃之前尝试连接的次数。

--connect-retry-delay

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

--connect-string

与 --ndb-connectstring 相同。

--connections

告诉ndb_config 只打印 CONNECTIONS 信息，即来自集群配置文件的 [tcp]、[tcp default]、[shm] 或 [shm default] 部分的参数信息（参见第 25.4.3.10 节，“NDB 集群 TCP/IP 连接” 和 第 25.4.3.12 节，“NDB 集群共享内存连接”，以获取更多信息）。

该选项与 --nodes 和 --system 互斥；只能使用这三个选项中的一个。

--core-file

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

--defaults-extra-file

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

--defaults-file

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

--defaults-group-suffix

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

--diff-default

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

--fields=delimiter, -f delimiter

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

--help

显示帮助文本并退出。

--host=hostname

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

--login-path

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

--mycnf

从 my.cnf 文件中读取配置数据。

--ndb-connectstring=connection_string, -c connection_string

指定连接到管理服务器的连接字符串。连接字符串的格式与 第 25.4.3.3 节“NDB 集群连接字符串” 中描述的相同，默认为 localhost:1186。

--ndb-mgm-tls

设置连接到管理服务器所需的 TLS 支持级别；可以是 relaxed 或 strict。relaxed（默认）表示尝试 TLS 连接，但不需要成功：strict 表示需要 TLS 连接。

--ndb-mgmd-host

与 --ndb-connectstring 相同。

--ndb-nodeid

设置当前节点的节点 ID，覆盖 --ndb-connectstring 设置的 ID。

--ndb-optimized-node-selection

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

--ndb-tls-search-path

指定要搜索的CA文件目录列表。在 Unix 平台上，目录名以冒号 (:) 分隔；在 Windows 系统上，使用分号 (;) 作为分隔符。目录引用可以是相对的或绝对的，可以包含一个或多个环境变量，每个变量以美元符号 ($) 开头，并在使用前展开。

搜索从左侧命名的目录开始，自左向右进行，直到找到文件。空字符串表示空搜索路径，导致所有搜索失败。点 (.) 表示搜索路径仅限于当前工作目录。

如果未提供搜索路径，则使用编译时的默认值。该值取决于平台：在 Windows 上为 \ndb-tls；在其他平台（包括 Linux）上为 $HOME/ndb-tls。这可以通过使用 -DWITH_NDB_TLS_SEARCH_PATH 编译 NDB Cluster 来覆盖。

--no-defaults

不从任何选项文件中读取默认选项，除了登录文件。

--no-login-paths

跳过从登录路径文件中读取选项。

--nodeid=node_id

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

--nodes

告诉 ndb_config 只打印在集群配置文件的 [ndbd] 或 [ndbd default] 部分中定义的参数信息（见 第 25.4.3.6 节，“Defining NDB Cluster Data Nodes”）。

该选项与 --connections 和 --system 互斥；只能使用这三个选项之一。

--print-defaults

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

--query=query-options, -q query-options

这是一个逗号分隔的查询选项列表，即要返回的节点属性列表。这些包括 nodeid（节点 ID）、type（节点类型，即 ndbd、mysqld 或 ndb_mgmd）和要获取的配置参数。

例如，--query=nodeid,type,datamemory,datadir 返回每个节点的节点 ID、节点类型、DataMemory 和 DataDir。

--query-all, -a

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

--行=separator, -r separator

指定用于分隔结果中的行的 separator 字符串。默认是一个空格字符。

--系统

告诉 ndb_config 只打印 SYSTEM 信息。这些信息是系统变量，不能在运行时更改；因此，在集群配置文件中没有相应的部分。它们可以在 ndb_config --configinfo 的输出中看到（以 ****** SYSTEM ****** 开头）。

这个选项与 --nodes 和 --connections 是互斥的；只能使用这三个选项中的一个。

--类型=node_type

过滤结果，以便只返回指定 node_type (ndbd, mysqld, 或 ndb_mgmd) 的配置值。

--usage, --help, 或 -?

使 ndb_config 打印可用选项的列表，然后退出。

--版本, -V

使 ndb_config 打印版本信息字符串，然后退出。

--configinfo --xml

使 ndb_config --configinfo 以 XML 格式提供输出，添加这个选项。以下是一个示例输出：

$> ndb_config --configinfo --xml

<configvariables protocolversion="1" ndbversionstring="5.7.44-ndb-7.5.32"
                    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>

XML 输出还指示更改给定参数时需要使用 --initial 选项重新启动数据节点。这在相应的 <param> 元素中显示为 initial="true" 属性。此外，重新启动类型（system 或 node）也显示；如果给定参数需要系统重新启动，则在相应的 <param> 元素中显示 restart="system" 属性。例如，改变 Diskless 参数的值需要系统初始重新启动，如下所示（restart 和 initial 属性突出显示以提高可读性）：

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

目前，对于不需要初始重新启动的参数，XML 输出中不包括 initial 属性；换言之，initial="false" 是默认值，如果属性不存在，则假定值为 false。类似地，默认重新启动类型是 node（即在线或“滚动”重新启动集群），但只有在重新启动类型为 system 时，才包括 restart 属性（即所有集群节点必须同时关闭，然后重新启动）。

已弃用的参数在 XML 输出中由 deprecated 属性指示，如下所示：

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

在这种情况下，comment 引用一个或多个超越弃用参数的参数。类似于 initial，deprecated 属性仅在参数弃用时显示，带有 deprecated="true"，并且对于未弃用的参数不出现。（Bug #21127135）

必需的参数用 mandatory="true" 指示，如下所示：

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

与 initial 或 deprecated 属性类似，mandatory 属性仅在给定参数实际需要时包含。

与用于获取当前配置数据的选项不同，--configinfo 和 --xml 使用在编译 ndb_config 时从 NDB 集群源获取的信息。因此，不需要连接到正在运行的 NDB 集群或访问 config.ini 或 my.cnf 文件。