67 lines
3.1 KiB
Markdown
67 lines
3.1 KiB
Markdown
|
# SQLite 单向迁移到 MySQL 8
|
||
|
|
|
||
|
|
这份文档用于把历史 `admin.db` 一次性迁移到新的空 MySQL 8 数据库。迁移不是同步：成功切换后只使用 MySQL，不再把数据写回 SQLite。
|
||
|
|
|
||
|
|
## 1. 安全边界
|
||
|
|
|
||
|
|
- 源 `admin.db` 必须是 schema v8；工具使用操作系统只读模式和 SQLite `query_only` 打开。
|
||
|
|
- 目标必须是本程序刚建立且业务表为空的独立 MySQL 数据库；任何业务表非空都会拒绝执行。
|
||
|
|
- 不支持覆盖、合并、双写和重复导入。重新演练时新建另一个空测试库。
|
||
|
|
- 数据库密码只放环境变量，不要写入命令历史、仓库、日志或工单。
|
||
|
|
- 输出只包含表名和数量，不包含账号、Cookie、Session、订单号或商品明细。
|
||
|
|
|
||
|
|
## 2. 迁移前准备
|
||
|
|
|
||
|
|
先停止旧 Admin 的写入，复制一份只读备份，并记录哈希。以下命令从 `admin/` 目录执行：
|
||
|
|
|
||
|
|
```powershell
|
||
|
|
New-Item -ItemType Directory -Force data\backup
|
||
|
|
Copy-Item data\admin.db data\backup\admin-before-mysql.db
|
||
|
|
Get-FileHash data\admin.db -Algorithm SHA256
|
||
|
|
```
|
||
|
|
|
||
|
|
由数据库管理员提前创建独立的空数据库和最小权限账号。按部署环境设置这五个变量：
|
||
|
|
|
||
|
|
```powershell
|
||
|
|
$env:CMAUTOBUY_DB_HOST="127.0.0.1"
|
||
|
|
$env:CMAUTOBUY_DB_PORT="3307"
|
||
|
|
$env:CMAUTOBUY_DB_NAME="<空数据库名>"
|
||
|
|
$env:CMAUTOBUY_DB_USER="<迁移账号>"
|
||
|
|
$env:CMAUTOBUY_DB_PASSWORD="<从安全渠道取得>"
|
||
|
|
```
|
||
|
|
|
||
|
|
## 3. 先演练
|
||
|
|
|
||
|
|
```powershell
|
||
|
|
go run ./cmd/migrate-sqlite-to-mysql --source data/admin.db --dry-run
|
||
|
|
```
|
||
|
|
|
||
|
|
预期第一行是“演练检查通过，未写入数据”，后面只显示 15 张业务表的数量。此时 MySQL 业务表仍为空。
|
||
|
|
|
||
|
|
## 4. 执行并独立复核
|
||
|
|
|
||
|
|
```powershell
|
||
|
|
go run ./cmd/migrate-sqlite-to-mysql --source data/admin.db --execute
|
||
|
|
go run ./cmd/migrate-sqlite-to-mysql --source data/admin.db --verify-only
|
||
|
|
Get-FileHash data\admin.db -Algorithm SHA256
|
||
|
|
```
|
||
|
|
|
||
|
|
`--execute` 在一个 MySQL 事务中导入全部业务表，然后比较源、目标的逐表数量和全列摘要。`--verify-only` 再独立读取两边核对一次。最后的 SQLite 哈希应与迁移前一致。
|
||
|
|
|
||
|
|
## 5. 失败时怎样处理
|
||
|
|
|
||
|
|
- “SQLite schema 必须是 v8”：先用旧版本 Admin 的迁移逻辑把备份副本升级到 v8，不要直接改 `user_version`。
|
||
|
|
- “MySQL 目标不是空库”：停止操作，换一个新的空数据库；不要手工清表后继续生产迁移。
|
||
|
|
- “无法写入 MySQL”或“数量或内容摘要不一致”：不要启动新 Admin；保留源库和迁移前备份，丢弃本次目标库，修复原因后在新的空库重演。
|
||
|
|
- 迁移失败会回滚业务数据；MySQL schema 建表是可重放的，但业务数据绝不能部分保留后继续补写。
|
||
|
|
|
||
|
|
## 6. 切换门禁
|
||
|
|
|
||
|
|
只有下面各项都完成后才能让生产 Admin 使用新库：
|
||
|
|
|
||
|
|
- 演练、正式迁移和 `--verify-only` 均通过；
|
||
|
|
- SQLite 文件哈希迁移前后相同；
|
||
|
|
- MySQL 已备份，Admin 环境变量由系统服务安全注入；
|
||
|
|
- 页面登录、蝦皮/PDD/顺运宝列表、客户端领取和一次演练模式采购任务冒烟通过；
|
||
|
|
- 旧 `admin.db` 保留为只读回退证据，不再由 Admin 打开。
|