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

查看 Tablet Compaction Score

· 52CE 我爱测

通过此只读 API 查找单个 BE 节点上 Compaction Score 较高的 Tablet。一个 Tablet 的分数为其所有 Rowset 分数之和,结果按 降序排列。存算分离模式下,API 仅检查当前 BE 缓存中处于运行状态的 Tablet,不会遍历整个集群的全部 Tablet。

查看 Tablet Compaction Score

描述

通过此只读 API 查找单个 BE 节点上 Compaction Score 较高的 Tablet。一个 Tablet 的分数为其所有 Rowset 分数之和,结果按 compaction_score 降序排列。存算分离模式下,API 仅检查当前 BE 缓存中处于运行状态的 Tablet,不会遍历整个集群的全部 Tablet。

前提条件

直接访问 BE 的 HTTP 端口(默认为 8040)。如果 BE 配置 enable_all_http_auth 已启用,需要使用具有全局 ADMIN 权限的 Doris 账号,并将示例中的凭据替换为该账号。

请求

GET /api/compaction_score?top_n=<integer>&sync_meta=<boolean>

请求不包含请求体。

请求参数

参数 类型 是否必填 默认值 描述
top_n 非负整数 否 全部可用 Tablet 最多返回分数最高的前 N 个 Tablet。0 返回 []。数值必须处于有符号 64 位整数范围内。
sync_meta 布尔值:true 或 false 否 false 仅适用于存算分离模式。为 true 时,先从 Meta Service 同步该 BE 缓存中运行状态 Tablet 的元数据和 Rowset,再计算分数。存算一体模式下必须省略整个参数,包括 sync_meta=false。

基本用法

以下请求可检查连通性和参数处理,且不返回 Tablet 行:

curl -u '<user>:<password>' 'http://127.0.0.1:8040/api/compaction_score?top_n=0'
[]

响应

请求成功时返回 HTTP 200 和 JSON 数组。每个元素包含两个字符串类型的字段:

字段 描述
tablet_id Tablet ID。
compaction_score 该 Tablet 所有 Rowset 的 Compaction Score 之和。

例如,最多返回 10 个 Tablet:

curl -u '<user>:<password>' 'http://127.0.0.1:8040/api/compaction_score?top_n=10'

以下输出仅作示意,ID、分数和返回数量取决于该 BE 的状态:

[
    {"compaction_score": "5", "tablet_id": "42595"},
    {"compaction_score": "4", "tablet_id": "10034"}
]

存算分离模式下,可在计算分数前同步缓存 Tablet 的最新元数据:

curl -u '<user>:<password>' 'http://127.0.0.1:8040/api/compaction_score?top_n=10&sync_meta=true'

响应使用相同的 JSON 格式,分数在同步完成后计算。

错误处理与注意事项

  • top_n 无法解析或为负数时返回 HTTP 400,例如 invalid argument: top_n=wrong。
  • 存算一体模式下指定非空 sync_meta 时返回 HTTP 400:param `sync_meta` is only available for cloud mode。
  • 存算分离模式下,非空 sync_meta 不是 true 或 false 时返回 HTTP 400,例如 invalid argument: sync_meta=wrong。
  • 元数据同步失败时返回 HTTP 500。启用鉴权后,缺失或无效凭据可能返回 HTTP 401 或 403。
  • top_n 只限制响应条数,不限制检查或同步的 Tablet 数量。分数反映该 BE 的 Tablet 状态,不构成整个集群的原子快照。

最佳实践

先使用较小的 top_n 和默认的 sync_meta=false 定位需要进一步排查的 Tablet。需要最新元数据时再使用 sync_meta=true;它会在应用 top_n 前同步全部缓存中运行状态的 Tablet,可能增加延迟和 Meta Service 负载。

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

资料来源与适用范围

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

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

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