# DataShadowArchive

**Repository Path**: AiGenApps/data-shadow-archive

## Basic Information

- **Project Name**: DataShadowArchive
- **Description**: Data Shadow 是一个强大的数据对比工具，专注于多源数据对比分析。支持多种数据源(数据库、Excel、CSV、JSON等)，提供友好的可视化界面展示对比结果。适用于数据迁移验证、系统数据同步校验、数据质量核查等场景。（归档项目，新项目见：https://gitee.com/AiGenApps/data-shadow）
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/AiGenApps/data-shadow
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 4
- **Created**: 2025-01-07
- **Last Updated**: 2025-09-16

## Categories & Tags

**Categories**: dbmanager

**Tags**: Python, 数据对比, Oracle, MySQL, Excel

## README

# Data Shadow - 数据影子对比工具

## 项目介绍
Data Shadow 是一个强大的数据对比工具，专注于多源数据对比分析。支持多种数据源(数据库、Excel、CSV、JSON等)，提供友好的可视化界面展示对比结果。适用于数据迁移验证、系统数据同步校验、数据质量核查等场景。

## 功能截图
![软件界面截图](screenshots/home_page.png)
![软件常见问题截图](screenshots/faq.png)

## 产品说明
### 功能特性
1. 多源数据支持
   - 关系型数据库（MySQL/Oracle）、Excel、CSV、JSON文件
   - 智能字段映射与别名配置
   - 支持主键/联合主键配置
   - 映射方案的保存与加载

2. 高效对比与展示
   - 基于主键快速对比，支持大数据量
   - 数据差异高亮显示
   - 全量/差异数据切换
   - 自定义列名显示（代码/名称）
   
3. 结果导出
   - 支持Excel、CSV、JSON格式
   - 自定义导出模板

### 开发计划
- [x] Oracle数据库支持优化
- [ ] MySQL数据库支持优化
- [ ] 批量对比功能
- [ ] 自定义对比规则
- [ ] 性能优化与界面美化

## 使用说明
### 快速开始
1. 环境准备
   ```bash
   git clone https://gitee.com/yourusername/data-shadow.git
   cd data-shadow
   pip install -r requirements.txt
   ```

2. 数据库支持（可选）
   ```bash
   pip install PyMySQL oracledb
   ```

### 基本操作
1. 配置数据源与映射
2. 设置对比规则
3. 执行对比并查看/导出结果

## 自行开发
### 技术栈
- Python 3.7+
- tkinter (GUI)
- pandas (数据处理)
- PyMySQL/oracledb (数据库连接)
- openpyxl (Excel处理)

### 自行构建
1. 克隆代码仓库
   ```bash
   git clone https://gitee.com/AiGenApps/data-shadow.git
   cd data-shadow
   ```

2. 安装依赖
   ```bash
   pip install -r requirements.txt
   pip install pyinstaller
   ```

3. 根据操作系统执行对应的构建脚本

   Windows:
   ```bash
   build_exe.bat
   ```

   macOS:
   ```bash
   chmod +x build_macos.sh
   ./build_macos.sh
   ```

   Linux:
   ```bash
   chmod +x build_linux.sh
   ./build_linux.sh
   ```

4. 构建完成后，可执行文件将位于 `dist` 目录中
   - Windows: `dist/DataShadow.exe`
   - macOS: `dist/DataShadow`
   - Linux: `dist/DataShadow`

注意：
- 确保已安装 Python 3.7+ 和所需依赖
- macOS 需要安装 Command Line Tools
- Linux 可能需要安装额外的系统依赖（如 tkinter）
  ```bash
  # Ubuntu/Debian
  sudo apt-get install python3-tk
  # CentOS/RHEL
  sudo yum install python3-tkinter
  ```

### 参与开发
欢迎提交 Issue 和 Pull Request 来帮助改进项目。

## 联系方式
- 作者：ns-cn
- 邮箱：ns-cn@qq.com
- 项目地址：https://gitee.com/AiGenApps/data-shadow
- Issues：https://gitee.com/AiGenApps/data-shadow/issues