📣

TiDB Cloud Serverless 现已更名为
Starter
!此页面由 AI 自动翻译,英文原文请见
此处。

TIDB_INDEX_USAGE

从 v8.0.0 版本开始,TiDB 提供了 TIDB_INDEX_USAGE 表。你可以使用 TIDB_INDEX_USAGE 获取当前 TiDB 节点上所有索引的使用统计信息。默认情况下,TiDB 在执行 SQL 语句时会收集这些索引使用统计信息。你可以通过关闭 instance.tidb_enable_collect_execution_info 配置项或 tidb_enable_collect_execution_info 系统变量来禁用此功能。

USE INFORMATION_SCHEMA; DESC TIDB_INDEX_USAGE;
+--------------------------+-------------+------+------+---------+-------+ | Field | Type | Null | Key | Default | Extra | +--------------------------+-------------+------+------+---------+-------+ | TABLE_SCHEMA | varchar(64) | YES | | NULL | | | TABLE_NAME | varchar(64) | YES | | NULL | | | INDEX_NAME | varchar(64) | YES | | NULL | | | QUERY_TOTAL | bigint(21) | YES | | NULL | | | KV_REQ_TOTAL | bigint(21) | YES | | NULL | | | ROWS_ACCESS_TOTAL | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_0 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_0_1 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_1_10 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_10_20 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_20_50 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_50_100 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_100 | bigint(21) | YES | | NULL | | | LAST_ACCESS_TIME | datetime | YES | | NULL | | +--------------------------+-------------+------+------+---------+-------+ 14 行结果(耗时 0.00 秒)

TIDB_INDEX_USAGE 表中的列说明如下:

  • TABLE_SCHEMA:索引所在表所属的数据库名称。
  • TABLE_NAME:包含索引的表的名称。
  • INDEX_NAME:索引的名称。
  • QUERY_TOTAL:访问该索引的语句总数。
  • KV_REQ_TOTAL:访问该索引时产生的 KV 请求总数。
  • ROWS_ACCESS_TOTAL:访问该索引时扫描的行数总和。
  • PERCENTAGE_ACCESS_0:行访问比例(访问的行数占表总行数的百分比)为 0 的次数。
  • PERCENTAGE_ACCESS_0_1:行访问比例在 0% 到 1% 之间的次数。
  • PERCENTAGE_ACCESS_1_10:行访问比例在 1% 到 10% 之间的次数。
  • PERCENTAGE_ACCESS_10_20:行访问比例在 10% 到 20% 之间的次数。
  • PERCENTAGE_ACCESS_20_50:行访问比例在 20% 到 50% 之间的次数。
  • PERCENTAGE_ACCESS_50_100:行访问比例在 50% 到 100% 之间的次数。
  • PERCENTAGE_ACCESS_100:行访问比例为 100% 的次数。
  • LAST_ACCESS_TIME:最近一次访问该索引的时间。

CLUSTER_TIDB_INDEX_USAGE

TIDB_INDEX_USAGE 表仅提供单个 TiDB 节点上所有索引的使用统计信息。若要获取集群中所有 TiDB 节点的索引使用统计信息,需要查询 CLUSTER_TIDB_INDEX_USAGE 表。

TIDB_INDEX_USAGE 表相比,CLUSTER_TIDB_INDEX_USAGE 表的查询结果多了一个 INSTANCE 字段。该字段显示集群中每个节点的 IP 地址和端口,帮助你区分不同节点的统计信息。

USE INFORMATION_SCHEMA; DESC CLUSTER_TIDB_INDEX_USAGE;

输出如下:

+--------------------------+-------------+------+------+---------+-------+ | Field | Type | Null | Key | Default | Extra | +--------------------------+-------------+------+------+---------+-------+ | INSTANCE | varchar(64) | YES | | NULL | | | TABLE_SCHEMA | varchar(64) | YES | | NULL | | | TABLE_NAME | varchar(64) | YES | | NULL | | | INDEX_NAME | varchar(64) | YES | | NULL | | | QUERY_TOTAL | bigint(21) | YES | | NULL | | | KV_REQ_TOTAL | bigint(21) | YES | | NULL | | | ROWS_ACCESS_TOTAL | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_0 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_0_1 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_1_10 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_10_20 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_20_50 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_50_100 | bigint(21) | YES | | NULL | | | PERCENTAGE_ACCESS_100 | bigint(21) | YES | | NULL | | | LAST_ACCESS_TIME | datetime | YES | | NULL | | +--------------------------+-------------+------+------+---------+-------+ 15 行结果(耗时 0.00 秒)

限制

  • TIDB_INDEX_USAGE 表中的数据可能会延迟最多 5 分钟。
  • 重启 TiDB 后,TIDB_INDEX_USAGE 表中的数据会被清空。
  • 只有在表具有有效统计信息时,TiDB 才会记录索引的使用情况。

了解更多

文档内容是否有帮助?