注意:KV 分离涉及的所有参数均为 SUPER 权限专属,普通业务账号无法自行配置。本节展示的所有命令仅用于让业务方了解开启过程与含义,实际启用与调优需联系腾讯云 DBA 协助完成。
注意:后续规划:未来版本将提供自动调优方案,根据业务负载自动选择 min_blob_size、压缩算法、GC 策略等关键参数,无需 DBA 手工干预。当前阶段建议把"是否开启 KV 分离"作为运维工单提交给 DBA 评估。
一、开启 KV 分离
— 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;
注意:说明:
二、关闭 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_* 系列指标会随写入持续增长(详见 监控指标)。