MySQL:: MySQL 5.6参考手册::18.5.7 ndb_config -提取NDB集群配置信息

版本5.6

8.0当前
5.7

8.0日本
5.6日本

MySQL 5.6参考手册/.．./ ndb_config -提取NDB集群配置信息

18.5.7 ndb_config—提取NDB集群配置信息

该工具从多个来源之一提取数据节点、SQL节点和API节点的当前配置信息:NDB集群管理节点或其config.ini或my.cnf文件。默认情况下，管理节点是配置数据的来源;要覆盖默认值，请使用——配置文件或——mycnf选择。还可以通过用指定其节点ID来使用数据节点作为源——config_from_node =node_id．

ndb_config还可以提供可使用的所有配置参数的脱机转储，以及它们的缺省值、最大值和最小值以及其他信息。转储可以以文本或XML格式生成;有关更多信息，请参见——configinfo而且——xml本节后面的选项)。

您可以按部分(DB，系统,或连接)使用其中一个选项——节点，——系统,或——连接．

可用于。的选项ndb_config如下表所示。其他描述见下表。

表18.22 ndb_config程序使用的命令行选项

格式	描述	已添加、已弃用或已移除
`——character-sets-dir =路径`	包含字符集的目录	(基于MySQL 5.6的所有NDB版本都支持)
`——配置文件= file_name`	设置路径为config.ini文件	(基于MySQL 5.6的所有NDB版本都支持)
`——config-from-node = #`	从具有此ID的节点(必须是数据节点)获取配置数据	(基于MySQL 5.6的所有NDB版本都支持)
`——configinfo`	以文本格式转储所有NDB配置参数信息，包括默认值、最大值和最小值。与——xml一起使用可获得xml输出	(基于MySQL 5.6的所有NDB版本都支持)
`——连接`	只打印集群配置文件中[tcp]、[tcp default]、[sci]、[sci default]、[shm]、[shm default]部分的连接信息。不能与——system或——nodes一起使用	(基于MySQL 5.6的所有NDB版本都支持)
`——connect-retries = #`	在放弃连接之前重试连接的次数	补充:NDB 7.4.9
`——connect-retry-delay = #`	两次尝试联系管理服务器之间等待的秒数	补充:NDB 7.4.9
`——连接字符串= connection_string`， `- c connection_string`	——ndb-connectstring一样	(基于MySQL 5.6的所有NDB版本都支持)
`——核心文件`	写核心文件出错;用于调试	(基于MySQL 5.6的所有NDB版本都支持)
`——defaults-extra-file =路径`	在读取全局文件之后读取给定文件	(基于MySQL 5.6的所有NDB版本都支持)
`——defaults-file =路径`	只从给定的文件读取默认选项	(基于MySQL 5.6的所有NDB版本都支持)
`——defaults-group-suffix =字符串`	也可以用concat(group，后缀)读取组	(基于MySQL 5.6的所有NDB版本都支持)
`——diff-default`	只打印具有非默认值的配置参数	补充:NDB 7.4.16
`——字段=字符串`， `- f`	字段分隔符	(基于MySQL 5.6的所有NDB版本都支持)
`——帮助`， `-？`	显示帮助文本并退出	(基于MySQL 5.6的所有NDB版本都支持)
`——主机=名`	指定主机	(基于MySQL 5.6的所有NDB版本都支持)
`——登录路径=路径`	从登录文件读取给定路径	(基于MySQL 5.6的所有NDB版本都支持)
`——mycnf`	从my.cnf文件读取配置数据	(基于MySQL 5.6的所有NDB版本都支持)
`——ndb-connectstring = connection_string`， `- c connection_string`	设置连接ndb_mgmd的连接字符串。语法:“[nodeid = id;][主机=]主机名(港口):”。覆盖NDB_CONNECTSTRING和my.cnf中的条目	(基于MySQL 5.6的所有NDB版本都支持)
`——ndb-mgmd-host = connection_string`， `- c connection_string`	——ndb-connectstring一样	(基于MySQL 5.6的所有NDB版本都支持)
`——ndb-nodeid = #`	设置此节点的节点ID，覆盖由——db-connectstring设置的任何ID	(基于MySQL 5.6的所有NDB版本都支持)
`——ndb-optimized-node-selection`	为事务的节点选择启用优化。默认启用;使用——skip-ndb-optimized-node-selection禁用	(基于MySQL 5.6的所有NDB版本都支持)
`——已`	不从除登录文件以外的任何选项文件读取默认选项	(基于MySQL 5.6的所有NDB版本都支持)
`——nodeid = #`， `- - - id #`(< = 7.5.0)	获取具有此ID的节点的配置	(基于MySQL 5.6的所有NDB版本都支持)
`——节点`	只打印节点信息(集群配置文件的[ndbd]或[ndbd default]部分)。不能与——system或——connections一起使用	(基于MySQL 5.6的所有NDB版本都支持)
`——查询=字符串`， `q字符串`	一个或多个查询选项(属性)	(基于MySQL 5.6的所有NDB版本都支持)
`——查询所有`， `——一个`	将所有参数和值转储为一个逗号分隔的字符串	(基于MySQL 5.6的所有NDB版本都支持)
`——print-defaults`	打印程序参数列表并退出	(基于MySQL 5.6的所有NDB版本都支持)
`——行=字符串`， `- r字符串`	行分隔符	(基于MySQL 5.6的所有NDB版本都支持)
`——系统`	只打印SYSTEM部分信息(参见ndb_config——configinfo output)。不能与——node或——connections一起使用	(基于MySQL 5.6的所有NDB版本都支持)
`——类型=名称`	指定节点类型	(基于MySQL 5.6的所有NDB版本都支持)
`——使用`， `-？`	显示帮助文本并退出;一样,帮助	(基于MySQL 5.6的所有NDB版本都支持)
`——版本`， `- v`	显示版本信息并退出	(基于MySQL 5.6的所有NDB版本都支持)
`——configinfo xml`	使用——xml和——configinfo来获取所有NDB配置参数的xml格式转储，包括默认值、最大值和最小值	(基于MySQL 5.6的所有NDB版本都支持)

——character-sets-dir

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

包含字符集的目录。

——configinfo

的——configinfo选择的原因ndb_config命令，转储该NDB集群分布支持的每个NDB集群配置参数列表ndb_config是一部分，包括以下信息:

对每个参数的用途、效果和用法的简要描述
的部分config.ini可以使用参数的文件
参数的数据类型或度量单位
如果适用，参数的默认值、最小值和最大值
NDB集群发布版本和构建信息

默认情况下，此输出为文本格式。部分输出如下所示:

$> ndb_config——configinfo ****** SYSTEM ****** Name (String)系统名称(NDB集群)必选PrimaryMGMNode(非负整数)主ndb_mgmd(MGM)节点id默认值:0(最小值:0，最大值:4294967039)ConfigGenerationNumber(非负整数)配置代号默认值:0(最小值:0，最大值:4294967039)****** DB ****** MaxNoOfSubscriptions(非负整数)最大订阅数(默认0 == MaxNoOfTables)默认值:0(最小值:0，最大值:4294967039)4294967039) maxnoofsubscriptions (Non-negative Integer)最大订阅数(默认0 == 2 * MaxNoOfTables)默认值:0(最小值:0，最大值:4294967039)…

选项一起使用此选项——xml选项以获取XML格式的输出。

——配置文件=path-to-file

命令行格式	`——配置文件= file_name`
类型	文件名称
默认值

提供管理服务器的配置文件的路径(config.ini)．这可能是相对路径，也可能是绝对路径。如果管理节点与管理节点不在同一台主机上ndb_config调用时，则必须使用绝对路径。

——config_from_node = #

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

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

如果具有此ID的节点不是数据节点，ndb_config失败，出现错误。(如果要从管理节点获取配置数据，只需忽略此选项。)

——连接

命令行格式	`——连接`

告诉ndb_config打印连接类中找到的有关参数的信息(tcp)，(tcp违约)，(shm),或(单孔位微吹气扰动违约)集群配置文件的部分(参见第18.4.3.9节“NDB集群TCP/IP连接”,第18.4.3.11节“NDB集群共享内存连接”，以获取更多资料)。

这个选项是互斥的——节点而且——系统；只能使用这3个选项中的一个。

——connect-retries

命令行格式	`——connect-retries = #`
介绍了	5.6.28-ndb-7.4.9
类型	整数
默认值	`12`
最小值	`0`
最大值	`12`

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

——connect-retry-delay

命令行格式	`——connect-retry-delay = #`
介绍了	5.6.28-ndb-7.4.9
类型	整数
默认值	`5`
最小值	`0`
最大值	`5`

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

——连接字符串

命令行格式	`——连接字符串= connection_string`
类型	字符串
默认值	`(没有)`

一样——ndb-connectstring．

——核心文件

命令行格式	`——核心文件`

写核心文件出错;用于调试。

——defaults-extra-file

命令行格式	`——defaults-extra-file =路径`
类型	字符串
默认值	`(没有)`

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

——defaults-file

命令行格式	`——defaults-file =路径`
类型	字符串
默认值	`(没有)`

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

——defaults-group-suffix

命令行格式	`——defaults-group-suffix =字符串`
类型	字符串
默认值	`(没有)`

也可以用concat(group，后缀)读取组。

——diff-default

命令行格式	`——diff-default`
介绍了	5.6.36-ndb-7.4.16

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

——字段=分隔符，- f分隔符

命令行格式	`——字段=字符串`
类型	字符串
默认值

指定一个分隔符用于分隔结果中的字段的字符串。默认值是，(逗号字符)。

请注意

如果分隔符包含空格或转义(例如\ n对于换行字符)，则必须用引号括起来。

——帮助

命令行格式	`——帮助`

显示帮助文本并退出。

——主机=主机名

命令行格式	`——主机=名`
类型	字符串
默认值

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

请注意

而主机名本地主机通常解析为IP地址127.0.0.1，这可能并不一定适用于所有操作平台和配置。这意味着它是可能的，当本地主机被用在config.ini,因为ndb_config——主机= localhost失败如果ndb_config在不同的主机上运行本地主机解析到不同的地址(例如，在某些版本的SUSE Linux上，这是127.0.0.2)．一般来说，为了达到最佳效果，您应该为与主机相关的所有NDB集群配置值使用数字IP地址，或者验证所有NDB集群主机处理本地主机以同样的方式。

——登录路径

命令行格式	`——登录路径=路径`
类型	字符串
默认值	`(没有)`

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

——mycnf

命令行格式	`——mycnf`

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

——ndb-connectstring =connection_string，- cconnection_string

命令行格式	`——ndb-connectstring = connection_string`
类型	字符串
默认值	`(没有)`

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

——ndb-mgmd-host

命令行格式	`——ndb-mgmd-host = connection_string`
类型	字符串
默认值	`(没有)`

一样——ndb-connectstring．

——ndb-nodeid

命令行格式	`——ndb-nodeid = #`
类型	整数
默认值	`(没有)`

设置此节点的节点ID，覆盖由——ndb-connectstring．

——ndb-optimized-node-selection

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

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

——已

命令行格式	`——已`

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

——nodeid =node_id

命令行格式	`——ndb-nodeid = #`
类型	整数
默认值	`(没有)`

指定需要获取配置信息的节点ID。以前,- - - id可以用作此选项的同义词;在NDB 7.5及以后版本中，唯一被接受的形式是——nodeid．

——节点

命令行格式	`——节点`

告诉ndb_config控件中定义的参数的相关信息(ndbd)或(ndbd违约)集群配置文件的部分(参见第18.4.3.6节“定义NDB集群数据节点”)．

这个选项是互斥的——连接而且——系统；只能使用这3个选项中的一个。

——查询=查询选项，q查询选项

命令行格式	`——查询=字符串`
类型	字符串
默认值

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

例如,——查询= nodeid类型、datamemory datadir返回节点ID，节点类型，DataMemory,DataDir为每个节点。

以前,id被认为是?的同义词nodeid，但已在NDB 7.5及后续版本中删除。

请注意

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

——查询所有，——一个

命令行格式	`——查询所有`

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

此选项在NDB 7.5.7 (Bug #60095, Bug #11766869)中引入。

——print-defaults

命令行格式	`——print-defaults`

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

——行=分隔符，- r分隔符

命令行格式	`——行=字符串`
类型	字符串
默认值

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

请注意

如果分隔符包含空格或转义(例如\ n对于换行字符)，则必须用引号括起来。

——系统

命令行格式	`——系统`

告诉ndb_config打印系统信息只。这包括在运行时不能更改的系统变量;因此，在集群配置文件中没有对应的部分。他们可以看到(以* * * * * * * * * * * *系统的输出ndb_config——configinfo．

这个选项是互斥的——节点而且——连接；只能使用这3个选项中的一个。

——类型=node_type

命令行格式	`——类型=名称`
类型	枚举
默认值	`(没有)`
有效值	`ndbd` `mysqld` `ndb_mgmd`

筛选结果，以便仅应用于指定节点的配置值node_type（ndbd，mysqld,或ndb_mgmd返回)。

——使用，——帮助,或-？

命令行格式	`——帮助`

原因ndb_config打印可用选项的列表，然后退出。的同义词——帮助．

——版本，- v

命令行格式	`——版本`

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

——configinfo——xml

命令行格式	`——configinfo xml`

导致ndb_config——configinfo通过添加此选项来提供XML格式的输出。这类输出的一部分如下例所示:

$> ndb_config——configinfo——xml      
    …

请注意

通常，由生成的XML输出ndb_config——configinfo——xml每个元素使用一行进行格式化;为了便于阅读，我们在上一个示例和下一个示例中添加了额外的空白。这应该不会对使用此输出的应用程序造成任何影响，因为大多数XML处理器要么理所当然地忽略不必要的空白，要么可以被指示这样做。

方法重新启动数据节点时，XML输出还指明更改给定参数是否需要使用——初始选择。这可以通过一个初始= " true "属性中对应的<参数>元素。此外，重启类型(系统或节点)亦显示;如果一个给定的参数需要重新启动系统，这将通过一个重启= "系统"属性中对应的<参数>元素。的值集无盘参数需要系统初始重新启动，如图所示(使用重新启动而且最初的属性高亮显示的可见性):

最初重启= "系统" = " true "/>

目前,没有最初的属性包含在的XML输出中<参数>与不需要初始重启的参数对应的元素;换句话说,初始= " false "是默认值，而值呢假如果属性不存在，则假定为。类似地，缺省重启类型为节点(即在线或”滚动”重新启动集群)，但是重新启动属性仅当重新启动类型为时才包含系统(这意味着所有集群节点必须同时关闭，然后重新启动)。

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

弃用= " true "/>

在这种情况下，评论引用取代已弃用参数的一个或多个参数。类似于最初的,弃用属性仅在不赞成使用该参数时使用弃用= " true "，对于未弃用的参数则完全不出现。(错误# 21127135)

从NDB 7.5.0开始，所需的参数用强制= " true "，如下所示:

强制= " true "min = " 1 " max = " 255 " / >

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

重要的

的——xml选项只能与——configinfo选择。使用——xml没有——configinfo失败，出现错误。

与此程序用于获取当前配置数据的选项不同，——configinfo而且——xml使用从NDB集群源获取的信息ndb_config是编译。因此，不能连接到正在运行的NDB集群，也不能访问config.ini或my.cnf这两个选项都需要文件。

结合其他ndb_config选项(如——查询或——类型),——configinfo(with或without the——xml选项)不支持。目前，如果您试图这样做，通常的结果是所有其他选项——configinfo或——xml只是忽略了。然而，这种行为并不能得到保证，随时都可能发生变化．此外,由于ndb_config，当与the连用时——configinfo选项，不访问NDB集群或读取任何文件，试图指定其他选项，例如——ndb-connectstring或——配置文件与——configinfo没有目的。

例子

获取集群中每个节点的节点ID和节点类型。
```
$> ./ndb_config -q nodeid,type——fields=':'——rows='\n' 1:ndbd 2:ndbd 3:ndbd 4:ndbd 5:ndb_mgmd 6:mysqld 7:mysqld 8:mysqld 9:mysqld
```
在本例中，我们使用——字段选项，用冒号分隔每个节点的节点ID和类型(：),——行选项将每个节点的值放在输出中的新行上。

使用实例生成一个连接字符串，用于数据节点、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

这个调用ndb_config只检查数据节点(使用——类型选项)，并显示每个节点的ID和主机名的值，以及为其设置的值DataMemory，IndexMemory,DataDir参数:

>美元。/ ndb_config - type = ndbd查询= nodeid,主机,datamemory, indexmemory, datadir - f‘:’- r ' \ n ' 1: 198.51.100.193: 83886080: 18874368: /usr/local/mysql/cluster-data 2: 198.51.100.112: 83886080: 18874368: /usr/local/mysql/cluster-data 3: 198.51.100.176: 83886080: 18874368: /usr/local/mysql/cluster-data 4: 198.51.100.119: 83886080: 18874368: /usr/local/mysql/cluster-data

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

要排除来自除特定主机外的任何主机的结果，请使用——主机选择:
```
$> ./ndb_config——host=198.51.100.176 -f: -r '\n' -q id,type 3:ndbd 5:ndb_mgmd
```
在这个例子中，我们也使用了缩写形式q确定要查询的属性。
类将结果限制到具有特定ID的节点——nodeid选择。

上一页首页向上下一个