# db-diff

**Repository Path**: ddlisbug/db-diff

## Basic Information

- **Project Name**: db-diff
- **Description**: db-diff 是基于 JavaFX 的开源数据库表差异分析工具，原生支持 MySQL，可比对表结构与数据差异，直观展示变化并生成差异脚本。帮助开发者高效管理数据库变更。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-07-18
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 数据库差异对比工具（db-diff）

本项目是一个用于比较两个数据库之间结构和数据差异的桌面应用程序，适用于需要对数据库进行迁移或一致性检查的场景。

## 功能特性

- **数据库连接管理**：支持添加、删除和测试数据库连接。
- **结构差异比较**：能够比较两个数据库中表结构的差异，并生成相应的 DDL 语句。
- **数据一致性检查**：支持对两个数据库中相同表的数据进行比对，检查数据是否一致。
- **表数据导出**：提供一键复制功能，便于将差异数据的 DDL 语句快速导出。

## 技术栈

- JavaFX：用于构建桌面应用程序的 UI。
- JDBC：用于数据库连接与查询。
- Maven：项目依赖管理。

## 安装与运行

### 环境要求

- Java 8 或更高版本
- 支持的数据库类型：任何可通过 JDBC 访问的数据库（如 MySQL、PostgreSQL、Oracle 等）

### 构建项目

1. 克隆项目到本地：
   ```bash
   git clone https://gitee.com/ddlisbug/db-diff.git
   ```

2. 进入项目目录并使用 Maven 构建：
   ```bash
   cd db-diff
   mvn clean package
   ```

### 运行项目

1. 构建完成后，运行以下命令启动应用程序：
   ```bash
   java -jar target/db-diff.jar
   ```

## 使用说明

1. **配置数据库连接**
   - 点击菜单栏中的 `数据库管理`，添加源数据库和目标数据库的连接信息。
   - 提供数据库名称、URL、用户名和密码等信息，测试连接确保配置正确。

2. **选择数据库与表**
   - 在主界面中，从下拉菜单选择源数据库和目标数据库。
   - 输入需要比对的表名，或者点击 `选择表` 按钮进行多表选择。

3. **比较结构或数据**
   - 选择比对类型（结构差异或数据差异）。
   - 点击 `开始比对`，系统将展示差异结果。

4. **生成 DDL 或处理数据**
   - 若比对结构差异，可以在文本框中看到对应的 DDL 语句。
   - 使用 `复制` 按钮将 DDL 语句复制到剪贴板。

5. **提示与反馈**
   - 比对过程中会显示等待界面，完成后自动关闭。
   - 若出现错误，会弹出提示框显示详细信息。

## 贡献说明

欢迎提交 PR 优化本工具：
- 修复 Bug
- 增加新特性，如支持更多数据库类型或增强比对功能
- 改进 UI 交互体验

提交前请确保：
1. 遵循项目代码风格。
2. 提供清晰的提交信息。
3. 在本地测试通过。

## 许可证

本项目基于 [MIT License](LICENSE)，允许在开源或商业项目中自由使用和修改。

## 联系方式

如有问题或建议，欢迎通过 [Gitee Issues](https://gitee.com/ddlisbug/db-diff/issues) 提交反馈。