优化更新

This commit is contained in:
2026-09-13 21:53:16 +08:00
parent 8548fe9ea1
commit 3f8626fb10
84 changed files with 2058 additions and 2594 deletions
@@ -294,13 +294,13 @@ $ python scripts/setup_db.py --drop-first
| 数据库 | DB_DRIVER 值 | 默认端口 | 依赖包 | 脚本目录 |
|:----|:----|:----|:----|:----|
| MySQL | `mysql` | 3306 | PyMySQL | `document/mysql/` |
| PostgreSQL | `postgresql` | 5432 | psycopg[binary] | `document/postgresql/` |
| PostgreSQL | `postgresql` | 5432 | psycopg2-binary | `document/postgresql/` |
| SQL Server | `mssql` | 1433 | pymssql | `document/sqlserver/` |
| SQLite | `sqlite` | - | 内置 | `document/sqlite/` |
| Oracle | `oracle` | 1521 | oracledb | `document/oracle/` |
:::tip 温馨提示
切换数据库驱动后,需要安装对应的驱动包(如 `pip install psycopg[binary]`),然后按照上述步骤重新初始化数据库。
切换数据库驱动后,需要安装对应的驱动包(如 `pip install psycopg2-binary`),然后按照上述步骤重新初始化数据库。
:::
## 种子数据
@@ -380,13 +380,13 @@ flask db stamp head
| 命令 | 对应命令 | 说明 |
|:----|:----|:----|
| `make db-init` | `python scripts/setup_db.py` | 初始化数据库(建库 + 建表 + 种子数据 + flask db stamp) |
| `make seed-dict` | `python scripts/seed_dict.py` | 初始化业务字典数据(幂等,按 code 判重) |
| `make migrate-revision` | `flask db migrate` | 生成增量迁移脚本 |
| `make migrate-upgrade` | `flask db upgrade` | 应用所有待执行的迁移 |
| `make migrate-stamp` | `flask db stamp head` | 标记当前数据库为最新版本 |
| `make db-migrate ARGS="..."` | `python scripts/migrate_db.py ...` | 跨库数据迁移 |
| `make db-migrate-dry-run ARGS="..."` | `python scripts/migrate_db.py ... --dry-run` | 跨库迁移干跑(只核对计划,不写入目标库) |
| `make db-migrate` | `flask db migrate` | 生成增量迁移脚本 |
| `make db-upgrade` | `flask db upgrade` | 应用迁移到最新 |
| `make db-downgrade` | `flask db downgrade` | 回滚一次迁移 |
:::tip 数据库初始化
数据库初始化使用 `python scripts/setup_db.py`(非 Makefile 命令),详见上方「方式二:脚本初始化」章节。跨库数据迁移使用 `python scripts/migrate_db.py`。
:::
## 数据库备份与恢复