≫ Настройки и статус таблиц

SHOW TABLE STATUS

SHOW TABLE STATUS — это SQL-запрос, который отображает различные статистические данные по каждой таблице.

Синтаксис:

SHOW TABLE table_name STATUS

В зависимости от типа индекса отображаемая статистика включает разный набор строк:

  • template: index_type.
  • distributed: index_type, query_time_1min, query_time_5min,query_time_15min,query_time_total, exact_query_time_1min, exact_query_time_5min, exact_query_time_15min, exact_query_time_total, found_rows_1min, found_rows_5min, found_rows_15min, found_rows_total.
  • percolate: index_type, stored_queries, ram_bytes, disk_bytes, max_stack_need, average_stack_base, desired_thread_stack, tid, tid_saved, query_time_1min, query_time_5min,query_time_15min,query_time_total, exact_query_time_1min, exact_query_time_5min, exact_query_time_15min, exact_query_time_total, found_rows_1min, found_rows_5min, found_rows_15min, found_rows_total.
  • plain: index_type, indexed_documents, indexed_bytes, может быть набор field_tokens_* и total_tokens, ram_bytes, disk_bytes, disk_mapped, disk_mapped_cached, disk_mapped_doclists, disk_mapped_cached_doclists, disk_mapped_hitlists, disk_mapped_cached_hitlists, killed_documents, killed_rate, query_time_1min, query_time_5min,query_time_15min,query_time_total, exact_query_time_1min, exact_query_time_5min, exact_query_time_15min, exact_query_time_total, found_rows_1min, found_rows_5min, found_rows_15min, found_rows_total.
  • rt: index_type, indexed_documents, indexed_bytes, может быть набор field_tokens_* и total_tokens, ram_bytes, disk_bytes, disk_mapped, disk_mapped_cached, disk_mapped_doclists, disk_mapped_cached_doclists, disk_mapped_hitlists, disk_mapped_cached_hitlists, killed_documents, killed_rate, ram_chunk, ram_chunk_segments_count, disk_chunks, mem_limit, mem_limit_rate, ram_bytes_retired, optimizing, locked, tid, tid_saved, query_time_1min, query_time_5min,query_time_15min,query_time_total, exact_query_time_1min, exact_query_time_5min, exact_query_time_15min, exact_query_time_total, found_rows_1min, found_rows_5min, found_rows_15min, found_rows_total.

Значения означают следующее:

  • index_type: в настоящее время один из disk, rt, percolate, template и distributed.
  • indexed_documents: количество проиндексированных документов.
  • indexed_bytes: общий размер проиндексированного текста. Обратите внимание, что это значение не строгое, так как в полнотекстовом индексе невозможно строго восстановить исходный текст для измерения.
  • stored_queries: количество перколяторных запросов, сохранённых в таблице.
  • field_tokens_XXX: опционально, общая длина по полям (в токенах) по всей таблице (используется внутренне для функций ранжирования BM25A и BM25F). Доступно только для таблиц, созданных с index_field_lengths=1.
  • total_tokens: опционально, общая сумма всех field_tokens_XXX.
  • ram_bytes: общий объём оперативной памяти, занимаемый таблицей.
  • disk_bytes: общий объём дискового пространства, занимаемый таблицей.
  • disk_mapped: общий размер отображённых файлов.
  • disk_mapped_cached: общий размер отображённых файлов, фактически кэшируемых в ОЗУ.
  • disk_mapped_doclists и disk_mapped_cached_doclists: часть общих и кэшируемых отображений, относящаяся к спискам документов.
  • disk_mapped_hitlists и disk_mapped_cached_hitlists: часть общих и кэшируемых отображений, относящаяся к спискам попаданий. Значения doclists и hitlists показаны отдельно, так как они обычно занимают большой объём (например, около 90% от размера всей таблицы).
  • killed_documents и killed_rate: первое указывает количество удалённых документов, второе — отношение удалённых к проиндексированным. Технически удаление документа означает подавление его в результатах поиска, но он физически остаётся в таблице и будет удалён только после слияния/оптимизации таблицы.
  • ram_chunk: размер RAM-чанка таблицы реального времени или перколяторной таблицы.
  • ram_chunk_segments_count: RAM-чанк внутренне состоит из сегментов, обычно не более 32. Эта строка показывает текущее количество.
  • disk_chunks: количество дисковых чанков в таблице реального времени.
  • mem_limit: фактическое значение rt_mem_limit для таблицы.
  • mem_limit_rate: доля, при достижении которой RAM-чанк будет сброшен как дисковый чанк, например, если rt_mem_limit равен 128M, а доля 50%, новый дисковый чанк будет сохранён, когда RAM-чанк превысит 64M.
  • ram_bytes_retired: размер мусора в RAM-чанках (например, удалённые или заменённые документы, ещё не окончательно удалённые).
  • optimizing: значение больше 0 указывает, что таблица в данный момент оптимизируется (т.е. сейчас происходит слияние некоторых дисковых чанков).
  • locked: значение больше 0 указывает, что таблица в данный момент заблокирована с помощью FREEZE. Число показывает, сколько раз таблица была заморожена. Например, таблица может быть заморожена manticore-backup, а затем снова заморожена репликацией. Полное размораживание должно происходить только тогда, когда ни один другой процесс не требует её заморозки.
  • max_stack_need: объём стека, необходимый для вычисления самых сложных из сохранённых перколяторных запросов. Это динамическое значение, зависящее от деталей сборки, таких как компилятор, оптимизация, оборудование и т.д.
  • average_stack_base: объём стека, обычно занимаемый в начале вычисления перколяторного запроса.
  • desired_thread_stack: сумма вышеуказанных значений, округлённая до ближайшего значения, кратного 128 байтам. Если это значение больше thread_stack, выполнение call pq по этой таблице может быть невозможно, так как некоторые сохранённые запросы завершатся с ошибкой. Значение thread_stack по умолчанию — 1M (1048576); другие значения должны быть настроены.
  • tid и tid_saved: представляют состояние сохранения таблицы. tid увеличивается с каждым изменением (транзакцией). tid_saved показывает максимальный tid состояния, сохраненного в RAM-чанк в файле <table>.ram. Когда числа отличаются, некоторые изменения существуют только в RAM и также поддерживаются binlog (если включен). Выполнение FLUSH TABLE или планирование периодической очистки сохраняет эти изменения. После очистки binlog очищается, и tid_saved представляет новое актуальное состояние.
  • query_time_*, exact_query_time_*: статистика времени выполнения запросов за последние 1 минуту, 5 минут, 15 минут и всего с момента запуска сервера; данные инкапсулированы в JSON-объект, включая количество запросов и минимальные, максимальные, средние, 95-й и 99-й перцентильные значения.
  • found_rows_*: статистика найденных строк по запросам; предоставляется за последние 1 минуту, 5 минут, 15 минут и всего с момента запуска сервера; данные инкапсулированы в JSON-объект, включая количество запросов и минимальные, максимальные, средние, 95-й и 99-й перцентильные значения.
  • command_*: счетчики общего количества успешных выполнений конкретной команды для этой таблицы.
  • search_stats_ms_*: статистика времени выполнения (в миллисекундах) поисковых запросов. * обозначает временное окно (например, 1min, 5min, 15min, total). Эти статистики рассчитываются за скользящие окна 1, 5 и 15 минут, показывая средние, минимальные, максимальные и 95-й/99-й перцентильные значения времени запросов.
  • insert_replace_stats_ms_*: статистика времени выполнения (в миллисекундах) запросов вставки и замены. * обозначает временное окно (например, 1min, 5min, 15min, total). Эти статистики рассчитываются за скользящие окна 1, 5 и 15 минут, показывая средние, минимальные, максимальные и 95-й/99-й перцентильные значения времени запросов.
  • update_stats_ms_*: статистика времени выполнения (в миллисекундах) запросов обновления. * обозначает временное окно (например, 1min, 5min, 15min, total). Эти статистики рассчитываются за скользящие окна 1, 5 и 15 минут, показывая средние, минимальные, максимальные и 95-й/99-й перцентильные значения времени запросов.
‹›
  • SQL
  • PHP
  • Python
  • Python-asyncio
  • Javascript
  • Java
  • C#
  • Rust
  • TypeScript
  • Go
📋
mysql> SHOW TABLE statistic STATUS;
‹›
Response
+-------------------------------+--------------------------------------------------------------------------+
| Variable_name                 | Value                                                                    |
+-------------------------------+--------------------------------------------------------------------------+
| index_type                    | rt                                                                       |
| indexed_documents             | 146000                                                                   |
| indexed_bytes                 | 149504000                                                                |
| ram_bytes                     | 87674788                                                                 |
| disk_bytes                    | 1762811                                                                  |
| disk_mapped                   | 794147                                                                   |
| disk_mapped_cached            | 802816                                                                   |
| disk_mapped_doclists          | 0                                                                        |
| disk_mapped_cached_doclists   | 0                                                                        |
| disk_mapped_hitlists          | 0                                                                        |
| disk_mapped_cached_hitlists   | 0                                                                        |
| killed_documents              | 0                                                                        |
| killed_rate                   | 0.00%                                                                    |
| ram_chunk                     | 86865484                                                                 |
| ram_chunk_segments_count      | 24                                                                       |
| disk_chunks                   | 1                                                                        |
| mem_limit                     | 134217728                                                                |
| mem_limit_rate                | 95.00%                                                                   |
| ram_bytes_retired             | 0                                                                        |
| optimizing                    | 1                                                                        |
| locked                        | 0                                                                        |
| tid                           | 0                                                                        |
| tid_saved                     | 0                                                                        |
| query_time_1min               | {"queries":0, "avg":"-", "min":"-", "max":"-", "pct95":"-", "pct99":"-"} |
| query_time_5min               | {"queries":0, "avg":"-", "min":"-", "max":"-", "pct95":"-", "pct99":"-"} |
| query_time_15min              | {"queries":0, "avg":"-", "min":"-", "max":"-", "pct95":"-", "pct99":"-"} |
| query_time_total              | {"queries":0, "avg":"-", "min":"-", "max":"-", "pct95":"-", "pct99":"-"} |
| found_rows_1min               | {"queries":0, "avg":"-", "min":"-", "max":"-", "pct95":"-", "pct99":"-"} |
| found_rows_5min               | {"queries":0, "avg":"-", "min":"-", "max":"-", "pct95":"-", "pct99":"-"} |
| found_rows_15min              | {"queries":0, "avg":"-", "min":"-", "max":"-", "pct95":"-", "pct99":"-"} |
| found_rows_total              | {"queries":0, "avg":"-", "min":"-", "max":"-", "pct95":"-", "pct99":"-"} |
| command_search                | 2                                                                        |
| command_excerpt               | 0                                                                        |
| command_update                | 3                                                                        |
| command_keywords              | 0                                                                        |
| command_status                | 2                                                                        |
| command_delete                | 0                                                                        |
| command_insert                | 1                                                                        |
| command_replace               | 0                                                                        |
| command_commit                | 0                                                                        |
| command_suggest               | 0                                                                        |
| command_callpq                | 0                                                                        |
| command_getfield              | 0                                                                        |
| insert_replace_stats_ms_avg   | 0.284 0.284 0.284                                                        |
| insert_replace_stats_ms_min   | 0.284 0.284 0.284                                                        |
| insert_replace_stats_ms_max   | 0.284 0.284 0.284                                                        |
| insert_replace_stats_ms_pct95 | 0.284 0.284 0.284                                                        |
| insert_replace_stats_ms_pct99 | 0.284 0.284 0.284                                                        |
| search_stats_ms_avg           | 0.000 0.000 0.000                                                        |
| search_stats_ms_min           | 0.000 0.000 0.000                                                        |
| search_stats_ms_max           | 0.000 0.000 0.000                                                        |
| search_stats_ms_pct95         | 0.000 0.000 0.000                                                        |
| search_stats_ms_pct99         | 0.000 0.000 0.000                                                        |
| update_stats_ms_avg           | 0.479 0.479 0.479                                                        |
| update_stats_ms_min           | 0.431 0.431 0.431                                                        |
| update_stats_ms_max           | 0.530 0.530 0.530                                                        |
| update_stats_ms_pct95         | 0.530 0.530 0.530                                                        |
| update_stats_ms_pct99         | 0.530 0.530 0.530                                                        |
+-------------------------------+--------------------------------------------------------------------------+
29 rows in set (0.00 sec)
Last modified: November 20, 2025