webofmarius/SQLJoiner

来源: https://github.com/webofmarius/SQLJoiner

SQL Joiner

一个面向 MySQL 的可视化 SQL 查询构建器。

通过将表拖拽到画布上、使用连接线关联它们并设置条件来构建 SELECT 查询——全程无需手写 SQL。

SQL Joiner 截图

特性

• 可视化画布 — 从侧边栏将表拖到画布上，然后在列之间绘制连接线
• 连接类型 — INNER、LEFT、RIGHT、FULL OUTER、CROSS
• SELECT 构建器 — 可视化选择列，或切换为原始 SQL 模式；支持列别名、DISTINCT、自定义表达式和字母排序
• WHERE / GROUP BY / HAVING / ORDER BY — 每个子句均可使用可视化或原始 SQL 模式
• 子查询 — 在画布上将子查询添加为命名表
• 导入 SQL — 粘贴现有查询以在画布上逆向工程
• 上下文 — 保存和恢复画布状态（表、连接、条件）
• 笔记 — 为上下文附加自由格式的笔记
• 连接配置 — 存储多个 MySQL 连接配置；可在顶部栏中切换
• 查询取消 — 执行中可取消运行中的查询
• 结果网格 — 分页结果，支持复制到剪贴板
• 画布搜索 — 查找表、别名、连接或孤岛标签

技术栈

环境要求

• PHP 8+ — 必需（唯一硬性依赖）
• Node.js + Electron — 可选，仅当需要桌面应用封装或构建安装程序时需要
• 打包后的应用： PHP 二进制文件已捆绑（Windows 和 Mac 版本包含在 php-bin/ 下）

快速开始

不使用 Electron（仅 PHP）

运行应用的最简单方式——只需 PHP：

bash cd app php -S localhost:8080

然后在浏览器中打开 http://localhost:8080。

使用 Electron（桌面应用）

bash npm install npm start

构建安装程序

需要 Node.js。

bash npm run build:mac # macOS DMG npm run build:win # Windows 安装程序 (NSIS) npm run build:linux # Linux AppImage

输出文件位于 dist/。

项目结构

app/ src/ Core/ Request, Response, ContextManager, AboutManager Database/ Connection (PDO), ProfileManager, SchemaInspector Query/ QueryBuilder, QueryParser, JoinClause, WhereClause, GroupByClause, HavingClause, OrderByClause assets/ js/ Canvas, joins, islands, autocomplete, undo/redo, results, profiles, api storage/ 连接配置和已保存的上下文（JSON） electron/ main.js Electron 入口——启动 PHP 服务器，打开窗口 php-bin/ 捆绑的 PHP 二进制文件（win/、mac/、linux/）

连接配置

配置存储在 app/storage/profiles.json 中。每个配置包含主机、端口、数据库、用户和密码。通过顶部栏中的 配置 进行管理。