≫ 表设置和状态
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:存储在表中的 percolate 查询数量。field_tokens_XXX:可选,整个表中各字段的总长度(以令牌计),内部用于BM25A和BM25F排序函数。仅适用于使用index_field_lengths=1构建的表。total_tokens:可选,所有field_tokens_XXX的整体和。ram_bytes:表占用的总 RAM。disk_bytes:表占用的总磁盘空间。disk_mapped:文件映射的总大小。disk_mapped_cached:实际缓存在 RAM 中的文件映射大小。disk_mapped_doclists和disk_mapped_cached_doclists:属于文档列表的总映射和缓存映射部分。disk_mapped_hitlists和disk_mapped_cached_hitlists:属于命中列表的总映射和缓存映射部分。由于文档列表和命中列表通常较大(例如,占整个表大小约90%),故这两个值单独显示。killed_documents和killed_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); 其它值需用户配置。tid和tid_saved:表示表保存状态。tid随每次变更(事务)递增。tid_saved显示在<table>.ram文件中保存的 RAM 块的最大tid。当两值不同时,表示有些变更仅存在于 RAM 中,并由二进制日志支持(如果启用)。执行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