≫ 表设置和状态

SHOW TABLE STATUS

SHOW TABLE STATUS 是一个显示每个表各种统计信息的 SQL 语句。

语法为:

SHOW TABLE table_name STATUS

根据索引类型,显示的统计信息包含不同的行集:

  • template: index_type
  • distributed: index_typequery_time_1minquery_time_5minquery_time_15minquery_time_totalexact_query_time_1minexact_query_time_5minexact_query_time_15minexact_query_time_totalfound_rows_1minfound_rows_5minfound_rows_15minfound_rows_total
  • percolate: index_typestored_queriesram_bytesdisk_bytesmax_stack_needaverage_stack_base desired_thread_stacktidtid_savedquery_time_1minquery_time_5minquery_time_15minquery_time_totalexact_query_time_1minexact_query_time_5minexact_query_time_15minexact_query_time_totalfound_rows_1minfound_rows_5minfound_rows_15minfound_rows_total
  • plain: index_typeindexed_documentsindexed_bytes,可能包含一组 field_tokens_*total_tokensram_bytesdisk_bytesdisk_mappeddisk_mapped_cacheddisk_mapped_doclistsdisk_mapped_cached_doclistsdisk_mapped_hitlistsdisk_mapped_cached_hitlistskilled_documentskilled_ratequery_time_1minquery_time_5minquery_time_15minquery_time_totalexact_query_time_1minexact_query_time_5minexact_query_time_15minexact_query_time_totalfound_rows_1minfound_rows_5minfound_rows_15minfound_rows_total
  • rt: index_typeindexed_documentsindexed_bytes,可能包含一组 field_tokens_*total_tokensram_bytesdisk_bytesdisk_mappeddisk_mapped_cacheddisk_mapped_doclistsdisk_mapped_cached_doclistsdisk_mapped_hitlistsdisk_mapped_cached_hitlistskilled_documentskilled_rateram_chunkram_chunk_segments_countdisk_chunksmem_limitmem_limit_rateram_bytes_retiredoptimizinglockedtidtid_savedquery_time_1minquery_time_5minquery_time_15minquery_time_totalexact_query_time_1minexact_query_time_5minexact_query_time_15minexact_query_time_totalfound_rows_1minfound_rows_5minfound_rows_15minfound_rows_total

以下是这些值的含义:

  • index_type:当前为 diskrtpercolatetemplatedistributed 之一。
  • indexed_documents:已索引文档的数量。
  • indexed_bytes:已索引文本的总体大小。注意,该值不是严格的,因为在全文索引中不可能严格还原存储的文本来测量它。
  • stored_queries:表中存储的 percolate 查询数量。
  • field_tokens_XXX:可选,整个表中每个字段的总长度(以令牌计)(内部用于 BM25ABM25F 排名函数)。仅适用于使用 index_field_lengths=1 构建的表。
  • total_tokens:可选,所有 field_tokens_XXX 的总和。
  • ram_bytes:表占用的总 RAM。
  • disk_bytes:表占用的总磁盘空间。
  • disk_mapped:文件映射的总大小。
  • disk_mapped_cached:实际缓存于 RAM 中的文件映射总大小。
  • disk_mapped_doclistsdisk_mapped_cached_doclists:属于文档列表的总映射和缓存映射部分。
  • disk_mapped_hitlistsdisk_mapped_cached_hitlists:属于命中列表的总映射和缓存映射部分。文档列表和命中列表的值分开显示,因为它们通常很大(例如,大约占整个表大小的 90%)。
  • killed_documentskilled_rate:前者表示已删除文档的数量,后者表示删除文档与已索引文档的比例。从技术上讲,删除文档意味着在搜索结果中屏蔽它,但它仍然物理存在于表中,只有在合并/优化表后才会被清除。
  • ram_chunk:实时或 percolate 表的 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:计算存储的 percolate 查询中最复杂部分所需的栈空间。这是动态值,取决于构建细节如编译器、优化、硬件等。
  • average_stack_base:通常在开始计算 percolate 查询时占用的栈空间。
  • desired_thread_stack:上述值的总和,向上取整到 128 字节边界。如果此值大于 thread_stack,则可能无法在此表上执行 call pq,因为某些存储的查询会失败。默认 thread_stack 值为 1M(即 1048576);其他值应自行配置。
  • tidtid_saved:表示表的保存状态。tid 随每次更改(事务)递增。tid_saved 显示保存在 <table>.ram 文件中 RAM 块状态的最大 tid。当数字不同时,某些更改仅存在于 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