Documentation Home
MySQL 8.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 39.8Mb
PDF (A4) - 39.9Mb
Man Pages (TGZ) - 257.9Kb
Man Pages (Zip) - 364.9Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 8.4 Reference Manual  /  ...  /  NDB Cluster Configuration: Basic Example

25.4.3.1 NDB 集群配置:基本示例

要支持 NDB 集群,您需要将my.cnf更新到以下示例中所示的方式。您也可以在启动可执行文件时指定这些参数。

Note

这里显示的选项不要与在config.ini全局配置文件中使用的选项混淆。全球配置选项将在本节后面讨论。

Press CTRL+C to copy
# my.cnf # example additions to my.cnf for NDB Cluster # (valid in MySQL 8.4) # enable ndbcluster storage engine, and provide connection string for # management server host (default port is 1186) [mysqld] ndbcluster ndb-connectstring=ndb_mgmd.mysql.com # provide connection string for management server host (default port: 1186) [ndbd] connect-string=ndb_mgmd.mysql.com # provide connection string for management server host (default port: 1186) [ndb_mgm] connect-string=ndb_mgmd.mysql.com # provide location of cluster configuration file # IMPORTANT: When starting the management server with this option in the # configuration file, the use of --initial or --reload on the command line when # invoking ndb_mgmd is also required. [ndb_mgmd] config-file=/etc/config.ini

(关于连接字符串的更多信息,请见第25.4.3.3节,“NDB 集群连接字符串”。)

Press CTRL+C to copy
# my.cnf # example additions to my.cnf for NDB Cluster # (works on all versions) # enable ndbcluster storage engine, and provide connection string for management # server host to the default port 1186 [mysqld] ndbcluster ndb-connectstring=ndb_mgmd.mysql.com:1186
Important

一旦您使用NDBCLUSTERndb-connectstring参数在my.cnf文件的[mysqld]部分启动了mysqld进程,您就不能执行任何CREATE TABLEALTER TABLE语句,除非您实际启动了集群。否则,这些语句将失败并显示错误。这是一种设计选择

您也可以在集群my.cnf文件的[mysql_cluster]部分使用一个独立的section来读取和使用所有可执行文件的设置:

Press CTRL+C to copy
# cluster-specific settings [mysql_cluster] ndb-connectstring=ndb_mgmd.mysql.com:1186

为了查看更多关于NDB变量的信息,请参阅第25.4.3.9.2节,“NDB Cluster System Variables”

NDB集群的全局配置文件通常命名为config.ini(但这不是必需的)。如果需要,它将在ndb_mgmd启动时被读取,可以放在--config-file=path_name命令行参数中指定的位置和名称。这个选项没有默认值,如果ndb_mgmd使用配置缓存,这个选项将被忽略。

NDB 集群的全局配置文件使用 INI 格式,该格式由以方括号开头的节区(surrounded by square brackets),后跟着相应的参数名称和值组成。INI 格式的一个偏离是,参数名称和值可以用冒点 (:) 和等号 (=) 分隔,但是等号被推荐使用。另一个偏离是,节区不由节名唯一标识,而是通过在节区中指定的唯一 ID 标识唯一节区(例如两个相同类型的节点)。

大多数参数都有默认值,可以在 config.ini 文件中指定。要创建一个默认值节区,只需将单词 default 添加到节名中。例如,[ndbd] 节包含特定数据节点的参数,而 [ndbd default] 节包含所有数据节点的参数。如果想让所有数据节点使用相同的数据内存大小,可以创建一个 [ndbd default] 节,并在其中添加一个 DataMemory 行来指定数据内存大小。

如果使用,[ndbd default] 节必须在配置文件中排在 [ndbd] 节之前。这同样适用于其他类型的默认节区。

Note

在 NDB 集群的某些较旧版本中,没有默认值 дляNoOfReplicas,因此总是需要在[ndbd default]部分中显式指定该参数。虽然这个参数现在有一个默认值为 2,但是大多数常见使用场景下推荐的设置仍然是明确地设置该参数。

全局配置文件必须定义参与集群的计算机和节点,以及这些节点在哪些计算机上运行。以下是一个简单的配置文件,用于一个由一个管理服务器、两个数据节点和两个 MySQL 服务器组成的集群:

Press CTRL+C to copy
# file "config.ini" - 2 data nodes and 2 SQL nodes # This file is placed in the startup directory of ndb_mgmd (the # management server) # The first MySQL Server can be started from any host. The second # can be started only on the host mysqld_5.mysql.com [ndbd default] NoOfReplicas= 2 DataDir= /var/lib/mysql-cluster [ndb_mgmd] Hostname= ndb_mgmd.mysql.com DataDir= /var/lib/mysql-cluster [ndbd] HostName= ndbd_2.mysql.com [ndbd] HostName= ndbd_3.mysql.com [mysqld] [mysqld] HostName= mysqld_5.mysql.com
Note

前面的示例旨为熟悉 NDB 集群的最小启动配置,但几乎肯定不能满足生产设置。请参阅第 25.4.3.2 节,“NDB 集群的推荐启动配置”,该节提供了一个更完整的示例启动配置。

每个节点都有自己的部分在config.ini文件中。例如,这个集群有两个数据节点,所以前面的配置文件包含两个[ndbd]部分,定义这些节点。

Note

不要将注释置于config.ini文件中的节头同一行上;这样会导致管理服务器无法启动,因为它不能解析这种配置文件。

config.ini配置文件中,您可以使用六种不同的部分,以下是这些部分的描述:

您可以为每个部分定义default值。如果使用,default部分应该在该类型的其他部分之前出现。例如,[ndbd default]部分在配置文件中应该出现在任何[ndbd]部分之前。

NDB集群参数名称是大小写不敏感的,除非在MySQL服务器中的my.cnfmy.ini文件中指定。