logan
a9510235bb
驱动接入（全部本机真实例验收）： - 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 同步
51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
本章说明各数据库类型的连接表单、URL 格式与高级选项（SSL / SSH 隧道）。
|
||
|
||
## 通用流程
|
||
|
||
1. 连接选择器点「新建」或选某个数据库类型；
|
||
2. 填写表单（不同驱动表单不同，见下表）；
|
||
3. **测试** → 通过后 **保存并连接**。
|
||
|
||
支持直接粘贴 URL 自动填表：
|
||
|
||
```
|
||
mysql://root:pass@127.0.0.1:3306/shop
|
||
postgres://opsx:pass@127.0.0.1:5432/app
|
||
```
|
||
|
||
## 各驱动表单
|
||
|
||
| 驱动 | 表单 | 特有字段 |
|
||
| --- | --- | --- |
|
||
| MySQL / PostgreSQL / SQL Server | standard | host · port · user · password · database · ssl · ssh |
|
||
| Oracle | oracle | host · port · user · password · **service**（如 ORCL） |
|
||
| SQLite | file | database 填本地文件路径（如 `~/data/demo.sqlite`） |
|
||
| Redis | redis | host · port · password · database 序号 · **模式**（单机 / 哨兵 / 集群）· 键分隔符 |
|
||
|
||
表单只收集服务端实际消费的字段；历史遗留的死参数不会出现在表单里。
|
||
|
||
## MySQL 族与 PostgreSQL 族
|
||
|
||
协议兼容的国产库无需单独驱动，直接复用家族驱动：
|
||
|
||
- **MySQL 族**：MariaDB（3307）、TiDB（4000）、OceanBase（2881）、PolarDB / TDSQL（3306）—— 表单里选对应类型即可；
|
||
- **PostgreSQL 族**：GaussDB / openGauss、人大金仓 Kingbase（54321）—— 走 postgres 表单，注意默认库与用户名差异。
|
||
|
||
## SSL / TLS
|
||
|
||
连接表单中开启 **ssl** 即可；按连接独立配置，互不影响。内网自签证书场景按需放宽校验策略。
|
||
|
||
## SSH 隧道
|
||
|
||
数据库在跳板机后面时，开启 **ssh** 字段组，填写跳板机地址与凭据：OpsxDB 会先建 SSH 隧道，再把数据库连接走隧道转发，无需把库端口暴露到公网。
|
||
|
||
## Redis 哨兵与集群
|
||
|
||
- **哨兵**：模式选 Sentinel，填写 Sentinel 节点列表（`host:port`，多行）和主节点名 `masterName`；
|
||
- **集群**：模式选 Cluster，填写至少一个种子节点。对象树只显示 DB 0（Cluster 无 `SELECT`）；
|
||
- 单机模式只填 host/port，与原先一致。
|
||
|
||
字段细节与键浏览见 [Redis 工作台](redis)。
|
||
|
||
> **提示**：连接保存后，后续查询仅携带 `sessionId`，账密不会随每次请求上送；密码在本机混淆存储。
|