3步搞定DataEase v2.x升级：从备份到验证的零故障迁移指南

你是否正为DataEase版本升级发愁？担心数据丢失或配置出错？本文将通过3个核心步骤，帮助你安全完成从v1.x到v2.x的迁移，包含数据备份、智能升级脚本执行和全方位验证方案，让你一小时内完成升级并确保业务连续性。

一、数据安全第一：全量备份策略

升级前必须执行全量备份，防止数据丢失。DataEase提供两种备份方式，根据业务需求选择：

1.1 在线热备份（推荐）

无需停止服务即可备份，适合生产环境：

cd /tmp  # 切换到非安装目录
dectl backup

备份文件默认生成在当前目录，命名格式为dataease-backup-YYYYMMDD_HHMMSS.tar.gz。

1.2 离线冷备份（数据完整性更高）

如需绝对安全，可停止服务后备份：

dectl stop
dectl backup stop  # 带stop参数自动停止并重启服务

备份文件路径示例：/tmp/dataease-backup-20231026_153045.tar.gz

备份文件建议复制到外部存储，工具位置：installer/dectl

二、智能升级：一行命令完成迁移

DataEase v2.x提供自动化升级脚本，会自动检测当前版本并完成配置迁移：

2.1 执行在线升级

dectl upgrade

该命令会：

• 检查当前版本：core/core-backend/src/main/resources/application.yml
• 下载最新v2.x离线包
• 执行数据库迁移：core/core-backend/src/main/resources/db/migration
• 更新系统服务配置

2.2 离线升级方案

若服务器无外网访问，需手动下载升级包：

# 1. 上传离线包到服务器/tmp目录
cd /tmp
tar zxf dataease-online-installer-v2.x.x-ce.tar.gz
cd dataease-online-installer-v2.x.x-ce
./install.sh  # 自动检测并执行升级

升级脚本位置：installer/install.sh

三、全面验证：确保业务零中断

升级完成后需执行以下验证步骤，确保系统正常运行：

3.1 服务状态检查

dectl status

正常输出应显示所有容器状态为Up，示例：

NAME                COMMAND                  STATUS              PORTS
dataease-core       "/entrypoint.sh"         Up 5 minutes        8100/tcp
dataease-mysql      "docker-entrypoint.s…"   Up 5 minutes        3306/tcp

3.2 关键功能验证

1. 登录系统：访问http://服务器IP:8100，默认账号admin/DataEase@123456
2. 数据源检查：验证所有数据源连接状态
3. 报表渲染测试：打开3个以上复杂报表，确认图表正常显示
4. 数据导出功能：测试Excel导出是否正常

3.3 配置文件核对

重点检查v2.x新增配置项：

# 位于[core/core-backend/src/main/resources/application.yml](https://gitcode.com/GitHub_Trending/da/dataease/blob/b52c766ce5673b17719ee261d55f956d5862951e/core/core-backend/src/main/resources/application.yml?utm_source=gitcode_repo_files)
dataease:
  apisix-api:
    domain: http://127.0.0.1:9180
    key: edd1c9f034335f136f87ad84b625c8f1

四、常见问题解决方案

4.1 升级后登录失败

若出现登录认证失败，执行：

dectl restart

该问题通常由于缓存未清理，重启服务即可解决。

4.2 报表数据异常

检查数据库迁移日志：

cat /opt/dataease2.0/logs/dataease/info.log | grep migration

若发现SQL错误，手动执行对应版本迁移脚本：

mysql -u root -p dataease < core/core-backend/src/main/resources/db/migration/V2.1__ddl.sql

4.3 前端界面错乱

重建前端资源：

cd core/core-frontend
npm run build:distributed  # 构建脚本位置：[core/core-frontend/package.json](https://gitcode.com/GitHub_Trending/da/dataease/blob/b52c766ce5673b17719ee261d55f956d5862951e/core/core-frontend/package.json?utm_source=gitcode_repo_files)

五、升级后新功能体验

升级完成后，推荐体验v2.x核心新功能：

• 全新数据大屏编辑器：core/core-frontend/src/views/dashboard
• 多数据源联邦查询：支持跨库联合分析
• 增强的数据权限管理：精细化权限控制

官方使用案例参考：docs/use-cases.md

通过以上步骤，你已成功完成DataEase从v1.x到v2.x的升级。如有其他问题，可查阅完整文档或提交issue获取支持。