Spec-Zone.ru › MySQL 8.4

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 statistics options).

  • --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-8.4-en/mysql-cluster-programs-ndb-index-stat.html

Spec-Zone.ru

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