Для поддержки кластера NDB необходимо обновить my.cnf, как показано в следующем примере. Вы также можете указать эти параметры в командной строке при вызове исполняемых файлов.

# 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».)

# 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

Также можно использовать отдельный раздел [mysql_cluster] в файле конфигурации кластера my.cnf для параметров, которые будут читаться и использоваться всеми исполняемыми файлами:

# cluster-specific settings
[mysql_cluster]
ndb-connectstring=ndb_mgmd.mysql.com:1186

Для дополнительных переменных NDB, которые можно установить в файле my.cnf, см. раздел 25.4.3.9.2 «Переменные системы кластера NDB».

Файл глобальной конфигурации кластера NDB по умолчанию имеет имя config.ini (но это необязательно). При необходимости он читается ndb_mgmd при запуске и может быть размещён в любом расположении, доступном для него. Местоположение и имя конфигурации указываются с помощью --config-file=path_name с ndb_mgmd в командной строке. Этот параметр не имеет значения по умолчанию и игнорируется, если ndb_mgmd использует кэш конфигурации.

Глобальный файл конфигурации для кластера NDB использует формат INI, который состоит из разделов, начинающихся с заголовков разделов (в квадратных скобках), за которыми следуют соответствующие имена параметров и значения. Одно отличие от стандартного формата INI заключается в том, что имя параметра и значение могут быть разделены двоеточием (:), а также знаком равенства (=); однако знак равенства предпочтительнее. Другое отличие состоит в том, что разделы не уникально идентифицируются по имени раздела. Вместо этого уникальные разделы (например, два разных узла одного типа) идентифицируются уникальным идентификатором, указанным в качестве параметра внутри раздела.

Для большинства параметров определены значения по умолчанию, которые также можно указать в config.ini. Чтобы создать раздел со значением по умолчанию, просто добавьте слово default в имя раздела. Например, раздел [ndbd] содержит параметры, относящиеся к конкретному узлу данных, а раздел [ndbd default] содержит параметры, относящиеся ко всем узлам данных. Предположим, что все узлы данных должны использовать одинаковый размер памяти данных. Чтобы их все настроить, создайте раздел [ndbd default], который содержит строку DataMemory для указания размера памяти данных.

Если используется, раздел [ndbd default] должен предшествовать любым разделам [ndbd] в файле конфигурации. Это также верно для разделов default любого другого типа.

Файл глобальной конфигурации должен определять компьютеры и узлы, вовлечённые в кластер, и на каких компьютерах эти узлы расположены. Здесь показан пример простого файла конфигурации для кластера, состоящего из одного сервера управления, двух узлов данных и двух серверов 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

Каждый узел имеет свой собственный раздел в файле config.ini. Например, этот кластер имеет два узла данных, поэтому в предыдущем файле конфигурации содержатся два раздела [ndbd], определяющие эти узлы.

Разделы файла config.ini

В файле конфигурации config.ini можно использовать шесть различных разделов, как описано в следующем списке:

Можно определять default значения для каждого раздела. Если используется, раздел default должен предшествовать любым другим разделам этого типа. Например, раздел [ndbd default] должен появляться в файле конфигурации перед любыми разделами [ndbd].

Имена параметров кластера NDB не чувствительны к регистру, если не указано в файлах MySQL Server my.cnf или my.ini.