DataEase 2.x 版本升级实操在线与离线双路径及完整回滚【免费下载链接】dataease 人人可用的开源 BI 工具数据可视化神器。An open-source BI tool alternative to Tableau.项目地址: https://gitcode.com/GitHub_Trending/da/dataease上周给一台生产机做 DataEase开源 BI、数据可视化工具2.x 版本升级dectl upgrade跑到一半核心容器反复重启。最后定位是迁移中途磁盘写满数据库迁移脚本没跑完。别急着重跑先把下面的路径走一遍同样的坑大概率不会再踩。升级前必做的 5 项检查与基线导出先说结论翻车大多不在升级那一条命令上而出在升级之前没留退路。下面这张表左列必做右列推荐。检查项命令 / 动作一句话说明导出基线快照dectl backup升级前唯一的退路务必落盘到 /opt 之外磁盘余量df -H /opt运行目录所在分区建议 ≥ 20GBinstall.sh内置检查线版本基线dectl version确认当前版本在 v2 系列v1 无法直升 2.x旧镜像盘点docker images \| grep dataease记录旧镜像 tag升级完才好清理网络可达性curl -m 5 -sI https://github.com在线升级要拉 GitHub release不通就走离线介质依赖与端口核对 docker / docker compose 版本放行 8100 端口容器编排和防火墙是启动失败的高发原因基线快照导出的完整操作cd /tmp # 切出安装目录否则脚本会拒绝执行 dectl backup # 按提示选择停服数据一致性最高 ls -lh dataease-backup-*.tar.gz # 确认产物生成 cp dataease-backup-*.tar.gz /backup/ # 拷贝出机器别只留一份⚠️ 停服状态下导出的快照才是回滚时最放心的那种。磁盘余量不用拍脑袋installer/install.sh 里就有 20GB 的检查阈值脚本会在空间不足时打印红色警告。在线直连dectl upgrade 一把过前提机器能连 github.com。一条命令版本比对、离线包下载、解压、执行安装全在内部完成dectl upgrade预期输出按顺序出现才算正常推进current version is v2.x.x latest version is v2.y.y 检测到 github.com 上最新版本为 v2.y.y 即将执行在线升级... 开始下载最新版本... 升级完成 脚本自己会处理停机、文件更新和服务重启看到「升级完成」横幅基本就稳了。失败时第一反应卡在「连接下载服务器超时」说明在线路径走不通直接转下一节的离线介质或者隔几分钟重跑dectl upgrade。离线介质没有外网怎么拉包服务器不能出公网时离线介质是唯一路径把离线包dataease-online-installer-版本号-ce.tar.gz传到服务器再解压执行cd /tmp tar zxf dataease-online-installer-v2.y.y-ce.tar.gz cd dataease-online-installer-v2.y.y-ce # 先核对 DE_BASE 与现有安装目录一致避免装错位置 grep ^DE_BASE install.conf /usr/bin/dectl /bin/bash install.sh预期输出与在线路径相同以「升级完成」结尾。失败时第一反应脚本报「系统当前版本不是 DataEase v2 版本系列不支持升级到 v2」说明离线包与现有安装不匹配换成与当前版本同代的离线包重来。升级脚本本体installer/install.sh。跑完这一条验证动作是固定的dectl status # 容器全部 Up健康检查显示 正常运行 grep -i migration /opt/dataease2.0/logs/dataease/info.log | tail -20✅ 容器状态正常、能登录、数据源连接成功这次升级才算收尾。翻车了怎么办异常速查与完整回滚如果出现登录失败或认证异常先跑dectl status确认服务是否真的起来了再看/opt/dataease2.0/logs/dataease/error.log定位报错最后dectl restart重启。如果出现容器反复重启、健康检查一直「无法访问」先docker logs看容器日志里启动阶段的报错常见是配置或端口冲突再决定重跑还是回滚。如果出现迁移报错说明数据库升级脚本中途失败。迁移 SQL 由后端内置执行脚本存放在 core/core-backend/src/main/resources/db/migration版本号命名的 DDL 文件日志里出现 SQL 错误就不要手工改表直接走下面的回滚。回滚路径一条完整路线前提升级前导出了基线快照dectl stop # 停止服务 dectl restore /backup/dataease-backup-20260904_093000.tar.gz # 清掉当前 MySQL 数据并解压快照随后自动拉起服务 dectl status # 验证容器回到 Up跑完登录确认系统即回到升级前状态。升级前的快照不是「以防万一」是回滚的唯一入场券。升级前后能力对照维度升级前升级后版本基线旧 v2.x 版本最新稳定 v2.x迁移脚本自动补全可视化基础图表与看板全新数据大屏编辑器布局与联动增强查询能力单数据源为主多数据源联邦查询支持跨库联合分析功能细节点到为止下一步翻官方文档docs/use-cases.md 里的场景演示可以直接照着试。【免费下载链接】dataease 人人可用的开源 BI 工具数据可视化神器。An open-source BI tool alternative to Tableau.项目地址: https://gitcode.com/GitHub_Trending/da/dataease创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考