17.4.6. ndb_config — информация о Кластерной конфигурации MySQL Extract

Этот инструмент извлекает текущую конфигурационную информацию для узлов данных, узлов SQL, и узлов API из одного из многих источников: узел управления MySQL Cluster, или config.ini или my.cnf файл. По умолчанию узел управления является источником для данных конфигурации; чтобы переопределить значение по умолчанию, выполните ndb_config с --config-file или --mycnf опция. Также возможно использовать узел данных в качестве источника, определяя его ID узла с --config_from_node=node_id-

ndb_config может также обеспечить офлайновый дамп всех параметров конфигурации, которые могут использоваться, наряду с их значением по умолчанию, максимумом, и минимальными значениями и другой информацией. Дамп может быть произведен или в формате текста или в XML; для получения дополнительной информации см. обсуждение --configinfo и --xml опции позже в этом разделе).

Можно фильтровать результаты по разделу (DB, SYSTEM, или CONNECTIONS) использование одной из опций --nodes, --system, или --connections.

Следующая таблица включает опции, которые являются определенными для ndb_config. Дополнительные описания следуют за таблицей. Для опций, характерных для большинства программ MySQL Cluster (включая ndb_config), см. Раздел 17.4.25, "Опции, Характерные для MySQL Cluster Programs — Опции, Характерные для MySQL Cluster Programs".

Таблица 17.14. Опции ndb_config и Переменные: MySQL Cluster NDB7.3

Формат	Описание	Добавленный / Удаленный
`- узлы`	Информация об узле печати (раздел DB) только.	Весь MySQL 5.6 базируемые выпуски
`- соединения`	Информация о разделе СОЕДИНЕНИЙ печати только. Не может использоваться с - узлы или - системная опция.	Весь MySQL 5.6 базируемые выпуски
`--query=string`, `-q`	Одна или более опций запроса (атрибуты)	Весь MySQL 5.6 базируемые выпуски
`- host=name`	Определите узел	Весь MySQL 5.6 базируемые выпуски
`- type=name`	Определите тип узла	Весь MySQL 5.6 базируемые выпуски
`--nodeid`, `- идентификатор`	Получите конфигурацию узла с этим ID	Весь MySQL 5.6 базируемые выпуски
`--fields=string`, `-f`	Разделитель полей	Весь MySQL 5.6 базируемые выпуски
`--rows=string`, `-r`	Разделитель строки	Весь MySQL 5.6 базируемые выпуски
`- config-file=path`	Установите путь к config.ini файлу	Весь MySQL 5.6 базируемые выпуски
`- mycnf`	Считайте данные конфигурации из my.cnf файла	Весь MySQL 5.6 базируемые выпуски
`-c`	Краткая форма для - ndb-connectstring	Весь MySQL 5.6 базируемые выпуски
`- configinfo`	Информация о дампах обо всех параметрах конфигурации NDB в тексте форматирует со значением по умолчанию, максимумом, и минимальными значениями. Используйте с - xml, чтобы получить вывод XML.	Весь MySQL 5.6 базируемые выпуски
`- configinfo - xml`	Используйте - xml с - configinfo, чтобы получить дамп всех параметров конфигурации NDB в формате XML со значением по умолчанию, максимумом, и минимальными значениями.	Весь MySQL 5.6 базируемые выпуски
`- система`	СИСТЕМНАЯ информация о разделе печати только. Не может использоваться с - узлы или - опция соединений.	Весь MySQL 5.6 базируемые выпуски
`--config_from_node=#`	Получите данные конфигурации из узла, имеющего этот ID (должен быть узел данных).	Весь MySQL 5.6 базируемые выпуски

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

Формат командной строки	`--help`
	`--usage`
	`-?`

Причины ndb_config, чтобы напечатать список доступных параметров, и затем выйти.

--config_from_node=#

Формат командной строки	`--config_from_node=#`
	Разрешенные Значения
	Ввести	`numeric`
	Значение по умолчанию	`none`
	Диапазон	`1 .. 48`

Получите данные конфигурации кластера из узла данных, у которого есть этот ID.

Если узел, имеющий этот ID, не является узлом данных, ndb_config сбои с ошибкой. (Чтобы получить данные конфигурации из узла управления вместо этого, просто опустите эту опцию.)

--version, -V

Формат командной строки	`--version`
	`-V`

Причины ndb_config, чтобы напечатать строку информации о версии, и затем выйти.

--ndb-connectstring=connect_string, -c connect_string

Формат командной строки	`--ndb-connectstring=connectstring`
	`--connect-string=connectstring`
	`-c`
	Разрешенные Значения
	Ввести	`string`
	Значение по умолчанию	`localhost:1186`

Определяет connectstring, чтобы использовать в соединении с сервером управления. Формат для connectstring является тем же самым как описано в Разделе 17.3.2.3, "MySQL Cluster Connectstring", и значения по умолчанию к localhost:1186.

--config-file=path-to-file

Формат командной строки	`--config-file=path`
	Разрешенные Значения
	Ввести	`file name`
	Значение по умолчанию

Дает путь к конфигурационному файлу сервера управления (config.ini). Это может быть относительным или абсолютным путем. Если узел управления находится на различном узле от того, на который вызывается ndb_config, то абсолютный путь должен использоваться.

--mycnf

Формат командной строки	`--mycnf`
	Разрешенные Значения
	Ввести	`boolean`
	Значение по умолчанию	`FALSE`

Считайте данные конфигурации из my.cnf файл.

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

Формат командной строки	`--query=string`
	`-q`
	Разрешенные Значения
	Ввести	`string`
	Значение по умолчанию

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

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

Отметить

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

--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-адреса для всех значений MySQL Cluster configuration, касающихся узлов, или проверить, что весь MySQL Cluster размещает дескриптор localhost тем же самым способом.

--id=node_id

--nodeid=node_id

Формат командной строки	`--ndb-nodeid=#`
	Разрешенные Значения
	Ввести	`numeric`
	Значение по умолчанию	`0`

Любая из этих опций может использоваться, чтобы определить ID узла узла, для которого должна быть получена конфигурационная информация. --nodeid привилегированная форма.

--nodes

Формат командной строки	`--nodes`
	Разрешенные Значения
	Ввести	`boolean`
	Значение по умолчанию	`FALSE`

Говорит ndb_config печатать информацию от параметров, определенных в DB разделы только. Эта опция не может использоваться вместе с --connections или --system.

--connections

Формат командной строки	`--connections`
	Разрешенные Значения
	Ввести	`boolean`
	Значение по умолчанию	`FALSE`

Говорит ndb_config печатать CONNECTIONS информация только. Эта опция не может использоваться вместе с --nodes или --system.

--system

Формат командной строки	`--system`
	Разрешенные Значения
	Ввести	`boolean`
	Значение по умолчанию	`FALSE`

Говорит ndb_config печатать SYSTEM информация только.

Эта опция не может использоваться вместе с --nodes или --system опции.

--type=node_type

Формат командной строки	`--type=name`
	Разрешенные Значения
	Ввести	`enumeration`
	Значение по умолчанию
	Допустимые Значения	`ndbd`
		`mysqld`
		`ndb_mgmd`

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

--fields=delimiter, -f delimiter

Формат командной строки	`--fields=string`
	`-f`
	Разрешенные Значения
	Ввести	`string`
	Значение по умолчанию

Определяет a delimiter строка, используемая, чтобы разделить поля в результате. Значение по умолчанию","(символ запятой).

Отметить

Если delimiter содержит пробелы или Escape (такой как \n для символа перевода строки), тогда это должно быть заключено в кавычки.

--rows=separator, -r separator

Формат командной строки	`--rows=string`
	`-r`
	Разрешенные Значения
	Ввести	`string`
	Значение по умолчанию

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

Отметить

Если separator содержит пробелы или Escape (такой как \n для символа перевода строки), тогда это должно быть заключено в кавычки.

--configinfo

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

Краткое описание цели каждого параметра, эффектов, и использования
Раздел config.ini файл, где параметр может использоваться
Тип данных параметра или модуль измерения
Где применимый, значение по умолчанию параметра, минимум, и максимальные значения
Краткое описание цели параметра, эффектов, и использования
Версия выпуска MySQL Cluster и создает информацию

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

shell> ndb_config
                    --configinfo****** SYSTEM ******Name (String)Name of system (NDB Cluster)MANDATORYPrimaryMGMNode (Non-negative Integer)Node id of Primary ndb_mgmd(MGM) nodeDefault: 0 (Min: 0, Max: 4294967039)ConfigGenerationNumber (Non-negative Integer)Configuration generation numberDefault: 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)…

--configinfo --xml

Формат командной строки	`--configinfo --xml`
	Разрешенные Значения
	Ввести	`boolean`
	Значение по умолчанию	`false`

Можно получить вывод ndb_config --configinfo как XML, добавляя --xml опция. Часть получающегося вывода показывают в этом примере:

shell> ndb_config --configinfo
                    --xml<configvariables protocolversion="1" ndbversionstring="5.6.11-ndb-7.3.3"                    ndbversion="458758" ndbversionmajor="7" ndbversionminor="0"                    ndbversionbuild="6">  <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="NDBD">    <param name="MaxNoOfSubscriptions"               comment="Max no of subscriptions (default 0 == MaxNoOfTables)"              type="unsigned" default="0" min="0" max="4294967039"/>    <param name="MaxNoOfSubscribers"               comment="Max no of subscribers (default 0 == 2 * MaxNoOfTables)"              type="unsigned" default="0" min="0" max="4294967039"/>    …  </section>  …</configvariables>

Отметить

Обычно, вывод XML производится ndb_config --configinfo --xml форматируется, используя одну строку на элемент; мы добавили дополнительный пробел в предыдущем примере, так же как следующем, по причинам четкости. Это не должно иметь никакого значения к приложениям, используя этот вывод, так как большинство процессоров XML или игнорирует несущественный пробел как само собой разумеющееся, или может быть проинструктировано, чтобы сделать так.

Вывод XML также указывает, когда изменение данного параметра требует, чтобы узлы данных были перезапущены, используя --initial опция. Это показывает присутствие initial="true" атрибут в соответствии <param> элемент. Кроме того, тип перезапуска (system или node) также показывается; если данный параметр требует системного перезапуска, это обозначается присутствием a 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 опция может использоваться только с --configinfo опция. Используя --xml без --configinfo сбои с ошибкой.

В отличие от опций, используемых с этой программой, чтобы получить текущие данные конфигурации, --configinfo и --xml используйте информацию, полученную из источников MySQL Cluster, когда ndb_config был скомпилирован. Поэтому никакое соединение с рабочим MySQL Cluster или доступ к a config.ini или my.cnf файл требуется для этих двух опций.

Объединение других ndb_config опций (такой как --query или --type) с --configinfo или --xml не поддерживается. В настоящий момент, если Вы пытаетесь сделать так, обычный результат состоит в том что все другие опции кроме того --configinfo или --xml просто игнорируются. Однако, это поведение не гарантируется и подвержено изменениям в любое время. Кроме того, с тех пор ndb_config, когда использующийся с --configinfo опция, не получает доступ к MySQL Cluster или считать любые файлы, пытаясь определить дополнительные опции такой как --ndb-connectstring или --config-file с --configinfo не служит никакой цели.

Примеры

Получить ID узла и тип каждого узла в кластере:
```
shell> ./ndb_config --query=id,type
                    --fields=':' --rows='\n'1:ndbd2:ndbd3:ndbd4:ndbd5:ndb_mgmd6:mysqld7:mysqld8:mysqld9:mysqld
```
В этом примере мы использовали --fields опции, чтобы разделить ID и тип каждого узла с символом двоеточия (:), и --rows опции, чтобы поместить значения для каждого узла на новой строке в выводе.
Произвести connectstring, который может использоваться данными, SQL, и узлами API, чтобы соединиться с сервером управления:
```
shell> ./ndb_config
                    --config-file=usr/local/mysql/cluster-data/config.ini \ --query=hostname,portnumber --fields=:
                    --rows=, --type=ndb_mgmd192.168.0.179:1186
```
Этот вызов ndb_config проверяет только узлы данных (использующий --type опция), и шоу значения для ID каждого узла и имени хоста, так же как набора значений для DataMemory, IndexMemory, и DataDir параметры:
```
shell> ./ndb_config --type=ndbd
                    --query=id,host,datamemory,indexmemory,datadir -f ' : ' -r '\n'1 : 192.168.0.193 : 83886080 : 18874368 : /usr/local/mysql/cluster-data2 : 192.168.0.112 : 83886080 : 18874368 : /usr/local/mysql/cluster-data3 : 192.168.0.176 : 83886080 : 18874368 : /usr/local/mysql/cluster-data4 : 192.168.0.119 : 83886080 : 18874368 : /usr/local/mysql/cluster-data
```
В этом примере мы использовали короткие опции -f и -r для того, чтобы установить разделитель полей и разделитель строки, соответственно.
Чтобы исключить следствия любого узла кроме одного в частности используйте --host опция:
```
shell> ./ndb_config --host=192.168.0.176
                    -f : -r '\n' -q id,type3:ndbd5:ndb_mgmd
```
В этом примере мы также использовали краткую форму -q определить атрибуты, которые будут запрошены.

Точно так же можно ограничить результаты узлом с определенным ID, используя --id или --nodeid опция.