dbx/docs/content/docs/databases.cn.mdx

---
title: 数据库支持
description: 了解 DBX 的连接 profile、驱动运行时、专用工作区和按能力启用的高级功能。
---

DBX 的新建连接窗口提供 90+ 数据库和服务 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、Dolt 等 MySQL 协议或语法兼容 profile
- openGauss、GaussDB、KingbaseES、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 分析数据库
- Google Cloud Spanner 等云托管关系型服务（Agent/JDBC，支持 GoogleSQL 与 PostgreSQL 两种方言）

兼容协议只说明连接和部分方言可以复用。数据库版本、系统表、DDL、权限和管理接口不同，DBX 会用独立 profile 或能力覆盖避免错误地启用功能。

### 文件、边缘和托管数据库

- SQLite、DuckDB、Microsoft Access
- Cloudflare D1、Turso、RQLite
- H2 和通过 JDBC URL 访问的本地数据库

Desktop 的文件路径属于本机。Docker/Web 的文件路径属于服务器容器或宿主机挂载目录；浏览器电脑上的路径不会自动映射到服务器。

### 专用数据模型和服务

- Redis、MongoDB
- Elasticsearch、Easysearch、Meilisearch、Manticore Search
- Qdrant、Milvus、Weaviate、ChromaDB
- HBase
- Pulsar、Kafka、RocketMQ、RabbitMQ
- etcd、ZooKeeper、Nacos、Consul KV
- InfluxDB、IoTDB、TDengine 和其它时序/IoT profile

这些连接使用键值、文档、搜索、向量、消息或配置中心工作区，不应套用关系型表格和 SQL 的全部概念。入口详见 [专用工作区](/cn/docs/specialized-workspaces)。

## 驱动运行时

| 运行方式 | 说明 | 典型边界 |
| --- | --- | --- |
| 内置原生 | Rust 驱动编译进 DBX | 安装后可直接使用 |
| 原生 Agent / sidecar | DBX 管理独立 Go/Rust/外部进程 | 需要匹配平台文件；DuckDB、Oracle、KingbaseES、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`、Meilisearch `7700`、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>