--character-sets-dir

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

cluster-config-suffix

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

--configinfo

Параметр --configinfo приводит к тому, что ndb_config выводит список каждого параметра конфигурации кластера NDB, поддерживаемого дистрибутивом NDB Cluster, частью которого является 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/9.2,(null)
DataDir,/local/data/9.2,.
DataMemory,2G,98M
FileSystemPath,/local/data/9.2,(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/9.2,(null)
DataDir,/local/data/9.2.
DataMemory,2G,98M
FileSystemPath,/local/data/9.2,(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/9.2

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

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

--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», и Раздел 25.4.3.12, «Подключения NDB Cluster с общей памятью» для получения дополнительной информации).

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

--core-file

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

--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 (идентификатор узла), тип (тип узла — то есть, ndbd, mysqld или ndb_mgmd) и любые параметры конфигурации, значения которых необходимо получить.

Например, --query=nodeid,type,datamemory,datadir возвращает идентификатор узла, тип узла, 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 --configinfo для вывода в формате 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-кластера при компиляции ndb_config. Поэтому подключение к работающему кластеру NDB или доступ к файлам config.ini или my.cnf не требуется для этих двух параметров.