21.5.15 ndb_index_stat — NDB Index Statistics Utility — MySQL 5.7

21.5.15 ndb_index_stat — Утилита статистики индексов NDB

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

Использование

Чтобы получить базовые статистические данные об индексах заданной таблицы NDB, вызовите ndb_index_stat с именем таблицы в качестве первого аргумента и именем базы данных, содержащей эту таблицу, сразу после него, используя опцию --database (-d):

ndb_index_stat table -d database

В этом примере мы используем ndb_index_stat для получения такой информации о таблице NDB с именем mytable в базе данных test:

$> ndb_index_stat -d test mytable
table:City index:PRIMARY fragCount:2
sampleVersion:3 loadTime:1399585986 sampleCount:1994 keyBytes:7976
query cache: valid:1 sampleCount:1994 totalBytes:27916
times in ms: save: 7.133 sort: 1.974 sort per sample: 0.000

NDBT_ProgramExit: 0 - OK

sampleVersion — это номер версии кэша, из которого берутся статистические данные. Запуск ndb_index_stat с опцией --update приводит к увеличению sampleVersion.

loadTime показывает, когда кэш был обновлен последний раз. Это выражается как количество секунд с эпохи Unix.

sampleCount — это количество записей индекса, обнаруженных в каждой партиции. Общее количество записей можно оценить, умножив это значение на количество фрагментов (показанное как fragCount).

sampleCount можно сравнить с кардинальностью запроса SHOW INDEX или INFORMATION_SCHEMA.STATISTICS, хотя последние два предоставляют представление о таблице в целом, а ndb_index_stat — среднее значение по фрагментам.

keyBytes — количество байтов, используемых индексом. В этом примере первичный ключ — это целое число, для которого требуется четыре байта на каждый индекс, поэтому keyBytes в этом случае можно рассчитать, как показано здесь:

    keyBytes = sampleCount * (4 bytes per index) = 1994 * 4 = 7976

Эту информацию также можно получить, используя соответствующие определения столбцов из таблицы схемы информации COLUMNS (для этого требуется сервер MySQL и приложение-клиент MySQL).

totalBytes — это общее количество памяти, занимаемой всеми индексами в таблице, в байтах.

Время, показанное в предыдущих примерах, специфично для каждого вызова ndb_index_stat.

Опция --verbose предоставляет дополнительный вывод, как показано здесь:

$> ndb_index_stat -d test mytable --verbose
random seed 1337010518
connected
loop 1 of 1
table:mytable index:PRIMARY fragCount:4
sampleVersion:2 loadTime:1336751773 sampleCount:0 keyBytes:0
read stats
query cache created
query cache: valid:1 sampleCount:0 totalBytes:0
times in ms: save: 20.766 sort: 0.001
disconnected

NDBT_ProgramExit: 0 - OK

$>

Если единственный вывод программы — NDBT_ProgramExit: 0 - OK, это может указывать на отсутствие статистики. Чтобы заставить их создать (или обновить, если они уже существуют), вызовите ndb_index_stat с опцией --update или выполните ANALYZE TABLE для таблицы в клиенте mysql.

Опции

В следующей таблице перечислены опции, специфичные для утилиты NDB Cluster ndb_index_stat. Дополнительные описания приведены после таблицы.

Таблица 21.34 Параметры командной строки, используемые с программой ndb_index_stat

Таблица 21.34 Параметры командной строки, используемые с программой ndb_index_stat
Формат	Описание	Добавлен, устарел или удален
`--character-sets-dir=path`	Директория, содержащая наборы символов	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--connect-retries=#`	Количество попыток повторного подключения перед отказом	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--connect-retry-delay=#`	Количество секунд ожидания между попытками связи с сервером управления	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--connect-string=connection_string`, `-c connection_string`	То же, что и --ndb-connectstring	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--core-file`	Создание файла core при ошибке; используется при отладке	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--database=name`, `-d name`	Имя базы данных, содержащей таблицу	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--defaults-extra-file=path`	Чтение заданного файла после чтения глобальных файлов	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--defaults-file=path`	Чтение параметров по умолчанию только из указанного файла	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--defaults-group-suffix=string`	Также читать группы с concat(group, suffix)	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--delete`	Удаление статистики индексов для таблицы, остановка любого ранее настроенного автоматического обновления	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--dump`	Печать кэша запросов	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--help`, `-?`	Отображение текста справки и выход	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--login-path=path`	Чтение заданного пути из файла входа	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--loops=#`	Установить количество повторений заданной команды; значение по умолчанию 0	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--ndb-connectstring=connection_string`, `-c connection_string`	Установить строку подключения для подключения к ndb_mgmd. Синтаксис: "[nodeid=id;][host=]hostname[:port]". Перезаписывает записи в NDB_CONNECTSTRING и my.cnf	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--ndb-mgmd-host=connection_string`, `-c connection_string`	То же, что и --ndb-connectstring	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--ndb-nodeid=#`	Установить идентификатор узла для данного узла, перезаписывая любой ID, заданный --ndb-connectstring	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--ndb-optimized-node-selection`	Включить оптимизации для выбора узлов для транзакций. Включено по умолчанию; используйте --skip-ndb-optimized-node-selection для отключения	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--no-defaults`	Не читать параметры по умолчанию из какого-либо файла параметров, кроме файла входа	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--print-defaults`	Печать списка аргументов программы и выход	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--query=#`	Выполнение случайных запросов диапазона на первом ключевом атрибуте (должен быть int unsigned)	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--sys-drop`	Удаление всех таблиц статистики и событий в ядре NDB (вся статистика теряется)	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--sys-create`	Создание всех таблиц статистики и событий в ядре NDB, если они еще не существуют	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--sys-create-if-not-exist`	Создание любых таблиц статистики и событий в ядре NDB, если они еще не существуют	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--sys-create-if-not-valid`	Создание любых таблиц статистики или событий, которые еще не существуют в ядре NDB, после удаления любых недопустимых	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--sys-check`	Проверка существования системных статистических данных индекса NDB и таблиц событий	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--sys-skip-tables`	Не применять параметры sys-* к таблицам	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--sys-skip-events`	Не применять параметры sys-* к событиям	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--update`	Обновление статистики индекса для таблицы, перезапуск любого ранее настроенного автоматического обновления	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--usage`, `-?`	Отображение текста справки и выход; то же, что и --help	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--verbose`, `-v`	Включение подробного вывода	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)
`--version`, `-V`	Отображение информации о версии и выход	(Поддерживается во всех выпусках NDB на основе MySQL 5.7)

--character-sets-dir

Формат командной строки --character-sets-dir=path

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

Формат командной строки	`--character-sets-dir=path`

--connect-retries

Формат командной строки	`--connect-retries=#`
Тип	Integer
Значение по умолчанию	`12`
Минимальное значение	`0`
Максимальное значение	`12`

Количество попыток повторного подключения перед прекращением попыток.

--connect-retry-delay

Формат командной строки	`--connect-retry-delay=#`
Тип	Integer
Значение по умолчанию	`5`
Минимальное значение	`0`
Максимальное значение	`5`

Количество секунд ожидания между попытками связаться с сервером управления.

--connect-string

Формат командной строки --connect-string=connection_string

Тип String

Значение по умолчанию [none]

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

Формат командной строки --core-file

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

Формат командной строки	`--connect-string=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--core-file`

--database=name, -d name

Формат командной строки	`--database=name`
Тип	String
Значение по умолчанию	`[none]`
Минимальное значение
Максимальное значение

Имя базы данных, содержащей запрашиваемую таблицу.

--defaults-extra-file

Формат командной строки --defaults-extra-file=path

Тип String

Значение по умолчанию [none]

Прочитать заданный файл после чтения глобальных файлов.
--defaults-file

Формат командной строки --defaults-file=path

Тип String

Значение по умолчанию [none]

Прочитать параметры по умолчанию только из указанного файла.
--defaults-group-suffix

Формат командной строки --defaults-group-suffix=string

Тип String

Значение по умолчанию [none]

Также прочитать группы с concat(group, suffix).
--delete

Формат командной строки --delete

Удалить статистику индексов для данной таблицы, остановив любое ранее настроенное автоматическое обновление.
--dump

Формат командной строки --dump

Сбросить содержимое кэша запросов.
--help

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

Вывести справку и завершить работу.
--login-path

Формат командной строки --login-path=path

Тип String

Значение по умолчанию [none]

Прочитать заданный путь из файла входа.

Формат командной строки	`--defaults-extra-file=path`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--defaults-file=path`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--defaults-group-suffix=string`
Тип	String
Значение по умолчанию	`[none]`

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

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

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

Формат командной строки	`--login-path=path`
Тип	String
Значение по умолчанию	`[none]`

--loops=#

Формат командной строки	`--loops=#`
Тип	Numeric
Значение по умолчанию	`0`
Минимальное значение	`0`
Максимальное значение	`MAX_INT`

Повторить команды указанное количество раз (для использования в тестировании).

--ndb-connectstring

Формат командной строки --ndb-connectstring=connection_string

Тип String

Значение по умолчанию [none]

Установить строку подключения для подключения к ndb_mgmd. Синтаксис: "[nodeid=id;][host=]hostname[:port]". Переопределяет записи в NDB_CONNECTSTRING и my.cnf.
--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

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

Формат командной строки --print-defaults

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

Формат командной строки	`--ndb-connectstring=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-mgmd-host=connection_string`
Тип	String
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-nodeid=#`
Тип	Integer
Значение по умолчанию	`[none]`

Формат командной строки	`--ndb-optimized-node-selection`

Формат командной строки	`--no-defaults`

Формат командной строки	`--print-defaults`

--query=#

Формат командной строки	`--query=#`
Тип	Numeric
Значение по умолчанию	`0`
Минимальное значение	`0`
Максимальное значение	`MAX_INT`

Выполнить случайные запросы диапазона по первому атрибуту ключа (должен быть int unsigned).

--sys-drop

Формат командной строки --sys-drop

Удалить все таблицы статистики и события в ядре NDB. Это приведёт к потере всей статистики.
--sys-create

Формат командной строки --sys-create

Создать все таблицы статистики и события в ядре NDB. Это работает только если ни одна из них не существует ранее.

Формат командной строки	`--sys-drop`

Формат командной строки	`--sys-create`

--sys-create-if-not-exist

Формат командной строки --sys-create-if-not-exist

Создать все таблицы статистики системы NDB или события (или и то, и другое), которые еще не существуют, при вызове программы.
--sys-create-if-not-valid

Формат командной строки --sys-create-if-not-valid

Создать все таблицы статистики системы NDB или события, которые еще не существуют, после удаления всех некорректных.
--sys-check

Формат командной строки --sys-check

Проверить, существуют ли все необходимые таблицы статистики системы и события в ядре NDB.
--sys-skip-tables

Формат командной строки --sys-skip-tables

Не применять какие-либо --sys-* параметры к таблицам статистики.
--sys-skip-events

Формат командной строки --sys-skip-events

Не применять какие-либо --sys-* параметры к событиям.
--update

Формат командной строки --update

Обновить статистику индексов для заданной таблицы и перезапустить все ранее настроенные автоматические обновления.
--usage

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

Отобразить текст справки и выйти; то же самое, что и --help.
--verbose

Формат командной строки --verbose

Включить подробный вывод.
--version

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

Отобразить информацию о версии и выйти.

Формат командной строки	`--sys-create-if-not-exist`

Формат командной строки	`--sys-create-if-not-valid`

Формат командной строки	`--sys-check`

Формат командной строки	`--sys-skip-tables`

Формат командной строки	`--sys-skip-events`

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

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

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

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

Системные параметры ndb_index_stat. Следующие параметры используются для генерации и обновления таблиц статистики в ядре NDB. Ни один из этих параметров не может быть смешан с параметрами статистики (см. параметры статистики ndb_index_stat).

Параметры статистики ndb_index_stat. Перечисленные здесь параметры используются для генерации статистики индексов. Они работают с заданной таблицей и базой данных. Их нельзя смешивать с системными параметрами (см. системные параметры ndb_index_stat).