DTFile use V3 version as default (#14963)

pingcap · Sep 21, 2023 · 4f39a87 · 4f39a87
1 parent 1126406
commit 4f39a87
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 5 deletions.
diff --git a/tiflash-upgrade-guide.md b/tiflash-upgrade-guide.md
@@ -82,8 +82,10 @@ TiFlash 在 v6.2.0 将数据格式升级到 V3 版本，因此，从 v5.x 或 v6
 
 从 v6.1 升级至 v6.2 时，需要注意 PageStorage 变更数据版本带来的影响。具体请参考[从 v5.x 或 v6.0 升级至 v6.2](#从-v5x-或-v60-升级至-v62) 中关于 PageStorage 的描述。
 
-## 从 v6.x 或 v7.x 升级至 v7.3，并且设置了 `storage.format_version = 5`
+## 从 v6.x 或 v7.x 升级至 v7.3 或以上版本
 
 从 v7.3 开始，TiFlash 支持新的 DTFile 版本 V3 (实验特性），可以将多个小文件合并成一个大文件，减少文件数量。DTFile 在 v7.3 的默认版本是 V2，如需使用 V3，可通过 [TiFlash 配置参数](/tiflash/tiflash-configuration.md) `storage.format_version = 5` 来设置。设置后，TiFlash 仍可以读 V2 版本的 DTFile，并且在后续的数据整理 (Compaction) 中会将这些 V2 版本的 DMFile 逐步重新写为 V3 版本的 DTFile。
 
-在 TiFlash 升级到 v7.3 并且使用了 V3 版本的 DTFile 后，如需回退到之前的 TiFlash 版本，可以通过 DTTool 离线将 DTFile 重新写回 V2 版本，详见 [DTTool 迁移工具](/tiflash/tiflash-command-line-flags.md#dttool-migrate)。
+从 v7.4 开始，DTFile 版本 V3 正式 GA，成为 TiFlash DTFile 的默认版本。
+
+在 TiFlash 升级到 v7.3 并且使用了 V3 版本的 DTFile 或者升级到 v7.4 后，如需回退到之前的 TiFlash 版本，可以通过 DTTool 离线将 DTFile 重新写回 V2 版本，详见 [DTTool 迁移工具](/tiflash/tiflash-command-line-flags.md#dttool-migrate)。
diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md
@@ -67,9 +67,9 @@ delta_index_cache_size = 0
     ## DTFile 储存文件格式
     ## * format_version = 2 v6.0.0 以前版本的默认文件格式
     ## * format_version = 3 v6.0.0 及 v6.1.x 版本的默认文件格式，具有更完善的检验功能
-    ## * format_version = 4 v6.2.0 及以后版本的默认文件格式，优化了写放大问题，同时减少了后台线程消耗
-    ## * format_version = 5 从 v7.3.0 开始引入的文件格式（非 v7.3.0 默认格式），该格式可以合并小文件从而减少了物理文件数量。注意该格式目前为实验特性，不建议在生产环境中使用。
-    # format_version = 4
+    ## * format_version = 4 v7.3.0 及以前版本的默认文件格式，优化了写放大问题，同时减少了后台线程消耗。
+    ## * format_version = 5 v7.4.0 及以后版本的默认文件格式（从 v7.3.0 开始引入），该格式可以合并小文件从而减少了物理文件数量。
+    # format_version = 5
 
     [storage.main]
     ## 用于存储主要的数据，该目录列表中的数据占总数据的 90% 以上。