feat: 18 引擎驱动全家桶 + 驱动管理/离线包 + 设置中心 + 工作台交互打磨
CI / Go server (push) Canceled after 0s
CI / Web + core packages (push) Canceled after 0s
CI / Desktop (Tauri) cargo check (push) Canceled after 0s

驱动接入(全部本机真实例验收):
- Elasticsearch 原生 SQL API、InfluxDB 原生 HTTP+Flux(官方 JDBC 付费许可,实测弃用)
- ZooKeeper/MongoDB JVM agent(连接时自动下载官方驱动 jar,sha256 钉版本到 ~/.opsxdb/drivers/)
- 达梦 JDBC agent 桥就绪(待厂商 jar+实例);TiDB 真实例验收
- 协议族代码审查放行 PolarDB/TDSQL/OceanBase/Kingbase/GaussDB/Oracle
- 驱动能力模型:按驱动开关对象树分组/右键菜单/行编辑,NoSQL 树拍平(对象直挂库节点)

驱动管理:
- 驱动管理弹框(状态/预装/离线包导入/JDK 检测)+ /api/drivers/* 三接口
- opsxdb-driver 驱动商店仓库(清单/fetch.sh/pack.sh 离线包/import.sh)
- 连接时懒加载:DMG 零 Java 产物,首连自动下载(实测 ZK 九件套 1.35s),离线包自动回退

UI/交互:
- 设置中心(⚙):常规/执行/结果/驱动/快捷键/关于,左导航+右面板(对标 opsxshell)
- 实例级展开箭头(行首 SVG chevron,替代字体回退失真的 Unicode 三角)
- 树内嵌套渲染修复:对象树挂在激活连接下;工具栏窄窗口不断行(按钮 nowrap+整颗换行)
- 侧栏连接行精简(图标+连接名)、SQLite SSH 守卫、Oracle 死参数清理

质量:
- Go 协议层/离线回退单测、E2E 门控测试(ES/ZK/Influx/Mongo/TiDB/JDBC 桥)
- 驱动注册表单一事实来源 connection-types.json,README/BACKLOG/AGENTS 同步
This commit is contained in:
logan committed 2026-09-22 01:07:46 +08:00
1 parent 26f459d1b8
commit a9510235bb
156 files changed
+17200 -2520

No files matched your search

+82
View File
@@ -0,0 +1,82 @@
# OpsxDB JDBC Agent
纯 JDK + gson 的通用 JDBC 桥:Go 服务端通过 stdin/stdout 的 JSON Lines 协议驱动一个
本机 JVM 进程,由它加载**官方 JDBC 驱动**(用户自备 jar,许可合规)连接数据库。
设计对标 DBX 的 agent 模式;v1 先接达梦,新增驱动在
`apps/server/internal/db/agent.go` 的 `agentDriverSpecs` 登记一行即可。
## 组成
```
agents/jdbc/OpsxJdbcAgent.java JDBC 通用桥(达梦等官方 JDBC 驱动)
agents/jdbc/OpsxZkAgent.java ZooKeeper 专属桥(官方客户端,NIO socket 免 netty 全家桶之外还需 6 个 netty jar 供 SSL 类初始化)
agents/jdbc/OpsxMongoAgent.java MongoDB 专属桥(官方 sync driver + 迷你 DSL)
apps/server/internal/db/agent.go Go 侧:进程池 / 协议客户端 / 元数据与执行入口(注册表 agentDriverSpecs)
apps/server/internal/db/es.go Elasticsearch 原生接入(HTTP + SQL API)
apps/server/internal/db/influx.go InfluxDB 2.x 原生接入(HTTP + Flux)
```
> Elasticsearch 曾评估走 agent + x-pack-sql-jdbc,实测 basic 许可报
> "current license is non-compliant for [jdbc]"(JDBC/ODBC 是付费客户端),
> 故走原生 HTTP;SQL REST API 在 basic 许可可用。
## 协议(JSON Lines,一行一个对象)
请求 `{ "id": 1, "op": "open", "args": { ... } }`
响应 `{ "id": 1, "ok": true, "result": { ... } }` 或 `{ "id": 1, "ok": false, "error": "..." }`
进程启动后第一行主动推送 hello 公告(agent/version/protocol),供握手校验。
| op | args | result |
|---|---|---|
| `hello` | — | agent/version/protocol |
| `open` | url, user, password, readOnly, props{} | handle |
| `ping` | handle | —(SELECT 1,失败退 DUAL) |
| `query` | handle, sql, maxRows, timeoutSec | columns[], rows[], truncated |
| `exec` | handle, sql, timeoutSec | affectedRows(有结果集时返回行列) |
| `metaDatabases` | handle | names[](无 catalog 退化为 schemas) |
| `metaTables` | handle, schema | names[](TABLE+VIEW,走 DatabaseMetaData) |
| `metaColumns` | handle, schema, table | columns[](name/type/nullable/key) |
| `close` | handle | — |
| `shutdown` | — | 进程退出 |
## 首次启用(达梦)
0. 安装 JDK 17+(或 `export OPSXDB_JAVA_BIN=/path/to/java`)
1. agent jar 与开源驱动 jar 在**首次连接时自动下载**(DMG 不打包 Java 产物,
落盘 `~/.opsxdb/agent/` 与 `~/.opsxdb/drivers/<id>/`,sha256 钉版本);
开发期可用 `OPSXDB_AGENT_JAR` 指向本地构建的 jar
2. 离线/内网环境预放驱动(二选一):
- 开源驱动(MongoDB/ZooKeeper 全套):`git clone gitee.com:attacker/opsxdb-driver && ./opsxdb-driver/scripts/fetch.sh all`
(对标 dbeaver-driver-all 的一键离线包;Maven 自动下载 + sha256 校验)
- 商用驱动:把官方 `DmJdbcDriver-*.jar` 放到 `~/.opsxdb/drivers/dameng/`
(许可原因不代下;`OPSXDB_DAMENG_JARS` 可改目录)
- 离线/内网:opsxdb-driver 仓库 `pack.sh` 打的 zip 放 `~/.opsxdb/offline-driver-pack.zip`,
首次连接时自动导入(网络下载失败自动回退离线包)
4. gson 由 Go 侧首次使用时自动下载(Maven Central → 阿里云镜像,sha1 钉版本校验)
之后前端达梦连接即可测试/连接;未配置时错误信息会逐步提示缺什么。
## 安全约定(与主程序一致,防把业务库查崩)
- `query` 必带 `maxRows` → `Statement.setMaxRows` 硬截断(上限 20000,Go 侧深分页超限直接拒绝)
- 每条语句 `setQueryTimeout`(秒),Go 侧从请求 deadline 推算
- 危险语句拦截(`CheckDangerousSQL`)在 Go 侧入口统一执行,agent 之前
## ZooKeeper / MongoDB 的 SQL 框 DSL
**ZK**:`GET /路径`(读节点:path/data/version/ctime/mtime/ephemeral/children)、
`LS /路径`(列子节点带 stat)、`CREATE /路径 [数据]`、`SET /路径 数据`、`DELETE /路径`(须无子)。
**Mongo**:`db.<集合>.find([filter])`、`db.<集合>.count([filter])`、
`db.<集合>.insertOne({doc})`、`db.<集合>.updateOne({filter},{update})`、
`db.<集合>.deleteOne({filter})`、`db.<集合>.deleteMany({filter})`。
写动词在 Go 侧映射进危险词表(deleteMany→DELETE 等),未确认返回 NeedConfirm。
## 已知限制(v1)
- ctx 取消**不会**真正掐断 JDBC 执行(协议无中断 op),靠 timeoutSec 兜底
- SSH 隧道对 agent 无效(TCP 由 JVM 发起),入口明确拒绝而不是静默失败
- EXPLAIN 走通用 `EXPLAIN ` 前缀,未按方言定制计划格式
- 单元测试用 helper process 扮演 JVM(`go test ./internal/db -run Agent`),无需本机装 Java
- E2E(需真库,docker 见 tests/):`OPSXDB_E2E_JDBC=1`(sqlite-jdbc 验桥)、`OPSXDB_E2E_ES/ZK/INFLUX/MONGO=1`