# 跨库数据迁移

:::tip 说明
项目提供 `scripts/migrate_db.py` 脚本，支持在不同数据库之间迁移数据（如 MySQL → PostgreSQL / SQL Server / SQLite / Oracle）。脚本独立运行，参数显式给出，不依赖 `.env`。
:::

## 使用场景

| 场景 | 说明 |
|:-----|:-----|
| MySQL → PostgreSQL | 生产环境切换数据库 |
| MySQL → SQL Server | 企业环境适配 |
| MySQL → SQLite | 开发/测试环境轻量化 |
| MySQL → Oracle | 企业级数据库适配 |

## 命令行参数

```bash
python scripts/migrate_db.py --help
```

| 参数 | 必填 | 说明 | 示例 |
|:-----|:-----|:-----|:-----|
| `--source-db` | 是 | 源数据库类型 | `mysql` |
| `--target-db` | 是 | 目标数据库类型 | `postgresql` |
| `--source-url` | 是 | 源数据库连接 URL | `mysql+pymysql://root:123456@localhost:3306/db` |
| `--target-url` | 是 | 目标数据库连接 URL | `postgresql://postgres:123456@localhost:5432/db` |

## 使用示例

### MySQL → PostgreSQL

```bash
python scripts/migrate_db.py \
    --source-db mysql \
    --target-db postgresql \
    --source-url "mysql+pymysql://root:123456@localhost:3306/djangoadmin" \
    --target-url "postgresql://postgres:123456@localhost:5432/djangoadmin"
```

### MySQL → SQLite

```bash
python scripts/migrate_db.py \
    --source-db mysql \
    --target-db sqlite \
    --source-url "mysql+pymysql://root:123456@localhost:3306/djangoadmin" \
    --target-url "sqlite:///djangoadmin.db"
```

## 迁移流程

```
1. 连接源数据库和目标数据库
2. 读取源数据库所有表结构
3. 在目标数据库创建对应表（Base.metadata.create_all）
4. 逐表读取源数据 → 批量插入目标数据库
5. 输出迁移统计（表数、行数、耗时）
```

## 注意事项

:::warning 迁移前备份
跨库迁移前务必备份目标数据库，避免数据丢失。
:::

- 迁移脚本会先在目标库创建表结构（如已存在则跳过）
- 数据迁移采用批量插入，大表迁移可能需要较长时间
- 不同数据库的字段类型差异由 SQLAlchemy 方言层自动处理
- 迁移完成后建议在目标库执行 `scripts/seed_dict.py` 补充字典数据

## 相关脚本

| 脚本 | 用途 |
|:-----|:-----|
| `scripts/migrate_db.py` | 跨库数据迁移 |
| `scripts/seed_dict.py` | 字典数据初始化 |
| `scripts/init_db.py` | 数据库初始化（建库建表） |
| `scripts/health_check.py` | 健康检查 |

## 总结

跨库数据迁移脚本支持 MySQL / PostgreSQL / SQL Server / SQLite / Oracle 之间的数据迁移，参数显式给出，不依赖 `.env` 配置。迁移前务必备份目标数据库。