tencent cloud

TDSQL Boundless

使用约束与注意事项

下载
聚焦模式
字号
最后更新时间: 2026-05-26 11:28:34

权限与生效

所有 tdstore_user_cf_*blob* 参数都需要 SUPER 权限才能修改。
大多数参数支持在线动态修改,对新写入立即生效。
例外tdstore_enable_blob_cache(共享 Blob Cache 开关)为 READ_ONLY,只能在启动配置中指定,重启后生效。

数据格式版本不可降级

首次开启 tdstore_user_cf_enable_blob_files = ON 时,若 tdstore_rocksdb_data_format_versionUNKNOWN,系统会自动升级ROCKSDB_DATA_FORMAT_VERSION_1,并在客户端返回一条 Warning。
一旦升级到 v1,无法降级回旧版本;这意味着开启 KV 分离后,回退到不支持 BlobDB 的旧版 TDSQL 实例会受限。
建议:升级评估时把"是否会启用 KV 分离"列入决策项。

开关粒度限制

KV 分离开关粒度为 Column Family不支持表级 / Region 级开关。
对 user CF 开启后,user CF 中所有表的大 Value 都会被分离。
如需仅对部分大表生效,可结合 tdstore_user_cf_min_blob_size 设置较高阈值,让小 Value 表不受影响。

关闭后的残留数据

关闭 enable_blob_files 后,已存在的 Blob 文件不会立即被删除,需等待后续 Compaction 自然合并。
如需快速回收磁盘,可由 DBA 手动触发 Compaction。

与其他特性的关系

特性
兼容性
主备同步 / Raft 复制
完全兼容,Blob 文件随快照与日志同步
Region Split / Merge
完全兼容
备份 / 恢复
完全兼容,Blob 文件随备份打包
二级索引
完全兼容(索引列通常不会触发分离)
列存(Columnar)
兼容,列存元数据 CF 有独立开关,与 user CF 互不影响
分层存储(Tiered Store)
兼容,cache CF 有独立开关

帮助和支持

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

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

文档反馈