大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:SHOW TABLET

· 52CE 我爱测

自 4.0.8 版本起,存算分离模式下副本的数据量统一按**远端数据**语义上报:未单独记录远端大小的数据量会被计入 ,对应的 显示为 。因此存算分离集群中通常看到 为 ,实际数据量体现在 上。

描述

SHOW TABLET 用于查看 Tablet 信息(仅管理员使用),支持两种形式:

  • SHOW TABLET <tablet_id>:已知 tablet id 时,反查该 Tablet 归属的库、表、分区与索引。
  • SHOW TABLETS FROM <table_name>:列出一张表或指定分区下所有 Tablet 的副本分布、版本、数据量与 Compaction 状态。

两者常配合使用:先用前者定位 Tablet 的归属,再用后者查看同一分区内其他副本的状态。

两条语句都只支持 Internal Catalog 中的表,不支持 External Catalog。

语法

-- 按 tablet id 查看单个 Tablet
SHOW TABLET <tablet_id>

-- 查看一张表下所有 Tablet
SHOW TABLETS FROM <table_name>
    [ PARTITIONS ( <partition_name> [, ... ] ) ]
    [ WHERE <where_condition> ]
    [ ORDER BY <column_name> [ ASC | DESC ] [, ... ] ]
    [ LIMIT [ <offset>, ] <row_count> ]

参数

SHOW TABLET

1. <tablet_id>

必选。要查询的 Tablet ID。

SHOW TABLETS FROM

1. <table_name>

必选。表名,支持 db_name.table_name 形式。

2. PARTITIONS ( <partition_name> [, ... ] )

可选。只查看指定分区下的 Tablet。不指定时查看该表所有分区。

3. WHERE <where_condition>

可选。过滤条件。只支持以下三个字段的等值比较,多个条件之间用 AND 连接:

字段 类型 说明
Version 整数 按副本版本过滤
BackendId 整数 按副本所在的 BE 节点 ID 过滤
State 字符串 按副本状态过滤,取值为 NORMAL、ROLLUP、CLONE、DECOMMISSION

使用其他字段、非等值比较或 OR 连接都会报错:

Where clause should looks like: Version = "version", or state = "NORMAL|ROLLUP|CLONE|DECOMMISSION", or BackendId = 10000 or compound predicate with operator AND

4. ORDER BY <column_name>

可选。按返回结果中的列排序,排序列必须是下方「返回值」中列出的列名。

指定 ORDER BY 时,Doris 会先收集全部 Tablet 再排序,因此结果是全局有序的 Top-N。

5. LIMIT [ <offset>, ] <row_count>

可选。限制返回行数。Tablet 数量较多时建议配合使用。

LIMIT 与 OFFSET 在排序之后生效。未指定 ORDER BY 时,扫描到足够行数即停止:带 LIMIT 时返回的是扫描顺序的前缀;不带 LIMIT 时结果按 (TabletId, ReplicaId) 排序。

  • 4.1.4 之前,指定 ORDER BY 时可能只对扫描到的前若干行做排序,导致返回的并不是真正的全局 Top-N。4.1.4 起修复为先收集全部 Tablet 再排序。
  • 4.1.4 之前,单独指定 OFFSET(不带正数 LIMIT)会被忽略,且 OFFSET 大于总行数时会清空整个结果。4.1.4 起 OFFSET 始终生效。

返回值

SHOW TABLET

列名 数据类型 说明
DbName String 包含该 tablet 的数据库名称。
TableName String 包含该 tablet 的表名称。
PartitionName String 包含该 tablet 的分区名称。
IndexName String 包含该 tablet 的索引名称。
DbId Int 数据库的 ID。
TableId Int 表的 ID。
PartitionId Int 分区的 ID。
IndexId Int 索引的 ID。
IsSync Boolean 该 tablet 是否与其副本同步。
Order Int tablet 在所属索引中的顺序。
QueryHits Int 该 tablet 上的查询命中次数。
WindowAccessCount Int 滑动统计窗口内该 tablet 的访问次数。
LastAccessTime Int 该 tablet 最近一次被访问的时间戳(毫秒)。从未被访问时为 0。
DetailCmd String 获取有关该 tablet 更详细信息的命令。

SHOW TABLETS FROM

每一行对应一个副本(Replica),因此同一个 TabletId 会按副本数出现多行。

列名 数据类型 说明
TabletId Int Tablet ID
ReplicaId Int 副本 ID
BackendId Int 副本所在的 BE 节点 ID
SchemaHash Int 副本对应的 Schema Hash
Version Int 副本当前的可见版本
LstSuccessVersion Int 最近一次成功导入的版本
LstFailedVersion Int 最近一次失败的版本,-1 表示没有失败版本
LstFailedTime String 最近一次版本失败的时间,无失败时为 \N
LocalDataSize Int 副本的本地数据大小(字节)。存算分离模式下通常为 0,详见下方「存算分离模式下的数据大小语义」
RemoteDataSize Int 副本的远端数据大小(字节)
RowCount Int 副本的行数
State String 副本状态:NORMAL、ROLLUP、CLONE、DECOMMISSION
LstConsistencyCheckTime String 最近一次一致性检查的时间,未检查过时为 \N
CheckVersion Int 最近一次一致性检查的版本,-1 表示未检查过
VisibleVersionCount Int 副本的可见版本数量
VersionCount Int 副本的总版本数量,可用于判断 Compaction 是否滞后
QueryHits Int 该副本上的查询命中次数
WindowAccessCount Int 滑动统计窗口内该 Tablet 的访问次数
LastAccessTime Int 该 Tablet 最近一次被访问的时间戳(毫秒)。从未被访问时为 0
PathHash Int 副本所在数据目录的 Hash
Path String 副本所在的 BE 数据根目录。无法解析时为空
MetaUrl String 查看该副本元数据的 HTTP 地址,格式为 http://<be_host>:<be_http_port>/api/meta/header/<tablet_id>
CompactionStatus String 查看该副本 Compaction 状态的 HTTP 地址,格式为 http://<be_host>:<be_http_port>/api/compaction/show?tablet_id=<tablet_id>
CooldownReplicaId Int 冷数据副本 ID,未开启冷热分层时为 -1
CooldownMetaId String 冷数据元数据 ID,未开启冷热分层时为空
PrimaryBackendId Int 该 Tablet 的主 BE 节点 ID。仅存算分离模式下返回该列

存算分离模式下的数据大小语义

自 4.0.8 版本起,存算分离模式下副本的数据量统一按远端数据语义上报:未单独记录远端大小的数据量会被计入 RemoteDataSize,对应的 LocalDataSize 显示为 0。因此存算分离集群中通常看到 LocalDataSize 为 0,实际数据量体现在 RemoteDataSize 上。

在 4.0.8 之前,这部分数据量会被记入 LocalDataSize,导致 SHOW TABLETS、information_schema.partitions 与 information_schema.backend_tablets 三者的本地/远端口径互相矛盾。该变更只调整展示口径,不改变数据的实际存储位置与总量。

权限控制

执行此 SQL 命令的用户必须至少具有以下权限:

权限 对象 说明
Admin_priv 全局 两条语句都需要全局 ADMIN 权限,权限不足时报 Access denied 错误。

示例

按 tablet id 查看单个 Tablet

SHOW TABLET 10145;
+--------+-----------+---------------+-----------+-------+---------+-------------+---------+--------+-------+-----------+-------------------+----------------+------------------------------------------------------------+
| DbName | TableName | PartitionName | IndexName | DbId  | TableId | PartitionId | IndexId | IsSync | Order | QueryHits | WindowAccessCount | LastAccessTime | DetailCmd                                                  |
+--------+-----------+---------------+-----------+-------+---------+-------------+---------+--------+-------+-----------+-------------------+----------------+------------------------------------------------------------+
| test   | sell_user | sell_user     | sell_user | 10103 | 10143   | 10142       | 10144   | true   | 0     | 0         | 0                 | 0              | SHOW PROC '/dbs/10103/10143/partitions/10142/10144/10145'; |
+--------+-----------+---------------+-----------+-------+---------+-------------+---------+--------+-------+-----------+-------------------+----------------+------------------------------------------------------------+

DetailCmd 列给出的 SHOW PROC 语句可以进一步查看该 Tablet 的副本明细。

查看一张表下所有 Tablet

SHOW TABLETS FROM example_db.sell_user;

只查看指定分区

SHOW TABLETS FROM example_db.sell_user PARTITIONS(p202601, p202602);

按副本状态与所在节点过滤

SHOW TABLETS FROM example_db.sell_user WHERE State = "NORMAL" AND BackendId = 10003;

排查 Compaction 滞后的 Tablet

按版本数量倒序排列,版本数最多的 Tablet 通常是 Compaction 压力最大的:

SHOW TABLETS FROM example_db.sell_user ORDER BY VersionCount DESC LIMIT 10;

结果中的 CompactionStatus 列是一个 HTTP 地址,在浏览器打开即可查看该副本详细的 Compaction 状态。

排查数据倾斜

按数据量倒序排列,可以快速找到明显偏大的 Tablet:

-- 存算一体模式
SHOW TABLETS FROM example_db.sell_user ORDER BY LocalDataSize DESC LIMIT 10;

-- 存算分离模式(数据量体现在 RemoteDataSize 上)
SHOW TABLETS FROM example_db.sell_user ORDER BY RemoteDataSize DESC LIMIT 10;

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。