mescloud/scripts/使用说明.txt

# MES Cloud 数据库备份使用说明

本目录是独立工具，不接入 MES 系统。拷到数据库服务器（Windows）上使用。
不改 MySQL 配置，不重启服务。

## 手动备份（桌面客户端）

1. 把本目录拷到服务器（也可以只拷 MesDbBackup.exe）
2. 双击 MesDbBackup.exe（没有 exe 时再双击「打开数据库备份.bat」）
3. 直接进入备份客户端窗口，不用打开浏览器
4. 填写 MySQL 连接，可先点「测试连接」再「保存配置」
5. 插入 U 盘或移动硬盘，点「浏览文件夹」选择保存目录（不用手输）
6. 点「开始备份」。完成前不要拔盘
   数据会边导出边压缩，并检查剩余空间；窗口内会显示已写入大小

备份文件写在：所选路径\mes_cloud_当天日期.sql.gz

关闭客户端窗口即退出。备份进行中关闭会中断任务。

## 1. 文件说明

- MesDbBackup.exe         备份客户端（推荐，双击后在窗口内操作）
- 打开数据库备份.bat     启动客户端；没有 exe 时回退到网页方式
- pack-exe.ps1            重新生成 exe
- MesDbBackup.cs          客户端源码（导出仍调用 backup-db.ps1）
- db-config.json          MySQL 连接配置（IP/端口/库名/账号/密码）
- backup-ui.html          旧版网页（备用）
- backup-ui-server.ps1    旧版本机网页服务（备用）
- backup-db.ps1           实际导出数据库
- install-backup-task.bat 可选：安装每天 18:00 定时备份
- restore-db.ps1          还原脚本
- 使用说明.txt            本说明

## 2. 备份前准备

- 已安装 MySQL 客户端，能找到 mysqldump.exe、mysql.exe
  （一般在 C:\Program Files\MySQL\MySQL Server x.x\bin）
- 默认连接本机 127.0.0.1:3306，库名 mes_cloud

连接信息在客户端「MySQL 连接」里填写 IP、账号、密码后点「保存配置」，会写入 db-config.json。
仅支持 MySQL。定时备份和还原也读这份配置。

账号具备该库的 SELECT 权限即可，一般用现有 mes_cloud 账号，无需额外授权，也无需重启 MySQL。

## 3. 安装定时任务（可选）

定时备份仍不经过 MES，只是 Windows 计划任务。

1. 将本目录拷到服务器，例如 C:\mes-backup\
2. 右键 install-backup-task.bat → 以管理员身份运行
3. 看到安装完成即可。任务名：MES_Cloud_DB_Backup，每天 18:00 执行到 E:\MES_DB_Backup

安装后建议马上试跑一次：

    cd C:\mes-backup
    powershell -ExecutionPolicy Bypass -File .\backup-db.ps1

## 4. 定时备份结果

    E:\MES_DB_Backup\
      mes_cloud_20260821.sql.gz
      backup.log

同一天重复执行会覆盖当天那一份。超过 $KeepDays（默认 7 天）的旧文件会自动删掉。
手动备份到 U 盘时默认不删旧文件（客户端上可勾选删除超过 7 天的）。

## 5. 还原

还原会覆盖目标库现有数据，请确认后再做。
解压后的 SQL 大约 2GB，Navicat / 查询窗口一般加载不进去，请用 mysql 命令或本脚本：

    powershell -ExecutionPolicy Bypass -File .\restore-db.ps1
    powershell -ExecutionPolicy Bypass -File .\restore-db.ps1 -BackupFile "C:\Users\j2742\Desktop\mes_cloud_20260821.sql.gz"
    powershell -ExecutionPolicy Bypass -File .\restore-db.ps1 -BackupFile "C:\Users\j2742\Desktop\mes_cloud_20260821.sql\mes_cloud_20260821.sql"

按提示输入 YES。.sql 和 .sql.gz 都可以。

桌面上的 mes_cloud_20260821.sql 如果是文件夹，真正的文件在里面那一层。

## 6. 修改配置

打开 db-config.json 或客户端「保存配置」：

- host / port / database / user / password  MySQL 连接（engine 固定为 mysql）
- backup-db.ps1 里的 $BackupRoot            定时备份目录
- $KeepDays                                 定时备份保留天数
- $IgnoreTables 不备份的大表，例如：$IgnoreTables = @("mes_adw300_data")

## 7. 常见问题

重新生成 exe（开发机）：
  powershell -ExecutionPolicy Bypass -File .\pack-exe.ps1

双击 exe 后没有出现客户端窗口
  看任务栏是否已有一个备份窗口。杀毒软件拦截时请放行 MesDbBackup.exe。

找不到 mysqldump.exe
  把 MySQL 的 bin 目录加入系统 PATH，或确认已安装 MySQL 客户端。