大网数据广告活动
数据库部署与 SQL 参考

版本说明

· 52CE 我爱测

## 什么是版本号? Apache Doris 使用三位版本号(X.Y.Z),每个数字代表不同的发布类型: | 版本位 | 名称 | 说明 | |--------|------|------| | X | 主版本 | 重大功能发布或架构升级,周期约 1 年 | | Y | 次版本 | 重要功能、性能优化,周期约 1 季度 | | Z | 补丁版本 | Bug 修复、性能优化,周期 2-4 周 | **示例**:版本号 表示主版本 2,次

什么是版本号?

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 吗?

可以。但是主版本升级,可能涉及数据格式变更。升级前请:

  1. 备份数据
  2. 在测试环境验证
  3. 准备好回滚方案

Q: 补丁版本可以随时升级吗?

可以。补丁版本(如 2.1.0 → 2.1.1)保证前后向兼容,可以随时升降级。

Q: 如何确认当前 Doris 版本?

使用 SELECT VERSION(); 查询当前版本。

Q: Latest 和 Stable 版本分别在哪里下载?

访问 Apache Doris 下载页面 获取所有版本的下载链接。


相关文档

  • [TODO] - 详细的集群升级步骤
  • [TODO] - 如何备份数据

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。