21.5.7 ndb_config — Извлечение информации о конфигурации кластера NDB
Этот инструмент извлекает текущую информацию о конфигурации узлов данных, узлов SQL и узлов API из одного из нескольких источников: узел управления кластером NDB или его config.ini или my.cnf файл. По умолчанию источником данных конфигурации является узел управления; для переопределения значения по умолчанию выполните ndb_config с параметром --config-file или --mycnf. Также можно использовать узел данных в качестве источника, указав его идентификатор узла с помощью --config_from_node=. node_id
ndb_config также может предоставить автономную копию всех параметров конфигурации, которые можно использовать вместе с их значениями по умолчанию, максимальными и минимальными значениями и другой информацией. Копию можно создать в текстовом или XML формате; для получения дополнительной информации см. обсуждение параметров --configinfo и --xml в этом разделе).
Вы можете фильтровать результаты по разделу (DB, SYSTEM или CONNECTIONS) с помощью одного из параметров --nodes, --system или --connections.
Параметры, которые можно использовать с ndb_config, показаны в следующей таблице. Дополнительные описания следуют за таблицей.
Таблица 21.27 Параметры командной строки, используемые с программой ndb_config
| Формат | Описание | Добавленные, устаревшие или удаленные |
|---|---|---|
| Директория, содержащая наборы символов | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Установить путь к файлу config.ini | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Получить данные конфигурации с узла, имеющего этот идентификатор (должен быть узлом данных) | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Выводит информацию обо всех параметрах конфигурации NDB в текстовом формате с указанием значений по умолчанию, максимальных и минимальных значений. Используйте --xml для получения XML-вывода | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Выводит информацию только о соединениях, указанных в разделах [tcp], [tcp default], [sci], [sci default], [shm] или [shm default] файла конфигурации кластера. Нельзя использовать с --system или --nodes | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Количество попыток повторного подключения перед отказом | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Количество секунд ожидания между попытками связи с сервером управления | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| То же, что и --ndb-connectstring | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Создаёт core-файл при ошибке; используется при отладке | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Чтение заданного файла после чтения глобальных файлов | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Чтение параметров по умолчанию только из заданного файла | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Также читать группы с concat(group, suffix) | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Выводит только параметры конфигурации, которые имеют значения, отличные от значений по умолчанию | ДОБАВЛЕНО: NDB 7.5.7, NDB 7.6.3 | |
| Разделитель полей | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Отображение справки и выход | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Указать хост | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Чтение указанного пути из файла входа | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Чтение данных конфигурации из файла my.cnf | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Установить строку подключения для подключения к ndb_mgmd. Синтаксис: "[nodeid=id;][host=]hostname[:port]". Переопределяет записи в NDB_CONNECTSTRING и my.cnf | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| То же, что и --ndb-connectstring | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Установить идентификатор узла для этого узла, переопределяя любой ID, установленный с помощью --ndb-connectstring | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Включить оптимизации для выбора узлов для транзакций. Включено по умолчанию; используйте --skip-ndb-optimized-node-selection для отключения | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Не читать параметры по умолчанию из какого-либо файла параметров, кроме файла входа | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Получить конфигурацию узла с этим идентификатором | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Выводит только информацию об узлах ([ndbd] или [ndbd default] раздел файла конфигурации кластера). Нельзя использовать с --system или --connections | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Один или несколько параметров запроса (атрибутов) | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Выводит все параметры и значения в одну строку, разделенную запятыми | ДОБАВЛЕНО: NDB 7.4.16, NDB 7.5.7 | |
| Выводит список аргументов программы и завершает работу | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Разделитель строк | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Выводит только информацию раздела SYSTEM (см. вывод ndb_config --configinfo). Нельзя использовать с --nodes или --connections | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Указать тип узла | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Отобразить справку и выйти; то же, что и --help | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Отобразить информацию о версии и выйти | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) | |
| Используйте --xml с --configinfo для получения дампа всех параметров конфигурации NDB в формате XML с указанием значений по умолчанию, максимальных и минимальных значений | (Поддерживается во всех выпусках NDB на основе MySQL 5.7) |
END_OF_DOCUMENT_MARKER
-
--character-sets-dirФормат командной строки --character-sets-dir=pathКаталог, содержащий кодировки символов.
-
--configinfoПараметр
--configinfoзаставляет утилиту ndb_config выгружать список каждого параметра конфигурации кластера NDB, поддерживаемого дистрибутивом кластера NDB, частью которого является ndb_config, включая следующую информацию:Краткое описание цели, эффектов и использования каждого параметра
Раздел файла
config.ini, где может использоваться параметрТип данных или единица измерения параметра
Применимо, значения по умолчанию, минимальные и максимальные значения параметра
Информация о версии выпуска и сборке кластера NDB
По умолчанию этот вывод имеет текстовый формат. Часть этого вывода показана здесь:
$>
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-file=path-to-fileФормат командной строки --config-file=file_nameТип Имя файла Значение по умолчанию Указывает путь к конфигурационному файлу сервера управления (
config.ini). Это может быть относительный или абсолютный путь. Если узел управления находится на другом хосте, чем тот, на котором вызывается ndb_config, то должен использоваться абсолютный путь. -
--config_from_node=#Формат командной строки --config-from-node=#Тип Числовое Значение по умолчанию noneМинимальное значение 1Максимальное значение 48Получить данные конфигурации кластера из узла данных, имеющего этот ID.
Если узел с этим ID не является узлом данных, ndb_config завершается с ошибкой. (Чтобы получить данные конфигурации вместо этого из узла управления, просто опустите этот параметр.)
-
--connectionsФормат командной строки --connectionsГоворит ndb_config печатать только информацию о
CONNECTIONS— то есть информацию о параметрах, найденных в разделах[tcp],[tcp default],[shm]или[shm default]файла конфигурации кластера (см. Раздел 21.4.3.10, «NDB Cluster TCP/IP Connections», и Раздел 21.4.3.12, «NDB Cluster Shared Memory Connections», для получения дополнительной информации).Этот параметр является взаимоисключающим с
--nodesи--system; можно использовать только один из этих 3 параметров. -
--connect-retriesФормат командной строки --connect-retries=#Тип Целое число Значение по умолчанию 12Минимальное значение 0Максимальное значение 12Количество попыток повторного подключения перед отказом.
-
--connect-retry-delayФормат командной строки --connect-retry-delay=#Тип Целое число Значение по умолчанию 5Минимальное значение 0Максимальное значение 5Количество секунд ожидания между попытками связаться с сервером управления.
-
--connect-stringФормат командной строки --connect-string=connection_stringТип Строка Значение по умолчанию [none]То же, что и
--ndb-connectstring. -
--core-fileФормат командной строки --core-fileЗаписать core-файл при ошибке; используется при отладке.
-
--defaults-extra-fileФормат командной строки --defaults-extra-file=pathТип Строка Значение по умолчанию [none]Прочитать данный файл после чтения глобальных файлов.
-
--defaults-fileФормат командной строки --defaults-file=pathТип Строка Значение по умолчанию [none]Прочитать параметры по умолчанию только из данного файла.
-
--defaults-group-suffixФормат командной строки --defaults-group-suffix=stringТип Строка Значение по умолчанию [none]Также читать группы с concat(group, suffix).
-
--diff-defaultФормат командной строки --diff-defaultВведено 5.7.18-ndb-7.6.3 Вывести только параметры конфигурации, имеющие значения, отличные от значений по умолчанию.
-
--fields=,delimiter-fdelimiterФормат командной строки --fields=stringТип Строка Значение по умолчанию Указывает
delimiterстроку, используемую для разделения полей в результате. Значение по умолчанию —,(символ запятой).ПримечаниеЕсли
delimiterсодержит пробелы или escape-последовательности (например,\nдля символа перевода строки), то она должна быть заключена в кавычки. -
--helpФормат командной строки --helpВывести справку и завершить работу.
-
--host=hostnameФормат командной строки --host=nameТип String Значение по умолчанию Указывает имя хоста узла, для которого необходимо получить информацию о конфигурации.
ПримечаниеХотя имя хоста
localhostобычно разрешается в IP-адрес127.0.0.1, это не обязательно верно для всех операционных платформ и конфигураций. Это означает, что возможно, когдаlocalhostиспользуется вconfig.ini, что ndb_config--host=localhostможет завершиться ошибкой, если ndb_config выполняется на другом хосте, гдеlocalhostразрешается в другой адрес (например, в некоторых версиях SUSE Linux это127.0.0.2). В общем, для достижения наилучших результатов следует использовать числовые IP-адреса для всех значений конфигурации NDB Cluster, относящихся к хостам, или убедиться, что все хосты NDB Cluster обрабатываютlocalhostодинаково. -
--login-pathФормат командной строки --login-path=pathТип String Значение по умолчанию [none]Читает заданный путь из файла входа.
-
--mycnfФормат командной строки --mycnfЧитает данные конфигурации из файла
my.cnf. -
--ndb-connectstring=,connection_string-cconnection_stringФормат командной строки --ndb-connectstring=connection_stringТип String Значение по умолчанию [none]Указывает строку соединения, используемую для подключения к серверу управления. Формат строки соединения такой же, как описано в Разделе 21.4.3.3, «Строки соединения NDB Cluster», и по умолчанию равно
localhost:1186. -
--ndb-mgmd-hostФормат командной строки --ndb-mgmd-host=connection_stringТип String Значение по умолчанию [none]То же, что и
--ndb-connectstring. -
--ndb-nodeidФормат командной строки --ndb-nodeid=#Тип Integer Значение по умолчанию [none]Устанавливает идентификатор узла для этого узла, переопределяя любой идентификатор, установленный
--ndb-connectstring. -
--ndb-optimized-node-selectionФормат командной строки --ndb-optimized-node-selectionВключает оптимизацию выбора узлов для транзакций. Включено по умолчанию; используйте
--skip-ndb-optimized-node-selectionдля отключения. -
--no-defaultsФормат командной строки --no-defaultsНе читать параметры по умолчанию из любого файла параметров, кроме файла входа.
-
--nodeid=node_idФормат командной строки --ndb-nodeid=#Тип Integer Значение по умолчанию [none]Указывает идентификатор узла, для которого необходимо получить информацию о конфигурации. Ранее
--idможно было использовать как синоним для этого параметра; в NDB 7.5 и более поздних версиях принимается только форма--nodeid. -
--nodesФормат командной строки --nodesГоворит ndb_config вывести информацию, относящуюся только к параметрам, определенным в разделе
[ndbd]или[ndbd default]файла конфигурации кластера (см. Раздел 21.4.3.6, «Определение узлов данных NDB Cluster»).Этот параметр является взаимоисключающим с
--connectionsи--system; можно использовать только один из этих 3 параметров. -
--query=,query-options-qquery-optionsФормат командной строки --query=stringТип String Значение по умолчанию Это разделенный запятыми список параметров запроса — то есть список одного или нескольких атрибутов узла, которые должны быть возвращены. Они включают в себя
nodeid(идентификатор узла), тип (тип узла — то естьndbd,mysqldилиndb_mgmd) и любые параметры конфигурации, значения которых должны быть получены.Например,
--query=nodeid,type,datamemory,datadirвозвращает идентификатор узла, тип узла,DataMemoryиDataDirдля каждого узла.Ранее
idпринимался как синоним дляnodeid, но был удален в NDB 7.5 и более поздних версиях.ПримечаниеЕсли данный параметр неприменим к определенному типу узла, то для соответствующего значения возвращается пустая строка. См. примеры далее в этом разделе для получения дополнительной информации.
-
--query-all,-aФормат командной строки --query-allПредставлен 5.7.18-ndb-7.5.7 Тип String Значение по умолчанию Возвращает разделенный запятыми список всех параметров запроса (атрибуты узла; обратите внимание, что этот список представляет собой одну строку.
Этот параметр был представлен в NDB 7.5.7 (Ошибка #60095, Ошибка #11766869).
-
--print-defaultsФормат командной строки --print-defaultsВывести список аргументов программы и завершить работу.
-
--rows=,separator-rseparatorФормат командной строки --rows=stringТип String Значение по умолчанию Указывает
separatorстроку, используемую для разделения строк в результате. По умолчанию используется пробел.ПримечаниеЕсли
separatorсодержит пробелы или escape-последовательности (например,\nдля символа перевода строки), то он должен быть заключен в кавычки.
-
--systemФормат командной строки --systemУказывает ndb_config на вывод только информации
SYSTEM. Она состоит из системных переменных, которые нельзя изменить во время выполнения; следовательно, для них нет соответствующего раздела в файле конфигурации кластера. Их можно увидеть (с префиксом****** SYSTEM ******) в выводе ndb_config--configinfo.Этот параметр взаимоисключающий с
--nodesи--connections; можно использовать только один из этих трёх параметров. -
--type=node_typeФормат командной строки --type=nameТип Перечисление Значение по умолчанию [none]Допустимые значения ndbdmysqldndb_mgmdФильтрует результаты, так что возвращаются только значения конфигурации, относящиеся к узлам указанного
node_type(ndbd,mysqldилиndb_mgmd). -
--usage,--help, или-?Формат командной строки --helpПриводит к тому, что ndb_config выводит список доступных параметров и затем завершает работу. Синоним для
--help. -
--version,-VФормат командной строки --versionПриводит к тому, что ndb_config выводит строку с информацией о версии и затем завершает работу.
-
--configinfo--xmlФормат командной строки --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-вывод, создаваемый ndb_config
--configinfo--xml, форматируется с использованием одной строки на элемент; мы добавили дополнительные пробелы в предыдущем и следующем примере для удобства чтения. Это не должно повлиять на приложения, использующие эти данные, так как большинство обработчиков XML по умолчанию игнорируют не существенные пробелы или могут быть настроены на их игнорирование.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)Начиная с NDB 7.5.0, необходимые параметры обозначаются
mandatory="true", как показано здесь:<param name="NodeId" comment="Number identifying application node (mysqld(API))" type="unsigned" mandatory="true" min="1" max="255"/>Аналогично тому, как атрибут
initialилиdeprecatedотображается только для параметра, требующего первоначального перезапуска или устаревшего, атрибутmandatoryвключается только в том случае, если данный параметр действительно необходим.ВажноПараметр
--xmlможно использовать только с параметром--configinfo. Использование--xmlбез--configinfoприводит к ошибке.В отличие от параметров, используемых с этой программой для получения текущих данных конфигурации,
--configinfoи--xmlиспользуют информацию, полученную из исходных кодов NDB Cluster при компиляции ndb_config. По этой причине для этих двух параметров не требуется подключение к работающему кластеру NDB или доступ к файламconfig.iniилиmy.cnf.
Комбинирование других параметров ndb_config (таких как --query или --type) с --configinfo (с или без параметра --xml) не поддерживается. В настоящее время, если вы попытаетесь сделать это, все другие параметры, кроме --configinfo или --xml, просто игнорируются. Однако, это поведение не гарантируется и может быть изменено в любое время. Кроме того, поскольку ndb_config при использовании с параметром --configinfo не обращается к NDB Cluster или не читает файлы, попытка указать дополнительные параметры, такие как --ndb-connectstring или --config-file вместе с --configinfo, не имеет смысла.
Примеры
-
Чтобы получить идентификатор узла и тип каждого узла в кластере:
$>
./ndb_config --query=nodeid,type --fields=':' --rows='\n'1:ndbd 2:ndbd 3:ndbd 4:ndbd 5:ndb_mgmd 6:mysqld 7:mysqld 8:mysqld 9:mysqldВ этом примере мы использовали параметры
--fields, чтобы разделить идентификатор и тип каждого узла двоеточием (:), и параметры--rows, чтобы разместить значения для каждого узла на новой строке в выводе. -
Чтобы создать строку подключения, которую могут использовать узлы данных, SQL и API для подключения к серверу управления:
$>
./ndb_config --config-file=usr/local/mysql/cluster-data/config.ini \ --query=hostname,portnumber --fields=: --rows=, --type=ndb_mgmd198.51.100.179:1186 -
Это вызов ndb_config проверяет только узлы данных (используя параметр
--type) и показывает значения идентификатора и имени хоста каждого узла, а также значения, заданные для параметровDataMemoryиDataDir:$>
./ndb_config --type=ndbd --query=nodeid,host,datamemory,datadir -f ' : ' -r '\n'1 : 198.51.100.193 : 83886080 : /usr/local/mysql/cluster-data 2 : 198.51.100.112 : 83886080 : /usr/local/mysql/cluster-data 3 : 198.51.100.176 : 83886080 : /usr/local/mysql/cluster-data 4 : 198.51.100.119 : 83886080 : /usr/local/mysql/cluster-dataВ этом примере мы использовали короткие параметры
-fи-rдля установки разделителя полей и разделителя строк соответственно, а также короткий параметр-qдля передачи списка параметров, которые нужно получить. -
Чтобы исключить результаты с любого хоста, кроме конкретного, используйте параметр
--host:$>
./ndb_config --host=198.51.100.176 -f : -r '\n' -q id,type3:ndbd 5:ndb_mgmdВ этом примере мы также использовали короткий вариант
-qдля определения атрибутов для запроса.Аналогично, вы можете ограничить результаты узлом с определенным идентификатором, используя параметр
--nodeid.
© 2025 Oracle
Licensed under the GPLv2 License.