TIDB_INDEX_USAGE

TiDB 从 v8.0.0 开始提供 TIDB_INDEX_USAGE 表，你可以使用该表查看当前 TiDB 节点中所有索引的访问统计信息。在 SQL 语句执行时，TiDB 默认维护访问索引有关的统计信息，可以通过修改配置项 instance.tidb_enable_collect_execution_info 或者系统变量 tidb_enable_collect_execution_info 将其关闭。

  1. USE INFORMATION_SCHEMA;
  2. DESC TIDB_INDEX_USAGE;
  1. +--------------------------+-------------+------+------+---------+-------+
  2. | Field                    | Type        | Null | Key  | Default | Extra |
  3. +--------------------------+-------------+------+------+---------+-------+
  4. | TABLE_SCHEMA             | varchar(64) | YES  |      | NULL    |       |
  5. | TABLE_NAME               | varchar(64) | YES  |      | NULL    |       |
  6. | INDEX_NAME               | varchar(64) | YES  |      | NULL    |       |
  7. | QUERY_TOTAL              | bigint(21)  | YES  |      | NULL    |       |
  8. | KV_REQ_TOTAL             | bigint(21)  | YES  |      | NULL    |       |
  9. | ROWS_ACCESS_TOTAL        | bigint(21)  | YES  |      | NULL    |       |
  10. | PERCENTAGE_ACCESS_0      | bigint(21)  | YES  |      | NULL    |       |
  11. | PERCENTAGE_ACCESS_0_1    | bigint(21)  | YES  |      | NULL    |       |
  12. | PERCENTAGE_ACCESS_1_10   | bigint(21)  | YES  |      | NULL    |       |
  13. | PERCENTAGE_ACCESS_10_20  | bigint(21)  | YES  |      | NULL    |       |
  14. | PERCENTAGE_ACCESS_20_50  | bigint(21)  | YES  |      | NULL    |       |
  15. | PERCENTAGE_ACCESS_50_100 | bigint(21)  | YES  |      | NULL    |       |
  16. | PERCENTAGE_ACCESS_100    | bigint(21)  | YES  |      | NULL    |       |
  17. | LAST_ACCESS_TIME         | datetime    | YES  |      | NULL    |       |
  18. +--------------------------+-------------+------+------+---------+-------+
  19. 14 rows in set (0.00 sec)

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 字段。INSTANCE 字段展示了集群中各节点的 IP 地址和端口，用于区分不同节点上的统计信息。

  1. USE INFORMATION_SCHEMA;
  2. DESC CLUSTER_TIDB_INDEX_USAGE;

输出结果如下：

  1. +-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
  2. | Field                   | Type                                                            | Null | Key  | Default | Extra |
  3. +-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
  4. | INSTANCE                | varchar(64)                                                     | YES  |      | NULL    |       |
  5. | ID                      | bigint(21) unsigned                                             | NO   | PRI  | NULL    |       |
  6. | START_TIME              | timestamp(6)                                                    | YES  |      | NULL    |       |
  7. | CURRENT_SQL_DIGEST      | varchar(64)                                                     | YES  |      | NULL    |       |
  8. | CURRENT_SQL_DIGEST_TEXT | text                                                            | YES  |      | NULL    |       |
  9. | STATE                   | enum('Idle','Running','LockWaiting','Committing','RollingBack') | YES  |      | NULL    |       |
  10. | WAITING_START_TIME      | timestamp(6)                                                    | YES  |      | NULL    |       |
  11. | MEM_BUFFER_KEYS         | bigint(64)                                                      | YES  |      | NULL    |       |
  12. | MEM_BUFFER_BYTES        | bigint(64)                                                      | YES  |      | NULL    |       |
  13. | SESSION_ID              | bigint(21) unsigned                                             | YES  |      | NULL    |       |
  14. | USER                    | varchar(16)                                                     | YES  |      | NULL    |       |
  15. | DB                      | varchar(64)                                                     | YES  |      | NULL    |       |
  16. | ALL_SQL_DIGESTS         | text                                                            | YES  |      | NULL    |       |
  17. | RELATED_TABLE_IDS       | text                                                            | YES  |      | NULL    |       |
  18. | WAITING_TIME            | double                                                          | YES  |      | NULL    |       |
  19. +-------------------------+-----------------------------------------------------------------+------+------+---------+-------+
  20. 15 rows in set (0.00 sec)

使用限制

  • TIDB_INDEX_USAGE 表中的数据可能存在最多 5 分钟的延迟。
  • 在 TiDB 重启后，TIDB_INDEX_USAGE 表中的数据会被清空。

更多阅读