AI Translate 02-upgrade to Simplified-Chinese (#2465)

* [INIT] Start translation to Simplified-Chinese

* 🌐 Translate 10-compatibility.md to Simplified-Chinese

* 🌐 Translate 10-compatibility.md to Simplified-Chinese

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

.translation-init

@@ -1 +1 @@
-Translation initialization: 2025-06-26T00:45:56.276983
+Translation initialization: 2025-06-27T06:30:03.404187

docs/cn/guides/10-deploy/02-upgrade/10-compatibility.md

@@ -2,18 +2,18 @@
 title: 兼容性
 sidebar_label: 兼容性
 description:
-  调查和管理兼容性
+  检查和管理兼容性
 ---
 
-本指南将介绍如何调查和管理兼容性：
-- databend-query 和 databend-meta 之间的兼容性。
-- 不同版本的 databend-meta 之间的兼容性。
+本指南将介绍如何检查和管理以下组件之间的兼容性：
+- databend-query 和 databend-meta 之间
+- 不同版本的 databend-meta 之间
 
 ## databend-query 和 databend-meta 之间的兼容性
 
 ### 识别版本
 
-- 找出 databend-query 的构建版本及其兼容的 databend-meta 版本：
+- 查询 databend-query 的构建版本及其兼容的 databend-meta 版本：
 
   ```shell
   databend-query --cmd ver
@@ -23,9 +23,9 @@ description:
   min-compatible-metasrv-version: 0.7.59
   ```
 
-  这意味着此版本的 databend-query（`0.7.61-nightly`）可以与至少 `0.7.59` 版本的 databend-meta 通信，包括该版本。
+  这意味着此构建版本的 databend-query（`0.7.61-nightly`）可与版本至少为 `0.7.59`（含）的 databend-meta 通信。
 
-- 找出 databend-meta 的构建版本及其兼容的 databend-query 版本：
+- 查询 databend-meta 的构建版本及其兼容的 databend-query 版本：
 
   ```shell
   databend-meta --cmd ver
@@ -35,49 +35,45 @@ description:
   min-compatible-client-version: 0.7.57
   ```
 
-  这意味着此版本的 databend-meta（`0.7.61-nightly`）可以与至少 `0.7.57` 版本的 databend-query 通信，包括该版本。
+  这意味着此构建版本的 databend-meta（`0.7.61-nightly`）可与版本至少为 `0.7.57`（含）的 databend-query 通信。
 
 ### 维护兼容性
 
-必须使用兼容版本的 databend-query 和 databend-meta 部署 Databend 集群。
-当且仅当以下语句成立时，databend-query 和 databend-meta 才兼容：
+Databend 集群必须部署兼容版本的 databend-query 和 databend-meta。
+当且仅当以下条件成立时，两者兼容：
 
 ```
 databend-query.version >= databend-meta.min-compatible-client-version
-databend-bend.version  >= databend-query.min-compatible-metasrv-version
+databend-meta.version  >= databend-query.min-compatible-metasrv-version
 ```
 
 :::caution
 
-如果部署了不兼容的版本，当 databend-query 尝试连接到 databend-meta 时，将发生 `InvalidArgument` 错误，
-可以在 databend-query 日志中找到。
-然后 databend-query 将停止工作。
+若部署不兼容版本，当 databend-query 尝试连接 databend-meta 时将出现 `InvalidArgument` 错误（可在 databend-query 日志中查看），
+随后 databend-query 将停止工作。
 
 :::
 
 #### 兼容性验证协议
 
-当 meta-client（databend-query）和 databend-meta 之间建立连接时，将在 `handshake` RPC 中检查兼容性。
+当 meta-client（databend-query）与 databend-meta 建立连接时，会在 `handshake` RPC 中检查兼容性。
 
-客户端 `C`（databend-query）和服务器 `S`（databend-meta）维护两个语义版本：
+客户端 `C`（databend-query）和服务器 `S`（databend-meta）各自维护两个语义版本：
+- `C` 维护自身版本（`C.ver`）和兼容的最低 `S` 版本（`C.min_srv_ver`）
+- `S` 维护自身版本（`S.ver`）和兼容的最低 `C` 版本（`S.min_cli_ver`）
 
-- `C` 维护其自身的 semver（`C.ver`）和最小兼容的 `S` semver（`C.min_srv_ver`）。
-- `S` 维护其自身的 semver（`S.ver`）和最小兼容的 `S` semver（`S.min_cli_ver`）。
+握手流程：
+1. `C` 发送 `C.ver` 至 `S`
+2. `S` 收到请求后断言 `C.ver >= S.min_cli_ver`
+3. `S` 回复握手响应并返回 `S.ver`
+4. `C` 收到响应后断言 `S.ver >= C.min_srv_ver`
 
-握手时：
+两项断言均成立时握手成功。
 
-- `C` 将其版本 `C.ver` 发送到 `S`，
-- 当 `S` 收到握手请求时，`S` 断言 `C.ver >= S.min_cli_ver`。
-- 然后 `S` 使用其 `S.ver` 回复握手回复。
-- 当 `C` 收到回复时，`C` 断言 `S.ver >= C.min_srv_ver`。
-
-如果这两个断言都成立，则握手成功。
-
-例如：
-- `S: (ver=3, min_cli_ver=1)` 与 `C: (ver=3, min_srv_ver=2)` 兼容。
-- `S: (ver=4, min_cli_ver=4)` 与 `C: (ver=3, min_srv_ver=2)` **不**兼容。
-  因为虽然 `S.ver(4) >= C.min_srv_ver(3)` 成立，
-  但 `C.ver(3) >= S.min_cli_ver(4)` 不成立。
+示例：
+- `S: (ver=3, min_cli_ver=1)` 兼容 `C: (ver=3, min_srv_ver=2)`
+- `S: (ver=4, min_cli_ver=4)` **不**兼容 `C: (ver=3, min_srv_ver=2)`  
+  （因 `C.ver(3) >= S.min_cli_ver(4)` 不成立）
 
 ```text
 C.ver:    1             3      4
@@ -93,7 +89,7 @@ S.ver:           2      3      4
 
 #### 兼容性状态
 
-以下是最新的 query-meta 兼容性的说明：
+最新 query-meta 兼容性图示：
 
 | `Meta\Query`       | [0.9.41, 1.1.34) | [1.1.34, 1.2.287) | [1.2.287, 1.2.361) | [1.2.361, +∞) |
 |:-------------------|:-----------------|:---------------|:-----------|:-----------|
@@ -106,85 +102,74 @@ S.ver:           2      3      4
 | [1.2.226, 1.2.258) | ✅                | ✅              | ✅          |❌          |
 | [1.2.258, +∞)      | ✅                | ✅              | ✅          |✅          |
 
-未包含在上述图表中的历史版本：
-
-- Query `[0.7.59, 0.8.80)` 与 Meta `[0.8.30, 0.9.23)` 兼容。
-- Query `[0.8.80, 0.9.41)` 与 Meta `[0.8.35, 0.9.42)` 兼容。
-
+历史版本补充：
+- Query `[0.7.59, 0.8.80)` 兼容 Meta `[0.8.30, 0.9.23)`
+- Query `[0.8.80, 0.9.41)` 兼容 Meta `[0.8.35, 0.9.42)`
 
 <img src="/img/deploy/compatibility.excalidraw.png"/>
 
-# databend-query 之间的兼容性
+# databend-query 版本兼容性
 
 ## 版本兼容性矩阵
 
-| Query version      | Backward compatible with  | Key Changes |
+| Query 版本         | 向后兼容版本              | 主要变更 |
 |:-------------------|:--------------------------|:------------|
-| [-∞, 1.2.307)      | [-∞, 1.2.311)             | Original format |
-| [1.2.307, 1.2.311) | [-∞, 1.2.311)             | Added Role info with PB/JSON support |
-| [1.2.311, 1.2.709) | [1.2.307, +∞)             | Role info serialized to PB only |
-| [1.2.709, +∞)      | [1.2.709, +∞)             | **Important**: Fuse storage path changed |
+| [-∞, 1.2.307)      | [-∞, 1.2.311)             | 原始格式 |
+| [1.2.307, 1.2.311) | [-∞, 1.2.311)             | 新增 Role 信息（支持 PB/JSON） |
+| [1.2.311, 1.2.709) | [1.2.307, +∞)             | Role 信息仅序列化为 PB |
+| [1.2.709, +∞)      | [1.2.709, +∞)             | **重要**：Fuse 存储路径变更 |
+
+## 重要变更与升级说明
 
-## Important Changes & Upgrade Instructions
+### 版本 1.2.307
+- 支持通过 PB/JSON 反序列化 Role 信息
+- 仅支持将 Role 信息序列化为 JSON
+- **若使用早期版本，请优先升级至此版本**
 
-### Version 1.2.307
-- Support deserialize Role info with PB and JSON
-- Only support serialize Role info to JSON
-- **Upgrade to this version first** if you're on an earlier version
+### 版本 1.2.311
+- 仅支持将 Role 信息序列化为 PB
+- **升级至 1.2.307 后需升级至此版本**
+- 升级路径示例：`1.2.306 → 1.2.307 → 1.2.311 → 1.2.312`
 
-### Version 1.2.311
-- Only support serialize Role info to PB
-- **Upgrade to this version next** after reaching 1.2.307
-- Example upgrade path: `1.2.306 -> 1.2.307 -> 1.2.311 -> 1.2.312`
+### 版本 1.2.709
+- **重要变更**：Fuse 存储路径调整
+- ⚠️ 1.2.709 之前版本可能无法读取 1.2.709+ 版本的部分数据
+- ⚠️ **建议**：同一租户下所有节点需同时升级
+- 避免混用 1.2.709 前后版本节点，防止数据访问异常
 
-### Version 1.2.709
-- **Important Change**: Fuse storage path modified
-- ⚠️ Versions before 1.2.709 may not be able to read some data from versions 1.2.709+
-- ⚠️ **Recommendation**: All nodes under the same tenant should be upgraded together
-- Avoid mixing nodes with versions before and after 1.2.709 to prevent potential data access issues
+### 版本 1.2.764
+- 若需为 `system_history` 表指定不同存储位置，租户内所有节点需升级至 1.2.764+
 
-## databend-meta 之间的兼容性
+## databend-meta 版本兼容性
 
-| Meta version        | Backward compatible with |
+| Meta 版本           | 向后兼容版本             |
 |:--------------------|:-------------------------|
 | [0.9.41,   1.2.212) | [0.9.41,  1.2.212)       |
 | [1.2.212,  1.2.479) | [0.9.41,  1.2.479)       |
 | [1.2.479,  1.2.655) | [1.2.288, 1.2.655)       |
 | [1.2.655, +∞)       | [1.2.288, +∞)            |
 
-
 ![](@site/static/img/deploy/compat-meta-meta-1-2-655.svg)
 
-- `1.2.53` 不兼容，允许滚动升级，无需传输快照。
-  快照格式已更改，因此在滚动升级期间，
-  它要求所有节点数据都是最新的，确保不需要使用快照进行复制。
-
-- `1.2.163` 功能：gRPC API：添加了 `kv_read_v1()`。用于流式读取。
-
-- `1.2.212` 2023-11-16 功能：raft API：`install_snapshot_v1()`。与旧版本兼容。
-  支持滚动升级。
-  在此版本中，databend-meta raft-server 引入了一个新的 API `install_snapshot_v1()`。
-  raft-client 将尝试使用这个新的 API 或原始的 `install_snapshot()`。
-
-- `1.2.479` 2024-05-21 从客户端和服务器中删除：`install_snapshot()`(v0)。
-  `install_snapshot_v1()` 是安装快照的唯一 API，并且对于客户端来说是**必需的**。
-
-- `1.2.528` 2024-06-13 删除磁盘数据版本 `V001`。使用 `V002` 的第一个版本是 `1.2.53`，2023-08-08。
-  因此，自 `1.2.528` 以来，最旧的兼容版本是 `1.2.53`。
-  因此，自此版本起，兼容性保持不变。
-
-- `1.2.552` 2024-07-02 引入磁盘 `V003`，使用 `rotbl` 格式快照，
-  与 `V002` 兼容。最旧的兼容版本是 `1.2.288`（`1.2.212~1.2.287` 已删除）。
-
-- `1.2.655` 2024-11-11 引入磁盘 `V004`，使用基于 WAL 的 Raft 日志存储，
-  与 `V002` 兼容。最旧的兼容版本是 `1.2.288`（`1.2.212~1.2.287` 已删除）。
-
-
-## databend-meta 磁盘数据的兼容性
-
-Databend-meta 的磁盘数据随着时间的推移而演变，同时保持向后兼容性。
-
-| DataVersion | Databend-version | Min Compatible with |
+- `1.2.53` 不兼容，允许无快照传输的滚动升级  
+  快照格式变更要求所有节点数据保持最新，确保无需快照复制
+- `1.2.163` 功能：新增流式读取 gRPC API `kv_read_v1()`
+- `1.2.212` (2023-11-16) 功能：新增 raft API `install_snapshot_v1`（兼容旧版本，支持滚动升级）  
+  raft-client 将自动选择新 API 或原始 `install_snapshot()`
+- `1.2.479` (2024-05-21) 移除：客户端/服务端的 `install_snapshot()`(v0)  
+  `install_snapshot_v1()` 成为唯一快照安装 API（**必需**）
+- `1.2.528` (2024-06-13) 移除磁盘数据版本 `V001`  
+  首个使用 `V002` 的版本为 `1.2.53` (2023-08-08)，故自此版本起最低兼容版本为 `1.2.53`
+- `1.2.552` (2024-07-02) 引入磁盘数据版本 `V003`（`rotbl` 格式快照，兼容 `V002`）  
+  最低兼容版本为 `1.2.288`（已移除 `1.2.212~1.2.287`）
+- `1.2.655` (2024-11-11) 引入磁盘数据版本 `V004`（基于 WAL 的 Raft 日志存储，兼容 `V002`）  
+  最低兼容版本为 `1.2.288`（已移除 `1.2.212~1.2.287`）
+
+## databend-meta 磁盘数据兼容性
+
+Databend-meta 磁盘数据随版本演进并保持向后兼容：
+
+| 数据版本（DataVersion） | Databend 版本 | 最低兼容版本 |
 |:------------|:-----------------|:--------------------|
 | V004        | 1.2.655          | V002                | 
 | V003        | 1.2.547          | V002                | 
@@ -193,11 +178,11 @@ Databend-meta 的磁盘数据随着时间的推移而演变，同时保持向后
 
 ### 识别版本
 
-启动时，Databend-meta 将显示磁盘数据版本：
-
-例如，运行 `databend-meta --single` 会产生：
+启动时显示磁盘数据版本：
+```shell
+databend-meta --single
 
-```
+# 输出：
 Databend Metasrv
 
 Version: v1.1.33-nightly-...
@@ -207,20 +192,15 @@ On Disk Data:
     Dir: ./.databend/meta
     Version: version=V0, upgrading=None
 ```
+- **工作数据版本（Working DataVersion）**：运行所用版本
+- **磁盘数据版本（On Disk Data Version）**：磁盘数据版本
 
-- `Working DataVersion` 表示 Databend-meta 运行的版本。
-- `On Disk Data -- DataVersion` 表示磁盘数据的版本。
-
-Working DataVersion 必须大于或等于磁盘 DataVersion；否则，它将 panic。
-
-磁盘 DataVersion 必须与当前的 Databend-meta 版本兼容。
-如果不是，系统将提示用户降级 Databend-meta 并以 panic 退出。
+工作数据版本 ≥ 磁盘数据版本（否则 panic）。  
+磁盘数据版本需与当前版本兼容（否则提示降级并退出）。
 
 ### 自动升级
 
-当 `databend-meta` 启动时，如果磁盘数据与工作 DataVersion 兼容，则会升级磁盘数据。
-升级进度将打印到 `stderr` 和 INFO 级别的日志文件中，例如：
-
+启动时若磁盘数据与工作版本兼容，将自动升级。升级进度输出至 `stderr` 和日志：
 ```text
 Upgrade on-disk data
     From: V0(2023-04-21: compatible with openraft v07 and v08, using openraft::compat)
@@ -231,16 +211,11 @@ Upgraded 167 records
 Finished upgrading: version: V001, upgrading: None
 Write header: version: V001, upgrading: None
 ```
-
-如果 `databend-meta` 在升级完成之前崩溃，
-它将清除部分升级的数据，并在再次启动时恢复升级。
+若升级过程中崩溃，重启时将清除部分升级数据并继续。
 
 ### 备份数据兼容性
 
-- 导出的备份数据**只能使用**相同版本的 `databend-metactl` 导入。
-
-- 备份的第一行是版本，例如：
+- 导出备份**仅限**同版本 `databend-metactl` 导入
+- 备份首行为版本标识：  
   `["header",{"DataHeader":{"key":"header","value":{"version":"V100","upgrading":null}}}]`
-
-- 导入时**不会自动升级**。
-  只有在启动 `databend-meta` 时才会自动升级。
+- 导入时**不触发**自动升级（仅 `databend-meta` 启动时执行）