fj1981/dqex
fj1981/dqex has 87 GitHub stars and 1 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:03 UTC. Last push 2026-10-10.
可以做什么
- Export - ✅ - export (exp) - Schema + data → SQL file (zip / gzip), conditional & consistent
- Import - ✅ - import (imp) - SQL / zip file → database, auto create tables, batch inserts
- Migrate - ✅ - migrate (mig) - Database → database, cross-dialect (e.g. MySQL → PostgreSQL)
- Compare - ✅ - compare (cmp) - Schema & data diff between two databases
实测星标增长
- 24小时
- 0
- 7天
- 更新延迟
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
AI-Native, Offline-First Database Workbench — Import/Export/Migrate/Compare/Snapshot with AI-Assisted SQL (Eino)
数据README.zh-CN.md
原文
🚀 一个工具,覆盖所有环境 —— 包括完全隔离的机房
dqex 是一款跨平台数据库工作台,以单个静态二进制交付 —— 没有 JVM、没有 Electron、没有安装器、不需要联网。它把导入、导出、迁移、对比、快照、Excel 数据字典、完整 SQL 终端和 AI 助手集成于一体,同时提供精美的 Web 界面与可脚本化的 CLI。
- 🪶 零依赖 —— 拷进 U 盘,就能在银行隔离机房跑起来
- 🏢 为受限网络而生 —— 内置离线 SQL 模板库,审计真正要的东西(Excel 数据字典、快照差异报告、可导出的执行历史)都是原生内置,不是事后补丁
- 🤖 不会惊到你的 AI —— 先读你真实的表结构再动手,生成符合方言的 SQL,未经确认绝不执行写操作;不配置 AI,入口根本不渲染
- 🌐 MySQL · PostgreSQL · Oracle —— 跨类型迁移自动做方言转换
⚡ 快速开始
1. 下载 —— 选你的平台,一键直达,无需编译:
| 平台 | 文件 | 直链 |
|---|---|---|
| macOS (Apple Silicon) | dqex-v1.8.0-darwin-arm64.zip |
直接下载 |
| macOS (Intel) | dqex-v1.8.0-darwin-amd64.zip |
直接下载 |
| Linux (x86_64) | dqex-v1.8.0-linux-amd64.zip |
直接下载 |
| Linux (ARM64) | dqex-v1.8.0-linux-arm64.zip |
直接下载 |
| Windows (x86_64) | dqex-v1.8.0-windows-amd64.zip |
直接下载 |
需要锁定某个版本?去Releases 页面选 —— latest 永远指向 v1.8.0。
2. 解压并运行
unzip dqex-*.zip && cd dqex && ./start.sh
:: Windows —— 解压后
start.bat
3. 打开 Web 界面
http://127.0.0.1:8181
就这些 —— 加个连接,开始导出、对比或查询。数据不出你的机器。
可选:装到 PATH、后台运行、或停止服务
./install.sh # 安装到 /usr/local/bin(可选)
dqex# 启动 Web 界面(127.0.0.1:8181)
./start.sh -d # 后台守护
./stop.sh # 停止后台服务
install.bat :: 安装到 %LOCALAPPDATA%\dqex 并加入 PATH
dqex :: 新开终端启动 Web 界面
start.bat -d :: 后台运行
stop.bat :: 停止后台服务
✨ 功能一览
| 功能 | Web | CLI | 说明 |
|---|---|---|---|
| 导出 | ✅ | export (exp) |
结构 + 数据 → SQL 文件(zip / gzip),支持条件过滤与一致性快照 |
| 导入 | ✅ | import (imp) |
SQL / zip 文件 → 数据库,自动建表、批量插入 |
| 迁移 | ✅ | migrate (mig) |
数据库 → 数据库,跨方言(如 MySQL → PostgreSQL) |
| 对比 | ✅ | compare (cmp) |
两个数据库的结构与数据差异 |
| 数据字典 | ✅ | dictionary (dict) |
表结构 + 注释 → 精美 Excel(.xlsx),审计就绪 |
| 快照 | ✅ | snapshot (snap) |
创建 / 列表 / 查看 / 删除 / 对比 全生命周期 |
| SQL 查询 | ✅ | sql |
Web 查询终端 + 表浏览器;CLI 交互式 REPL,支持 JSON 输出 |
| AI 辅助写 SQL | ✅ | sql 内 \ai |
智能体查询真实表结构后生成 SQL(按目标方言),需确认 |
| 连接管理 | ✅ | conn (cn) |
保存 / 测试 / 删除数据库连接 |
| 任务配置 | ✅ | task (tk) |
一键复用任务配置(--task <ID>) |
| 执行历史 | ✅ | history (his) |
执行记录,故障排查与审计导出 |
| Shell 补全 | — | completion |
zsh / bash 补全脚本 |
🤔 为什么是 dqex,而不是 DBeaver?
如果 DBeaver 在你的环境里能跑,就用 DBeaver。 它更成熟、更免费。dqex 不想在"广度"上赢——它是为DBeaver 结构上进不去的环境而生的。
| dqex | DBeaver | Navicat | DataGrip | |
|---|---|---|---|---|
| 交付形式 | 单静态二进制 | JVM + 驱动 jar | 安装器,需授权 | IDE,需授权 |
| 隔离网部署 | 拷贝即跑 | 手动配 JVM + jar | 授权受限 | 授权受限 |
| 首次查询耗时 | 1 分钟内 | 数分钟 | 安装 + 激活 | 安装 + 激活 |
| 跨方言迁移 | 内置,自动 | 无 | 有 | 部分支持 |
| Excel 数据字典 | 一条命令 | 插件 | 有 | 无 |
| 快照差异对比 | 内置 | 无 | 无 | 无 |
| AI 辅助写 SQL | 内置,离线兜底 | 无 | 有限 | 有限 |
| 数据库广度 | MySQL / PostgreSQL / Oracle | 非常广 | 广 | 广 |
| 价格 | 免费,MIT | 免费 | 按席位付费 | 付费 |
dqex 的短板: 它只支持三种数据库,不是二十种。如果你需要 SQL Server、ClickHouse、MongoDB 或 MySQL / PostgreSQL / Oracle 之外的东西,今天 DBeaver 是更好的答案。更多驱动非常欢迎作为贡献提交。
完整对比(含 Bytebase 与已知限制):docs/COMPARISON.md。
🧑💻 CLI 30 秒上手
# 连接只需保存一次,随处复用
dqex conn add --name 生产库 --type mysql --host 10.20.16.170 --port 3317 --un root --pw 'xxx'
# 条件导出 + gzip,带回家调试
dqex exp camunda -s 生产库 -o backup.sql.gz --table-cond "orders:created_at >= '2026-01-01'"
# 还原到本地测试库
dqex imp -t 本地测试库 -i backup.sql.gz --reset drop-and-create
# 交互式 SQL 终端(按目标库方言原生执行)
dqex sql -c 生产库
dqex sql -c 生产库 --json "SELECT id, name FROM users LIMIT 10" # 智能体友好 JSON
# 快照对比 —— 故障排查的杀手级特性
dqex snapshot create -c 生产库 -n 基线
dqex snapshot compare -c 生产库 --a 基线 --b 部署后
# 合规审计:一条命令生成精美 Excel 数据字典
dqex dict camunda -s 生产库 -o 数据字典.xlsx
🤖 AI 辅助写 SQL(可选模块,离线安全)
- 基于真实表结构,杜绝凭空想象 —— 生成前自动查询库表结构(Web 端实时显示查询进度)
- 生成 ≠ 执行 —— AI 只产出 SQL 文本;写操作需二次确认、危险语句被拦截,可
\e编辑后再执行 - 完整辅助闭环 ——
\ai continue基于上文续写;Web 端支持生成 / 解释 / 优化 / 修复,diff 预览后一键应用到编辑器 - 密钥不出本机 —— API Key 存本地,界面仅显示掩码后的端点与模型名
- 未配置无入口 —— BaseURL / API Key / Model 三项齐全才启用,不影响任何既有功能
- 离线兜底 —— 内置 SQL 模板库(
\template top_n orders amount 10),完全隔离网络也能用
🛠️ 从源码构建
make dev # Go :8181 + Vite :5281,热重载 + 调试
make build # 单二进制 ./dqex(内嵌前端)
make release # 跨平台打包 → release/
make install # → /usr/local/bin
🧱 技术栈
- 后端:Go + infrakit(数据库方言适配)、Gin、内嵌 SQLite
- 前端:React + TypeScript + Vite + Tailwind CSS + shadcn/ui + Monaco Editor
- Excel:excelize(纯 Go,无 CGO)
- 交付:单静态二进制内嵌前端,支持深色模式与中英双语
📚 文档
- CLI 使用手册 —— 每个命令、参数与元命令
- Agent 集成指南 —— JSON 输出、脚本化与 CI 流水线(中英双语)
- 常见问题 —— 端口占用、跨机器访问、连接保存等(中英双语)
- 项目概览 —— 设计哲学、用户画像与深度场景
- 竞品对比 —— 与 DBeaver、Navicat、DataGrip、Bytebase 的逐项对比
- 离线运维指南 —— 在隔离网络中运行 dqex
- 开发约定 —— 状态建模与数据流规范(贡献前必读)
🤝 贡献指南
开源因贡献而伟大 —— 而每一次贡献,都会让你离 star 榜更近一步!⭐
我们欢迎:
- 🐛 Bug 修复(最高优先级)
- 📝 文档改进(中英文皆可)
- 🧩 新的 SQL 模板(丰富离线模板库)
- 🗄️ 更多数据库驱动支持
- 🎨 UI/UX 优化
贡献流程:
- Fork 本仓库
- 创建分支:
git checkout -b feature/your-feature - 提交更改:
git commit -am 'feat: add something awesome' - 推送分支:
git push origin feature/your-feature - 发起 Pull Request
代码规范:Go 遵循 gofmt;TypeScript 遵循 ESLint + Prettier;提交信息遵循 Conventional Commits。
📄 许可证
MIT © 2026 fj1981
给 dqex 点个 ⭐ —— 这是对我们最大的鼓励,也让更多开发者发现这个工具。Fork 它、玩它、拆它,然后给我们发个 PR!