TDSQL Boundless RANGE_CACHE

功能
INFORMATION_SCHEMA.RANGE_CACHE 用于展示 Range Cache 中存储的 Block Range Stats，便于进行问题排查。
支持版本
适用于 TDSQL Boundless V21.2.0 及以上版本。
各版本变更如下：
V21.2.0：首次引入 RANGE_CACHE。
V21.2.1：新增 RANGE_CACHE_MISS、RANGE_CACHE_SAMPLE_ROWS、RANGE_CACHE_REFILL_TS 来监控 range cache 的运行情况。
V21.2.6：RANGE_HINTS 列名弃用，新增 RANGE_ACC_ROWS 列，表示累积到当前 Range 的行数估算。
字段说明
字段名
类型
描述
TABLE_SCHEMA
varchar(192)
数据库名称。
TABLE_NAME
varchar(192)
表名称。
INDEX_NAME
varchar(192)
索引名称。
RANGE_CACHE_MISS
bigint
未命中 Range Cache 的次数。
RANGE_CACHE_SAMPLE_ROWS
bigint
Block Range 的采样行数。
RANGE_CACHE_REFILL_TS
bigint
Block Range refill 的时间戳。
START_KEY
varchar(192)
Block Range 的起始键（Start Key）。
END_KEY
varchar(192)
Block Range 的结束键（End Key）。
RANGE_ROWS
bigint
Block Range 内的估计行数。
RANGE_ACC_ROWS
bigint
当前 Block Range 之前所有 Block Range 的累计估计行数（前缀和），仅在全量 Refill 构建 Range Cache 时有效。
RANGE_TIMESTAMP
bigint
Block Range  Stat 生成的时间戳。
示例
tdsql > select * from information_schema.range_cache limit 1 \\G;
*************************** 1. row ***************************
           TABLE_SCHEMA: sbtest
             TABLE_NAME: sbtest1
             INDEX_NAME: PRIMARY
       RANGE_CACHE_MISS: 9486
RANGE_CACHE_SAMPLE_ROWS: 323
  RANGE_CACHE_REFILL_TS: 20251024023139
              START_KEY: 000027C280000001
                END_KEY: 000027C280000143
             RANGE_ROWS: 162
         RANGE_ACC_ROWS: 0
        RANGE_TIMESTAMP: 20251024023144
1 row in set (11.64 sec)

字段名	类型	描述
TABLE_SCHEMA	varchar(192)	数据库名称。
TABLE_NAME	varchar(192)	表名称。
INDEX_NAME	varchar(192)	索引名称。
RANGE_CACHE_MISS	bigint	未命中 Range Cache 的次数。
RANGE_CACHE_SAMPLE_ROWS	bigint	Block Range 的采样行数。
RANGE_CACHE_REFILL_TS	bigint	Block Range refill 的时间戳。
START_KEY	varchar(192)	Block Range 的起始键（Start Key）。
END_KEY	varchar(192)	Block Range 的结束键（End Key）。
RANGE_ROWS	bigint	Block Range 内的估计行数。
RANGE_ACC_ROWS	bigint	当前 Block Range 之前所有 Block Range 的累计估计行数（前缀和），仅在全量 Refill 构建 Range Cache 时有效。
RANGE_TIMESTAMP	bigint	Block Range Stat 生成的时间戳。

RANGE_CACHE

本页目录：

功能

支持版本

字段说明

示例