---
id: {MIG_ID}
title: {迁移标题}
status: draft
database: {数据库名称}
related_features: []
related_data_contracts: []
---

# {MIG_ID}: {迁移标题}

<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
<!-- 插件模板是入门指导，项目本地模板是权威 -->

## 概述

{描述这个数据库迁移的业务背景、影响范围和目标状态}

## 迁移信息

- **数据库**：{database}
- **迁移类型**：DDL / DML / 混合
- **影响表**：{受影响的表名}
- **预估数据量**：{行数或数据大小}
- **预估执行时间**：{时间}
- **负责人**：{负责人}

## 变更内容

### Schema 变更

```sql
-- 正向迁移
{SQL 语句}
```

| 变更对象 | 变更类型 | 说明 |
|---------|---------|------|
| {表名} | CREATE / ALTER / DROP | {变更描述} |
| {索引名} | CREATE / DROP | {变更描述} |

### 数据迁移

```sql
-- 数据迁移（如适用）
{数据迁移 SQL}
```

- **迁移策略**：{在线迁移 / 停机迁移 / 双写}
- **批次大小**：{每批处理行数}
- **并发度**：{并发线程数}

## 回滚方案

### 回滚 SQL

```sql
-- 回滚迁移
{回滚 SQL 语句}
```

### 回滚条件

- **触发条件**：{什么情况下需要回滚}
- **数据安全**：{回滚是否会导致数据丢失}
- **回滚窗口**：{多长时间内可回滚}

## 兼容性分析

### 应用兼容性

- **向前兼容**：{旧版应用能否在迁移后正常运行}
- **向后兼容**：{新版应用能否在迁移前正常运行}
- **停机要求**：{是否需要停机维护窗口}

### 数据兼容性

- **字段默认值**：{新增字段的默认值策略}
- **NOT NULL 约束**：{如何处理现有空数据}
- **外键约束**：{新增约束的验证策略}

## 性能影响

- **锁策略**：{表锁 / 行锁 / 无锁 DDL}
- **索引影响**：{是否需要重建索引}
- **IO 影响**：{预估 IO 负载}
- **监控指标**：{迁移期间需要关注的指标}

## 验证方案

### 迁移前验证

- [ ] 备份已创建
- [ ] 测试环境已验证
- [ ] 回归测试通过
- [ ] 回滚方案已验证

### 迁移后验证

- [ ] Schema 变更正确
- [ ] 数据完整性校验通过
- [ ] 应用功能正常
- [ ] 性能基线未退化

## 关联制品

- 功能特性：{related_features}
- 数据契约：{related_data_contracts}
- 设计文档：{related_designs}

## 变更日志

| 日期 | 版本 | 变更 | 作者 |
|------|------|------|------|
| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |