一、权限与生效
·所有 tdstore_user_cf_*blob* 参数都需要 SUPER 权限才能修改。
·大多数参数支持在线动态修改,对新写入立即生效。
·例外:tdstore_enable_blob_cache(共享 Blob Cache 开关)为 READ_ONLY,只能在启动配置中指定,重启后生效。
二、数据格式版本不可降级
·首次开启 tdstore_user_cf_enable_blob_files = ON 时,若 tdstore_rocksdb_data_format_version 为 UNKNOWN,系统会自动升级到 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 有独立开关 |