--character-sets-dir

Каталог, содержащий кодировки.

cluster-config-suffix

Переопределяет суффикс группы значений по умолчанию при чтении разделов конфигурации кластера в my.cnf; используется при тестировании.

--configinfo

Параметр --configinfo заставляет ndb_config выгрузить список каждого параметра конфигурации кластера NDB, поддерживаемого дистрибутивом кластера NDB, частью которого является ndb_config, включая следующую информацию:

По умолчанию этот вывод находится в текстовом формате. Часть этого вывода показана здесь:

$> 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=path-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.4,(null)
DataDir,/local/data/8.4,.
DataMemory,2G,98M
FileSystemPath,/local/data/8.4,(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.4,(null)
DataDir,/local/data/8.4.
DataMemory,2G,98M
FileSystemPath,/local/data/8.4,(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.4

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

Сравнивая вывод с файлом конфигурации, можно увидеть, что все настройки в файле были записаны сервером управления в двоичный кэш и, таким образом, применены к кластеру.

--config-file=path-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 Cluster TCP/IP Connections», и Раздел 25.4.3.12, «NDB Cluster Shared-Memory Connections», для получения дополнительной информации).

Этот параметр взаимоисключающий с --nodes и --system; можно использовать только один из этих 3 параметров.

--core-file

Записать файл core при ошибке; используется при отладке.

--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 Cluster», и по умолчанию равно localhost:1186.

--ndb-mgm-tls

Задает уровень поддержки TLS, необходимый для подключения к серверу управления; одно из relaxed или strict. relaxed (по умолчанию) означает, что попытка соединения TLS предпринимается, но успех не обязателен; strict означает, что для подключения требуется TLS.

--ndb-mgmd-host

То же, что и --ndb-connectstring.

--ndb-nodeid

Устанавливает идентификатор узла для этого узла, переопределяя любой идентификатор, установленный --ndb-connectstring.

--ndb-optimized-node-selection

Включить оптимизацию выбора узлов для транзакций. Включено по умолчанию; используйте --skip-ndb-optimized-node-selection для отключения.

--ndb-tls-search-path

Укажите список каталогов для поиска файла CA. На платформах Unix имена каталогов разделяются двоеточиями (:); в системах Windows точкой с запятой (;) используется в качестве разделителя. Ссылка на каталог может быть относительной или абсолютной; она может содержать одну или несколько переменных среды, каждая из которых обозначается предшествующим знаком доллара ($), и расширяется перед использованием.

Поиск начинается с самого левого именованного каталога и продолжается слева направо, пока не будет найден файл. Пустая строка обозначает пустой путь поиска, что приводит к сбою всех поисков. Строка, состоящая из одной точки (.), указывает, что путь поиска ограничен текущим рабочим каталогом.

Если путь поиска не указан, используется встроенное значение по умолчанию. Это значение зависит от используемой платформы: в Windows это \ndb-tls; на других платформах (включая Linux) это $HOME/ndb-tls. Это можно переопределить, скомпилировав NDB Cluster с использованием -DWITH_NDB_TLS_SEARCH_PATH.

--no-defaults

Не читать параметры по умолчанию из любого файла параметров, кроме файла входа.

--no-login-paths

Пропускает чтение параметров из файла пути входа.

--nodeid=node_id

Указывает ID узла, для которого необходимо получить информацию о конфигурации.

--nodes

Указывает ndb_config вывести информацию, относящуюся только к параметрам, определенным в разделе [ndbd] или [ndbd default] файла конфигурации кластера (см. Раздел 25.4.3.6, «Определение узлов данных кластера NDB»).

Эта опция взаимоисключающая с --connections и --system; можно использовать только один из этих 3 вариантов.

--print-defaults

Вывести список аргументов программы и завершить работу.

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

Это разделенный запятыми список параметров запроса—то есть список одного или нескольких атрибутов узла, которые должны быть возвращены. К ним относятся nodeid (ID узла), тип (тип узла—то есть, ndbd, mysqld или ndb_mgmd) и любые параметры конфигурации, значения которых необходимо получить.

Например, --query=nodeid,type,datamemory,datadir возвращает ID узла, тип узла, DataMemory и DataDir для каждого узла.

--query-all, -a

Возвращает разделенный запятыми список всех параметров запроса (атрибуты узла; обратите внимание, что этот список представляет собой одну строку.

--rows=separator, -r separator

Указывает separator строку, используемую для разделения строк в результате. Значение по умолчанию — пробел.

--system

Указывает ndb_config вывести только информацию о SYSTEM. Это системные переменные, которые нельзя изменить во время выполнения; таким образом, для них нет соответствующего раздела файла конфигурации кластера. Их можно увидеть (с префиксом ****** SYSTEM ******) в выводе ndb_config --configinfo.

Эта опция взаимоисключающая с --nodes и --connections; можно использовать только один из этих 3 вариантов.

--type=node_type

Фильтрует результаты так, чтобы возвращались только значения конфигурации, применяемые к узлам указанного node_type (ndbd, mysqld или ndb_mgmd).

--usage, --help, или -?

Заставляет ndb_config вывести список доступных параметров и завершить работу.

--version, -V

Заставляет ndb_config вывести строку информации о версии и завершить работу.

--configinfo --xml

Причиной для того, чтобы команда ndb_config выводила результат в формате XML, является добавление этого параметра. Часть такого вывода показана в этом примере:

$> ndb_config --configinfo --xml

<configvariables protocolversion="1" ndbversionstring="5.7.44-ndb-7.5.36"
                    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. Это показано наличием атрибута initial="true" в соответствующем элементе <param>. Кроме того, отображается тип перезапуска (system или node); если для изменения параметра требуется перезапуск системы, это указывается наличием атрибута restart="system" в соответствующем элементе <param>. Например, изменение значения параметра Diskless требует начального перезапуска системы, как показано здесь (с выделенными атрибутами restart и initial):

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

В настоящее время атрибут initial не включён в XML-вывод для элементов <param>, соответствующих параметрам, не требующим начального перезапуска; другими словами, initial="false" является значением по умолчанию, и значение false следует считать, если атрибут отсутствует. Аналогично, значением перезапуска по умолчанию является node (то есть, онлайн или “поэтапный” перезапуск кластера), но атрибут restart включён только в том случае, если тип перезапуска является system (то есть, все узлы кластера должны быть остановлены одновременно, а затем перезапущены).

Устаревшие параметры указываются в XML-выводе атрибутом deprecated, как показано здесь:

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

В таких случаях, comment ссылается на один или несколько параметров, которые заменяют устаревший параметр. Аналогично initial, атрибут deprecated указывается только при устаревании параметра, со значением deprecated="true", и не отображается для параметров, которые не устарели. (Ошибка #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 Cluster во время компиляции ndb_config. По этой причине подключение к работающему NDB Cluster или доступ к файлам config.ini или my.cnf не требуется для этих двух параметров.