如何用 dectl backup 和 restore 备份并恢复 DataEase 数据【免费下载链接】dataease 人人可用的开源 BI 工具数据可视化神器。An open-source BI tool alternative to Tableau.项目地址: https://gitcode.com/GitHub_Trending/da/dataeaseDataEase 以 Docker Compose 方式安装在 Linux 服务器上运行目录默认是/opt/dataease2.0DE_BASE默认为/opt见 install.conf。当需要为升级、卸载或迁移做数据备份时安装过程安装的dectl控制脚本提供了backup和restore两个子命令前者把整个运行目录打成 tar.gz 包后者把备份包解压回运行目录并重启服务。本文基于 installer/dectl 的实际行为说明这两条命令的执行方式、输出判断和边界。备份前先确认这些条件dectl 支持 backup 命令卸载脚本 uninstall.sh 中明确提示“如需备份 DataEase 数据请执行 dectl backup 进行备份。如您的 dectl 命令不支持 backup 命令请升级版本。”执行前可用dectl --help确认命令列表中包含backup和restore不包含则说明当前 dectl 版本过旧。不要在安装目录内执行备份backup 逻辑首先检查工作目录如果当前目录是/opt/dataease2.0或其子目录会直接报错“当前目录为 DataEase 安装目录请切换到其他目录后再执行备份操作”并退出。原因是备份文件生成在当前工作目录若在安装目录内执行会与打包过程相互干扰。备份可能停止服务脚本给出的建议是“如需备份 DataEase 数据建议您先停止 DataEase 服务以保证备份数据的完整性”。停启服务走service dataease stop/service dataease start对应 systemd 服务 dataease.service其ExecStart/ExecStop即dectl start/dectl stop以 root 运行因此 backup/restore 需要以 root 执行。执行备份dectl backup交互模式dectl backup执行后会先输出建议文案然后询问如需备份 DataEase 数据建议您先停止 DataEase 服务以保证备份数据的完整性。 即将备份 DataEase 数据是否需要停止 DataEase 服务? [Y/n]回答y先执行service dataease stop打包完成后执行service dataease start恢复服务回答n不停服直接备份输出“不停服进行备份”其他输入输出“无效输入...”并退出。直接停服备份dectl backup stopstop是脚本唯一识别的参数传入后跳过询问、先停服务再备份。需要注意传入其他任意参数既不会停服也不会触发交互询问脚本会直接按“不停服”方式打包。备份包内容backup 的核心命令是tar --excludelogs/dataease -zcf $backup_file_name -C $DE_RUNNING_BASE .即把运行目录/opt/dataease2.0下的全部文件打包仅排除logs/dataease历史日志。文件名按执行时间自动生成格式为dataease-backup-YYYYMMDD_HHMMSS.tar.gz生成在执行命令时所在的工作目录中。结果判断成功输出备份成功备份文件 : 当前目录绝对路径/dataease-backup-YYYYMMDD_HHMMSS.tar.gz其中的时间和路径以实际执行结果为准请把该绝对路径记录下来restore 时要用失败输出备份失败脚本退出。恢复备份dectl restore用法为dectl restore 备份文件路径例如/root下存放了前面生成的备份文件dectl restore /root/dataease-backup-20260912_030000.tar.gz备份文件路径填相对或绝对路径脚本会做两处前置检查参数为空时报“未指定需要恢复的备份文件”路径不是已存在的文件时报“未找到备份文件 路径”两种情况都不会执行恢复。恢复流程包含明确的数据删除动作执行前必须先确认已了解当前系统状态会被备份包覆盖目标文件是你要恢复的那份备份。通过文件检查后脚本按顺序执行service dataease stop # 停止 DataEase 服务 mkdir -p $DE_RUNNING_BASE # 安装目录不存在时先创建 rm -rf $DE_RUNNING_BASE/data/mysql/* # 删除当前 MySQL 数据目录内容 tar -zxf $target --directory$DE_RUNNING_BASE # 解压备份包回运行目录 service dataease start # 启动服务也就是说/opt/dataease2.0/data/mysql/*会先被清空再用备份包内容覆盖回运行目录。由于备份包含整个安装目录这个流程同样适用于把备份恢复到只装了 dectl 和 Docker 环境的新服务器目录不存在时脚本会先创建解压后运行目录即恢复为备份时的状态。恢复完成后服务会自动启动无需再手动执行dectl start。验证备份与恢复结果备份验证以脚本输出“备份成功备份文件 : …”为准并可到该路径确认文件存在执行前可用dectl status查看运行目录与磁盘占用对备份体积有预估依据该命令会输出 Docker 目录、日志目录和运行目录的du/df结果。恢复后服务状态dectl start内置健康检查_healthcheck最多等待 90 秒轮询容器状态可能输出三种结果DataEase 服务状态 : 正常运行—— 容器 running 且健康检查 healthyDataEase 服务状态 : 无法访问—— 容器状态异常脚本直接退出【警告】服务在等待时间内未完全启动请稍后使用 dectl status 检查服务运行状况。—— 90 秒内未达到 healthy需要稍后自行检查。事后检查执行dectl status查看各容器运行状态和磁盘占用社区版部署的访问地址为http://服务器IP:8100社区模式使用DE_PORTinstall.conf 中默认 8100浏览器访问该地址确认数据已恢复。限制与注意备份包体积取决于安装目录大小生成位置是执行命令的当前目录执行前确认该目录所在磁盘有足够空间。文档未说明配置外部数据库DE_EXTERNAL_MYSQLtrue时备份包对数据库数据的覆盖情况采用该部署方式时不要默认备份包等价于全量数据备份。dectl restore一次只接受一个 tar.gz 文件路径文件不存在或参数为空时命令直接失败退出。备份不停服时回答n或传入非stop参数文档只给出“建议您先停止 DataEase 服务以保证备份数据的完整性”的提示未给出进一步的完整性判定方式。【免费下载链接】dataease 人人可用的开源 BI 工具数据可视化神器。An open-source BI tool alternative to Tableau.项目地址: https://gitcode.com/GitHub_Trending/da/dataease创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考