tencent cloud

TDSQL Boundless

文档TDSQL Boundless自研内核性能类特性TDStore KV 分离（Key-Value Separation）开启 KV 分离

开启 KV 分离

下载
聚焦模式
字号
最后更新时间： 2026-05-26 11:28:34
注意：
KV 分离涉及的所有参数均为 SUPER 权限专属，普通业务账号无法自行配置。本节展示的所有命令仅用于让业务方了解开启过程与含义，实际启用与调优需联系腾讯云 DBA 协助完成。
后续规划：未来版本将提供自动调优方案，根据业务负载自动选择 min_blob_size、压缩算法、GC 策略等关键参数，无需 DBA 手工干预。当前阶段建议把"是否开启 KV 分离"作为运维工单提交给 DBA 评估。

开启 KV 分离

KV 分离的开关粒度为 Column Family（列族）级别。对客户业务最常用的 user CF（用户表数据所在 CF），最小可用配置只需3个参数（由 DBA 执行）：
-- 1. 打开 user CF 的 KV 分离总开关
SET PERSIST tdstore_user_cf_enable_blob_files = ON;

-- 2. 设置写入 Blob 的 Value 阈值（单位：字节，建议 1024~4096）
SET PERSIST tdstore_user_cf_min_blob_size = 1024;

-- 3.（强烈推荐）打开垃圾回收，避免被覆盖/删除的 Blob 长期占用磁盘
SET PERSIST tdstore_user_cf_enable_blob_garbage_collection = ON;
说明：
权限要求：上述参数均需 SUPER 权限。
生效范围：动态生效，无需重启实例；对新写入的数据立即生效，已有数据在下一轮 Compaction 时按新规则迁移到 Blob 文件。
持久化说明：使用 SET PERSIST 写入 mysqld-auto.cnf，实例重启后仍保留；如只想临时验证，可改用 SET GLOBAL（重启失效）。

关闭 KV 分离

SET PERSIST tdstore_user_cf_enable_blob_files = OFF;
说明：
关闭后行为：新写入的大 Value 不再分离，但已存在的 Blob 文件依然有效，读路径会自动识别。Blob 文件会随后续 Compaction 被逐步合并回 SST，或在所有引用消失后被回收。

验证是否生效

-- 1. 查看开关状态
SHOW GLOBAL VARIABLES LIKE 'tdstore_user_cf_%blob%';

-- 2. 查看 Blob 写入量是否在增长（持续观察）
SHOW GLOBAL STATUS LIKE 'rocksdb_blobdb_blob_file_bytes_written';
SHOW GLOBAL STATUS LIKE 'rocksdb_blobdb_num_keys_written';
正常生效时，rocksdb_blobdb_* 系列指标会随写入持续增长（详见 监控指标）。
上一篇: KV 分离功能概述下一篇: 性能优化点

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈