版本说明
什么是版本号？
Apache Doris 使用三位版本号（X.Y.Z），每个数字代表不同的发布类型：
| 版本位 | 名称 | 说明 |
|---|---|---|
| X | 主版本 | 重大功能发布或架构升级，周期约 1 年 |
| Y | 次版本 | 重要功能、性能优化，周期约 1 季度 |
| Z | 补丁版本 | Bug 修复、性能优化，周期 2-4 周 |
示例：版本号 2.1.0 表示主版本 2，次版本 1，补丁版本 0。
升级前必须知道的事
不同版本位的兼容性差异
| 版本类型 | 元数据/数据格式变更 | 兼容性说明 |
|---|---|---|
| 主版本（X） | 可能发生 | 向前兼容，不保证向后兼容 |
| 次版本（Y） | 不变更 | 在不使用新功能的情况下，保证前后兼容 |
| 补丁版本（Z） | 不变更 | 前后向完全兼容，可自由升降级 |
重要提示
主版本升级时，不保证可以降级回老版本。建议升级前备份数据。
升级前检查清单
- 确认目标版本是主版本/次版本还是补丁版本
- 备份重要数据和元数据
- 在测试环境验证升级流程
- 检查版本兼容性说明（如有）
如何选择版本？
Apache Doris 主要维护两个最新版本分支：
| 版本类型 | 适用场景 | 说明 |
|---|---|---|
| Latest | POC、性能测试、试用新功能 | 包含最新功能，可能不稳定 |
| Stable | 生产环境 | 持续接收 Bug 修复，稳定性高 |
选择建议：
- 生产环境 → 选择 Stable
- 探索/测试 → 选择 Latest
CPU 型号与 Binary 选择
Doris 提供三种 Binary 版本，对应不同的 CPU 指令集：
| 版本 | 适用 CPU | 说明 |
|---|---|---|
| x64 (avx2) | 支持 avx2 指令的 x86_64 CPU | 性能最优 |
| x64 (no avx2) | 不支持 avx2 的 x86_64 CPU | 兼容性优先 |
| ARM64 | ARM 架构 CPU | 苹果 M 系列、鲲鹏等 |
如何判断 CPU 支持 avx2？
cat /proc/cpuinfo | grep avx2
如果命令有输出，说明 CPU 支持 avx2 指令集，可选择 x64 (avx2) 版本以获得更好性能。
各版本升级规则
以下矩阵列出了各版本之间的升级注意事项。表格内容将持续更新。
版本升级兼容性矩阵
TODO
| 当前版本 → 目标版本 | 3.0.x | 3.1.x | 4.0.x | 4.1.x |
|---|---|---|---|---|
| 3.0.x | - | |||
| 3.1.x | - | |||
| 4.0.x | - | |||
| 4.1.x | - |
说明
- "-" 表示无需升级（当前版本）
- 空白处表示升级注意事项待补充
- 升级前请务必阅读目标版本的升级文档
常见问题
Q: 可以从 2.0 升级到 3.1 吗？
可以。但是主版本升级，可能涉及数据格式变更。升级前请：
- 备份数据
- 在测试环境验证
- 准备好回滚方案
Q: 补丁版本可以随时升级吗？
可以。补丁版本（如 2.1.0 → 2.1.1）保证前后向兼容，可以随时升降级。
Q: 如何确认当前 Doris 版本？
使用 SELECT VERSION(); 查询当前版本。
Q: Latest 和 Stable 版本分别在哪里下载？
访问 Apache Doris 下载页面 获取所有版本的下载链接。
相关文档
- [TODO] - 详细的集群升级步骤
- [TODO] - 如何备份数据
