# SQL差异比较工具

## 功能描述

该工具用于比较两个由mysqldump生成的SQL文件，找出表结构差异，并自动生成update.sql脚本。

## 使用场景

- 同步两个数据库的结构差异
- 项目A可能是旧数据库，项目B创建了新的字段和表
- 当给项目A更新服务端时，确保数据库结构一致

## 工作原理

1. **读取SQL文件**：从`sql`文件夹中获取两个SQL文件
2. **解析表结构**：提取每个SQL文件中的表结构信息
3. **比较差异**：找出新增的表和新增的字段
4. **生成脚本**：根据差异生成对应的`CREATE TABLE`和`ALTER TABLE`语句
5. **输出结果**：将生成的SQL脚本保存到`out/update.sql`文件中

## 使用方法

### 1. 准备SQL文件

使用`mysqldump`命令生成两个数据库的结构文件：

```bash
# 导出旧数据库结构
mysqldump -u root -p -d old_database > sql/old.sql

# 导出新数据库结构
mysqldump -u root -p -d new_database > sql/new.sql
```

### 2. 运行脚本

```bash
python sql_diff.py
```

### 3. 查看结果

生成的`update.sql`文件将保存在`out`文件夹中，包含：
- 新增表的`CREATE TABLE`语句
- 新增字段的`ALTER TABLE`语句

## 项目结构

```
sql_utils/
├── sql/              # 存放待比较的SQL文件
├── out/              # 存放生成的update.sql文件
├── sql_diff.py       # 主程序文件
└── README.md         # 项目说明文档
```

## 代码说明

### 主要函数

1. **get_sql_files()**：获取sql文件夹中的SQL文件
2. **parse_sql_file(file_path)**：解析SQL文件，提取表结构信息
3. **compare_tables(old_tables, new_tables)**：比较两个表结构字典，找出差异
4. **generate_update_sql(old_file, new_file, diff)**：根据差异生成update.sql语句
5. **main()**：主函数，协调各个步骤

### 依赖

- Python 3.x
- 标准库：os, re, datetime

## 注意事项

1. 确保`sql`文件夹中只有两个SQL文件
2. 建议使用文件名中的`old`关键字标识旧数据库文件，方便程序自动识别
3. 该工具仅比较表结构，不比较数据
4. 生成的SQL脚本需要人工审核后再执行

## 示例

### 输入

`sql/old.sql`（旧数据库结构）
`sql/new.sql`（新数据库结构）

### 输出

```sql
-- SQL差异更新脚本
-- 生成时间: 2023-01-01 12:00:00
-- 比较文件: old.sql (旧) -> new.sql (新)

-- 新增表

CREATE TABLE `new_table` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

-- 新增字段

ALTER TABLE `existing_table` ADD COLUMN `new_field` varchar(255) DEFAULT NULL;
```