要支持 NDB Cluster,您必须
my.cnf
按照以下示例所示进行更新。您还可以在调用可执行文件时在命令行上指定这些参数。
此处显示的选项不应与config.ini
全局配置文件中使用的选项混淆。全局配置选项将在本节后面讨论。
# my.cnf
# example additions to my.cnf for NDB Cluster
# (valid in MySQL 5.7)
# 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
(有关连接字符串的更多信息,请参阅 第 21.4.3.3 节,“NDB Cluster 连接字符串”。)
# 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
如前所示,一旦您使用文件中的和
参数
启动了mysqld进程
,您就无法在
没有实际启动集群的情况下执行任何or
语句。否则,这些语句会因错误而失败。这是设计使然。
NDBCLUSTER
ndb-connectstring
[mysqld]
my.cnf
CREATE TABLE
ALTER TABLE
您还可以[mysql_cluster]
在集群my.cnf
文件中使用一个单独的部分来设置所有可执行文件读取和使用的设置:
# cluster-specific settings
[mysql_cluster]
ndb-connectstring=ndb_mgmd.mysql.com:1186
有关NDB
可以在my.cnf
文件中设置的其他变量,请参阅
第 21.4.3.9.2 节,“NDB Cluster 系统变量”。
NDB Cluster 全局配置文件按照约定命名
config.ini
(但这不是必需的)。如果需要,它在启动时由ndb_mgmd读取,并且可以放在它可以读取的任何位置。配置的位置和名称
在命令行上使用
with ndb_mgmd指定。此选项没有默认值,如果
ndb_mgmd使用配置缓存,则会被忽略。
--config-file=
path_name
NDB Cluster 的全局配置文件使用 INI 格式,它由以节标题(用方括号括起来)开头的节组成,后跟适当的参数名称和值。与标准 INI 格式的一个偏差是参数名称和值可以用冒号 ( :
) 和等号 ( =
) 分隔;但是,最好使用等号。另一个偏差是部分不是由部分名称唯一标识的。相反,唯一部分(例如相同类型的两个不同节点)由指定为部分内参数的唯一 ID 标识。
大多数参数都定义了默认值,也可以在config.ini
. 要创建默认值部分,只需将单词添加
default
到部分名称即可。例如,一个
[ndbd]
部分包含适用于特定数据节点的[ndbd
default]
参数,而一个部分包含适用于所有数据节点的参数。假设所有数据节点应该使用相同的数据内存大小。要配置它们,请创建一个[ndbd
default]
部分,其中包含
DataMemory
一行以指定数据存储器大小。
如果使用,该[ndbd default]
部分必须位于[ndbd]
配置文件中的任何部分之前。default
对于任何其他类型
的部分也是如此
。
在 NDB Cluster 的一些旧版本中,没有默认值
,总是必须在sectionNoOfReplicas
中明确指定。[ndbd
default]
尽管此参数现在具有默认值 2,这是大多数常见使用场景中的推荐设置,但仍建议您显式设置此参数。
全局配置文件必须定义集群中涉及的计算机和节点以及这些节点位于哪些计算机上。此处显示了由一个管理服务器、两个数据节点和两个 MySQL 服务器组成的集群的简单配置文件示例:
# 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
前面的示例旨在作为熟悉 NDB Cluster 的最小启动配置,并且几乎可以肯定不足以用于生产设置。请参阅第 21.4.3.2 节,“NDB Cluster 的推荐启动配置”,它提供了更完整的示例启动配置。
config.ini
每个节点在文件
中都有自己的部分
。例如,这个集群有两个数据节点,所以前面的配置文件包含[ndbd]
定义这些节点的两个部分。
不要将注释与config.ini
文件中的节标题放在同一行;这会导致管理服务器无法启动,因为在这种情况下它无法解析配置文件。
config.ini 文件的部分
您可以在
config.ini
配置文件中使用六个不同的部分,如下表所述:
[computer]
:定义集群主机。这不是配置可行的 NDB Cluster 所必需的,但在设置大型集群时可以用作便利。有关更多信息,请参阅第 21.4.3.4 节,“在 NDB Cluster 中定义计算机”。[ndbd]
:定义一个集群数据节点(ndbd进程)。有关详细信息,请参阅 第 21.4.3.6 节,“定义 NDB Cluster 数据节点”。[mysqld]
:定义集群的 MySQL 服务器节点(也称为 SQL 或 API 节点)。有关 SQL 节点配置的讨论,请参阅 第 21.4.3.7 节,“在 NDB Cluster 中定义 SQL 和其他 API 节点”。[mgm]
或[ndb_mgmd]
:定义集群管理服务器 (MGM) 节点。有关管理节点配置的信息,请参阅第 21.4.3.5 节,“定义 NDB Cluster 管理服务器”。[tcp]
:定义集群节点之间的 TCP/IP 连接,TCP/IP 是默认传输协议。通常,不需要[tcp]
or[tcp default]
部分来设置 NDB Cluster,因为 cluster 会自动处理;但是,在某些情况下可能需要覆盖集群提供的默认值。有关可用的 TCP/IP 配置参数以及如何使用它们的信息,请参阅第 21.4.3.10 节,“NDB Cluster TCP/IP 连接” 。(在某些情况下,您可能还会 对第 21.4.3.11 节“使用直接连接的 NDB 集群 TCP/IP 连接”感兴趣。)[shm]
:定义节点之间的共享内存连接。在 MySQL 5.7 中,它默认启用,但仍应被视为实验性的。有关 SHM 互连的讨论,请参阅 第 21.4.3.12 节,“NDB Cluster 共享内存连接”。[sci]
:定义集群数据节点之间的可伸缩一致性接口连接。NDB 7.5 或 7.6 不支持。
您可以为每个部分定义default
值。如果使用,一个default
部分应该位于该类型的任何其他部分之前。例如,一个
[ndbd default]
部分应该出现在配置文件中的任何[ndbd]
部分之前。
NDB Cluster 参数名称不区分大小写,除非在 MySQL 服务器my.cnf
或
my.ini
文件中指定。