graph_rag_server/alembic/README

# Alembic 数据库迁移

本目录包含 RAG 系统的数据库迁移脚本。

## 使用方法

### 创建新迁移

自动生成迁移（推荐）：
```bash
alembic revision --autogenerate -m "描述变更"
```

手动创建迁移：
```bash
alembic revision -m "描述变更"
```

### 应用迁移

升级到最新版本：
```bash
alembic upgrade head
```

升级到特定版本：
```bash
alembic upgrade <revision>
```

### 回滚迁移

回滚一个版本：
```bash
alembic downgrade -1
```

回滚到特定版本：
```bash
alembic downgrade <revision>
```

### 查看迁移状态

查看当前版本：
```bash
alembic current
```

查看迁移历史：
```bash
alembic history
```

查看详细历史：
```bash
alembic history --verbose
```

## 注意事项

1. 在生产环境应用迁移前，务必先在测试环境验证
2. 应用迁移前务必备份数据库
3. 自动生成的迁移可能需要手动调整
4. 确保迁移脚本的 upgrade() 和 downgrade() 函数都正确实现

## 目录结构

- `env.py`: Alembic 环境配置
- `script.py.mako`: 迁移脚本模板
- `versions/`: 迁移脚本目录