# SQLManager

**Repository Path**: waterib/sqlmanager

## Basic Information

- **Project Name**: SQLManager
- **Description**: 一个简单的sql语句管理工具
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SQL Manager

一个**轻量级**的 SQL 连接与查询管理工具。

不是 Navicat、不是 DBeaver —— 没有复杂的导出向导、没有 ER 图、也没有多层菜单。它就是干一件事：**让你把常用的数据库连接和 SQL 语句存起来，随时打开，快速执行，查完就走。**

## 适用场景

- 你手头有一堆数据库要查，但不想每次都翻凭据、开客户端、输密码。
- 你有些 SQL 会反复用到（日报、周报、对账……），不想每次现写或到处贴。
- 你就想要一个**双击打开 → 选中连接 → 选中 SQL → 点执行 → 看结果 → 导出 CSV**的工具。

## 两种使用方式

| 方式 | 启动命令 | 适合 |
|------|---------|------|
| Web 版（Streamlit） | `streamlit run app.py` | 随手开浏览器用，远程也行 |
| 桌面版（tkinter） | `python desktop_app.py` | 本地日常使用，独立窗口 |

两个版本共用同一套连接库和 SQL 库，数据存本地 `sql_manager.db`。

## 功能概览

- **连接管理**：添加、测试、保存 MySQL / PostgreSQL / ClickHouse 连接。
- **SQL 管理**：写好的 SQL 起个名字存起来，下次直接复用。
- **查询执行**：选中连接 → 选中 SQL → 点执行，结果即刻展示。
- **结果导出**：查询结果可导出为 CSV。
- **快速筛选**：SQL 库支持关键词搜索，几十条也不怕找不到。

## 安装 & 运行

```bash
# 1. 装依赖
pip install -r requirements.txt

# 2. 启动（二选一）
streamlit run app.py        # Web 版
python desktop_app.py       # 桌面版
```

## 技术栈

Python · Streamlit · tkinter · SQLAlchemy · SQLite（本地存储）

## 一句话总结

> 比 Navicat 轻一百倍，比记事本好用一百倍。管连接、管 SQL、查数据，够用就好。