Spec-Zone.ru › MySQL 9.2

25.5.14 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

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

Эту информацию также можно получить, используя соответствующие определения столбцов из INFORMATION_SCHEMA.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

$>

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

Опции

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

  • --character-sets-dir

    Формат командной строки --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-файл при ошибке; используется для отладки.

  • --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]

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

  • --no-login-paths

    Формат командной строки --no-login-paths

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

  • --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-mgm-tls

    Формат командной строки --ndb-mgm-tls=level
    Тип Enumeration
    Значение по умолчанию relaxed
    Допустимые значения

    relaxed

    strict

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

  • --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 для отключения.

  • --ndb-tls-search-path

    Формат командной строки --ndb-tls-search-path=list
    Тип Path name
    Значение по умолчанию (Unix) $HOME/ndb-tls
    Значение по умолчанию (Windows) $HOMEDIR/ndb-tls

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

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

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

  • --no-defaults

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

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

  • --print-defaults

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

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

  • --query=#

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

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

  • --sys-drop

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

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

  • --sys-create

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

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

  • --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

    Вывести информацию о версии и завершить работу.

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

  • --sys-drop

  • --sys-create

  • --sys-create-if-not-exist

  • --sys-create-if-not-valid

  • --sys-check

  • --sys-skip-tables

  • --sys-skip-events

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

  • --database

  • --delete

  • --update

  • --dump

  • --query

© 2025 Oracle
Licensed under the GPLv2 License.
https://docs.oracle.com/cd/E17952_01/mysql-9.2-en/mysql-cluster-programs-ndb-index-stat.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API