# 定时监控MySQL表工具

**Repository Path**: lgordon/TableGuard

## Basic Information

- **Project Name**: 定时监控MySQL表工具
- **Description**: 一个用于实时监控MySQL数据库表变化并发送系统通知的Python工具。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-24
- **Last Updated**: 2025-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MySQL实时监控工具

一个用于实时监控MySQL数据库表变化并发送系统通知的Python工具。

## 功能特点
- 支持同时监控多个MySQL表
- 自定义表名输入功能
- 实时检测新数据插入并发送通知
- 多通知方式支持（plyer和win10toast）
- 中文显示支持
- 详细日志输出

## 安装步骤

1. 克隆或下载项目到本地
2. 安装依赖包：
```
pip install -r requirements.txt
```

## 配置说明

修改main.py文件中的数据库连接配置：
```python
config = {
    'host': '服务器IP',       # MySQL服务器地址
    'port': 3306,            # MySQL端口号
    'user': '用户名',        # 数据库登录用户名
    'password': '密码',      # 数据库登录密码
    'db': '数据库名',        # 要监控的数据库名称
    'charset': 'utf8mb4'     # 字符集设置
}
```

## 使用方法

1. 运行程序：
```
python main.py
```
2. 程序启动后，会提示输入要监控的表名，多个表用逗号分隔：
```
请输入要监控的表名，多个表用逗号分隔: table1,table2,table3
```
3. 程序将开始监控指定的表，并在有新数据插入时发送系统通知

## 注意事项
- 确保MySQL用户具有足够的权限
- 确保Windows系统通知已开启
- 如通知无法显示，请尝试以管理员身份运行程序
- 表结构需要包含自增ID字段（字段名为'id'）

## 故障排除
- **数据库连接失败**：检查数据库配置和网络连接
- **通知不显示**：检查系统通知设置和依赖库安装
- **中文乱码**：确保数据库字符集设置为utf8mb4

## 依赖库
- pymysql: MySQL数据库连接
- plyer: 跨平台通知系统
- win10toast: Windows通知备选方案

## 贡献者
- [刘金成](https://gitee.com/lgordon/)

## 许可证
本项目基于MIT许可证开源，欢迎fork和star支持。

## 项目链接
- [Gitee](https://gitee.com/lgordon/TableGuard)
- [GitHub](https://github.com/lgordon/TableGuard)