数据库连接指南与兼容性矩阵
汇总 Oracle 内置驱动免配、openGauss sha256 转发、DuckDB 流式查 Parquet、ClickHouse HTTP 接口等实战连接细节,并附完整 18 项真库冒烟兼容台账。
关系型与分析型数据库连接要点 #
DataOmni 内置七套原生关系型驱动(PostgreSQL、MySQL、SQLite、SQL Server、Oracle、DuckDB、ClickHouse),并针对 MariaDB、TiDB、OceanBase、CockroachDB 与 openGauss 做了专门的连接预设与目录方言适配。
| 数据库 | 连接配置与方言注意事项 |
|---|---|
| Oracle(19c / 21c / 23ai) | 安装包已随包集成 Oracle Instant Client(Basic Light),免配环境变量(Linux deb/rpm 自动依赖 libaio)。「数据库」一栏填 Easy Connect 服务名(如 FREEPDB1);加密传输请勾 SSH 隧道;PL/SQL 块以单独一行 / 结尾;遵循 Oracle 语义将空字符串存为 NULL。 |
| PostgreSQL、CockroachDB 与 openGauss | 完整支持 PG 16/17 结构比对、ER 代码生成与 pg_dump。CockroachDB 独立入口默认填 26257 端口与「优先使用 TLS」。openGauss 默认只存 sha256 口令的账号由内置本地转发口(PBKDF2-HMAC-SHA1)自动完成握手并保留 TLS 校验。 |
| MySQL、MariaDB、TiDB 与 OceanBase | 新建 MySQL 连接默认「要求 TLS」——连本地未开加密的实例或旧版 MySQL 5.7(无 ECDHE 套件)请改为「禁用」或「优先使用 TLS」。连 OceanBase(MySQL 模式)选 MySQL、端口填 2881、用户名按 用户@租户(如 root@test)填写。 |
| SQL Server(2019 / 2022) | 纯 Rust TDS 驱动配 rustls(默认「优先使用 TLS」适配默认自签证书)。支持直接运行带 GO 分批的 SSMS 脚本、估算与真实 SHOWPLAN_XML 执行计划树,以及 @@TRANCOUNT 实时事务状态同步。 |
| SQLite 与 DuckDB 2.0 | 可通过「打开数据库文件…」直连本地文件或 :memory:,完整支持 Windows 超 260 字符长路径。DuckDB 内置 parquet 与 json 扩展,可直接流式查询 SELECT * FROM 'events.parquet';注意连接期间 DuckDB 独占文件锁,需在外部程序打开前请先点断开。 |
| ClickHouse | 连接 HTTP 接口(明文默认 8123,TLS 默认 8443,勿填原生协议 9000 端口)。支持 EXPLAIN indexes = 1 跳数索引粒度分析,以及基于 MergeTree _part + _part_offset 前后双重核对的单行安全修改。 |
文档、键值、图与搜索专用工作区 #
不把非关系型数据硬塞进二维 SQL 表格——连上 MongoDB、Redis、Neo4j 或 Elasticsearch / OpenSearch 后,工作台会自动切换为贴合各自数据模型的专用界面:
- MongoDB(7.0 / 8.0 / Atlas SRV):集合浏览、mongosh 语法筛选与聚合管道、保留 ObjectId / Decimal128 / Date 类型的 Extended JSON 文档编辑、采样字段结构统计与 mongodump 备份。
- Redis(7.x / Valkey / Sentinel / Cluster):基于游标的分页 SCAN 键浏览(绝不发 KEYS * 阻塞主线程),String / Hash / List / Set / ZSet / Stream 六种类型专用编辑器、实时 Pub/Sub 订阅与命令台。
- Neo4j(5.x / 2025+ Bolt 4.4–5.8):节点与关系力导向交互画布、属性表格切换、Cypher 参数绑定,以及可视化 PROFILE / EXPLAIN 算子计划树。
- Elasticsearch 8.x & OpenSearch 2.x:多请求 REST 控制台(GET /path + JSON 请求体)、索引健康/映射/别名面板、可视化条件构造器与批量写删二次确认。
18 种服务端真库冒烟测试兼容性矩阵 #
下表每一行均由 src-tauri/tests/*_smoke.rs 连真实数据库实例自动化跑出,计数依次代表「通过 / 跳过 / 夹具不支持」:
| 服务端 | 实测版本 | 连接类型 | 结论 | 冒烟用例(过/跳/挂) | 已验证能力与已知边界 |
|---|---|---|---|---|---|
| PostgreSQL | 16 | PostgreSQL | 完整支持 | 39/0/0 | 完整 SQL 工作台、真实执行计划(EXPLAIN ANALYZE)、绑定参数、结构比对、pg_dump 备份。 |
| MySQL | 8.4 | MySQL | 完整支持 | 42/0/0 | 支持存储过程多结果集、JSON 专用编辑器、TLS 证书校验、结构比对、mysqldump 备份。 |
| MySQL 5.7 | 5.7.44 | MySQL | 可用,有已知边界 | 27+3/0/0* | TLS 需选「禁用」(5.7 无 ECDHE 套件);改列名自动走 CHANGE COLUMN 重述列定义。 |
| SQLite | 随应用内置 | SQLite | 完整支持 | 18/0/0 | 开箱即用,支持 Windows 超 260 字符路径、VACUUM INTO 在线备份、结构比对与 ORM 代码生成。 |
| MariaDB | 11.4 | MySQL | 完整支持 | 43/0/0 | 新建连接有独立入口;JSON 列本质为 LONGTEXT 别名,按文本显示与编辑。 |
| TiDB | 8.5 | MySQL | 完整支持 | 40/0/2* | 解析 EXPLAIN FORMAT='tidb_json';DROP 单独提示不受事务保护;同改列与表名自动拆成两条语句。 |
| SQL Server | 2022 | SQL Server | 完整支持 | 33/0/0 | 支持 GO 分批、多结果集逐个展示、估算与真实执行计划(STATISTICS XML)、结构比对与代码生成。 |
| Oracle | 23ai Free (23.26) | Oracle(内置 OCI) | 完整支持 | 29/1/0 | 内置 Instant Client 免安装;支持按服务名或 SID 连接、服务端取消语句;需加密时走 SSH 隧道。 |
| DuckDB | 2.0.0(内置) | DuckDB | 完整支持 | 19/0/0 | 流式直查大 Parquet / JSON 文件不撑内存;支持 Windows 超长路径与 EXPORT DATABASE 备份。 |
| OceanBase | 4.4.2 CE(MySQL) | MySQL | 可用,有已知边界 | 39/0/3* | 支持用户@租户连接与 CHILD_n 执行计划树;含表达式默认值的列在改结构前请先核对预览语句。 |
| CockroachDB | 25.2 | PostgreSQL | 可用,有已知边界 | 39/0/0 | 触发器走 SHOW CREATE TRIGGER 读取;支持 EXPLAIN (VERBOSE) 与 ANALYZE;改结构逐条提交。 |
| openGauss | 5.0.3(PG 模式) | PostgreSQL | 可用,有已知边界 | 40/0/0 | 内置本地协议转发口,默认只存 sha256 口令的用户可直接按原 TLS 配置登录。 |
| ClickHouse | 25.8 | ClickHouse(HTTP) | 可用,有已知边界 | 17/0/0 | 走 HTTP/HTTPS 接口;MergeTree 单行修改额外锁定 _part 块与 _part_offset,防止无行锁下误改新写入的同名行。 |
| MongoDB | 8.0 | MongoDB | 可用,有已知边界 | 34/0/0 | 专属文档工作区:mongosh 语法筛选与编辑、聚合管道、db.runCommand 命令台,支持 SRV、TLS 与 X.509。 |
| Redis | 7.4 | Redis | 完整支持 | 14/0/0 | 支持单机、Sentinel 与集群;跨主节点 SCAN 翻键、六种类型编辑、JSON 与 pickle 解码高亮、命令行。 |
| Neo4j | 5.26 LTS / 2026.09 | Neo4j(Bolt 5) | 可用,有已知边界 | 10/0/0 | Cypher 编辑器、结果图视图、界面直接编辑节点与建关系、EXPLAIN 与 PROFILE 执行计划。 |
| Elasticsearch | 8.19 / 9.5 | HTTP / API Key | 可用,有已知边界 | 7/0/0 | Kibana Dev Tools 控制台、hits / ES|QL / SQL / 聚合结果表格、映射查看与带乐观锁的单文档增删改。 |
| OpenSearch | 3.8 | Elasticsearch | 可用,有已知边界 | 6/1/0 | 共用 Elasticsearch 工作区(支持账号口令与 TLS,无 API Key,只读账号列不出对象树)。 |