mirror of
https://github.com/t8y2/dbx.git
synced 2026-11-13 02:33:39 +08:00
114 lines
6.1 KiB
Plaintext
114 lines
6.1 KiB
Plaintext
---
|
|
title: 数据库支持
|
|
description: 了解 DBX 的连接 profile、驱动运行时、专用工作区和按能力启用的高级功能。
|
|
---
|
|
|
|
DBX 的新建连接窗口提供 70+ 数据库和服务 profile。Profile 决定默认端口、表单字段、图标和驱动入口，但“能建立连接”不等于“支持所有高级功能”。
|
|
|
|
<Callout type="info">当前版本的连接选择器和 `crates/dbx-core/assets/database-drivers.manifest.json` 是数据库类型与能力的权威来源。文档不维护容易过期的全量静态矩阵。</Callout>
|
|
|
|
## 连接类型
|
|
|
|
### SQL 和兼容协议
|
|
|
|
- MySQL、PostgreSQL、SQLite、SQL Server、ClickHouse、Oracle、Redshift 等核心 SQL 数据库
|
|
- MariaDB、TiDB、OceanBase、Doris、SelectDB、StarRocks、Manticore Search、GoldenDB 等 MySQL 协议或语法兼容 profile
|
|
- openGauss、GaussDB、KingBase、HighGo、Vastbase、CockroachDB 等 PostgreSQL 兼容 profile
|
|
- DM、KWDB、YashanDB、GBase、Teradata、Vertica、Exasol、Firebird、SAP HANA 等厂商数据库
|
|
- Snowflake、Trino、PrestoSQL、Hive、Spark、DB2、Informix、Databricks、BigQuery 等 Agent/JDBC 分析数据库
|
|
|
|
兼容协议只说明连接和部分方言可以复用。数据库版本、系统表、DDL、权限和管理接口不同，DBX 会用独立 profile 或能力覆盖避免错误地启用功能。
|
|
|
|
### 文件、边缘和托管数据库
|
|
|
|
- SQLite、DuckDB、Microsoft Access
|
|
- Cloudflare D1、Turso、RQLite
|
|
- H2 和通过 JDBC URL 访问的本地数据库
|
|
|
|
Desktop 的文件路径属于本机。Docker/Web 的文件路径属于服务器容器或宿主机挂载目录；浏览器电脑上的路径不会自动映射到服务器。
|
|
|
|
### 专用数据模型和服务
|
|
|
|
- Redis、MongoDB
|
|
- Elasticsearch、Easysearch、Manticore Search
|
|
- Qdrant、Milvus、Weaviate、ChromaDB
|
|
- HBase
|
|
- Pulsar、Kafka、RocketMQ、RabbitMQ
|
|
- etcd、ZooKeeper、Nacos
|
|
- InfluxDB、IoTDB、TDengine 和其它时序/IoT profile
|
|
|
|
这些连接使用键值、文档、搜索、向量、消息或配置中心工作区，不应套用关系型表格和 SQL 的全部概念。入口详见 [专用工作区](/cn/docs/specialized-workspaces)。
|
|
|
|
## 驱动运行时
|
|
|
|
| 运行方式 | 说明 | 典型边界 |
|
|
| --- | --- | --- |
|
|
| 内置原生 | Rust 驱动编译进 DBX | 安装后可直接使用 |
|
|
| 原生 Agent / sidecar | DBX 管理独立 Go/Rust/外部进程 | 需要匹配平台文件；DuckDB、Oracle、KingBase、XuguDB、RabbitMQ 等路径可能使用独立运行时 |
|
|
| JDBC Agent | Java Agent 加厂商 JDBC 驱动 | 需要 JRE、Agent 和可合法获取的厂商 JAR |
|
|
| JDBC 插件 | 可选通用 JDBC 扩展 | 未识别数据库按通用 JDBC 能力运行 |
|
|
|
|
驱动的安装、更新、离线包和运行时监控见 [驱动管理](/cn/docs/driver-management)；自定义 JDBC 见 [JDBC 插件](/cn/docs/plugins)。
|
|
|
|
## 能力等级
|
|
|
|
DBX 驱动清单使用从连接到操作的能力等级，并允许按数据库覆盖单项能力：
|
|
|
|
| 能力层 | 含义 |
|
|
| --- | --- |
|
|
| Connect | 建立连接并执行该 profile 支持的基础查询 |
|
|
| Browse | 浏览数据库、Schema、表或专用对象 |
|
|
| Understand | 增加对象源码、搜索、关系理解等只读能力 |
|
|
| Operate | 增加表数据编辑等受控写入能力 |
|
|
|
|
具体功能还由独立 capability 控制，例如：
|
|
|
|
- Schema 搜索和 ER 图
|
|
- 表数据编辑和表结构编辑
|
|
- 表导入和数据传输
|
|
- SQL 文件执行
|
|
- 字段血缘和执行计划
|
|
- 创建数据库、用户管理和驱动管理
|
|
|
|
因此菜单是否出现比“数据库名称是否在支持列表中”更能反映当前路径。缺少入口时，应检查 DBX 版本、数据库 profile、驱动模式和已安装组件。
|
|
|
|
## 功能边界
|
|
|
|
### SQL 文件和关系型工具
|
|
|
|
Redis、MongoDB、搜索、向量、HBase、配置中心和消息队列工作区不会使用关系型 SQL 文件执行。部分 SQL 数据库只支持查询和浏览，不支持结构编辑、表导入或数据传输。
|
|
|
|
### 导入和传输
|
|
|
|
[表数据导入](/cn/docs/table-import) 与 [数据传输](/cn/docs/data-transfer) 都按 capability 过滤连接。跨引擎路径还受类型映射、键、identity、Schema 和目标 DDL 能力限制。
|
|
|
|
### 备份和导出
|
|
|
|
- [数据库导出](/cn/docs/database-export) 是能力驱动的逻辑 SQL 导出
|
|
- [数据库备份](/cn/docs/database-backup) 当前只在 Desktop 为 MySQL 和 PostgreSQL 提供定时一致性备份
|
|
- 云同步和配置导出只迁移 DBX 配置，不会备份业务数据库
|
|
|
|
### Desktop 和 Docker/Web
|
|
|
|
两种运行方式共享大部分 Rust 核心查询、元数据和安全策略，但并非功能完全相同。Desktop 才有本地 SQL 文件目录、系统文件选择、Deep Link、本机 CLI Agent 和定时数据库备份；Web 文件、驱动和 Agent 都位于服务器数据目录。
|
|
|
|
## 默认端口和连接 URL
|
|
|
|
连接 profile 会填入常见默认端口，例如 MySQL `3306`、PostgreSQL `5432`、Redis `6379`、MongoDB `27017`、SQL Server `1433`、Oracle `1521`、Elasticsearch `9200`、RabbitMQ AMQP `5672`。这些只是默认值，可以按部署修改。
|
|
|
|
RabbitMQ 等服务可能同时有业务端口和管理 API 端口；自定义 AMQP 端口不能用于推断 Management API 端口。SSH 隧道、HTTP 代理、TLS SNI 和实际拨号目标也应分别确认。
|
|
|
|
DBX 可以解析许多常见 DSN/URL，但不同数据库版本和云厂商参数差异很大。连接测试成功后仍应检查实际数据库、Schema、SSL 和权限范围。
|
|
|
|
## 本地测试环境
|
|
|
|
仓库提供 ClickHouse、MariaDB、MongoDB、MySQL、PostgreSQL 和 Redis 的固定 Docker Compose 测试环境，适合验证连接、驱动行为和回归。详见 [数据库测试实验室](/cn/docs/database-lab)。
|
|
|
|
## 相关页面
|
|
|
|
<Cards>
|
|
<Card title="专用工作区" href="/cn/docs/specialized-workspaces">查看非关系型、搜索、向量、消息和配置中心界面。</Card>
|
|
<Card title="驱动管理" href="/cn/docs/driver-management">安装和诊断原生 Agent、sidecar、JDBC Agent 和 JRE。</Card>
|
|
<Card title="生产环境安全" href="/cn/docs/production-safety">了解数据库权限、只读保护、生产保护和自动化边界。</Card>
|
|
</Cards>
|