# 数据库支持

> 了解 DBX 的连接 profile、驱动运行时、专用工作区和按能力启用的高级功能。

Source: https://dbxio.com/cn/docs/databases

Language: zh-CN

Relative links resolve against https://dbxio.com/cn/docs/databases.



DBX 的新建连接窗口提供 100+ 数据库和服务 profile。Profile 决定默认端口、表单字段、图标和驱动入口，但“能建立连接”不等于“支持所有高级功能”。

当前版本的连接选择器和 

`crates/dbx-core/assets/database-drivers.manifest.json`

 是数据库类型与能力的权威来源。文档不维护容易过期的全量静态矩阵。

## 连接类型

### 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)。

### Oracle OCI（thick 驱动）

Oracle 连接默认走 thin 驱动；连接对话框的驱动模式里还可以选 **OCI**，它由独立的 `oracle-oci` Agent（基于 Oracle 调用接口构建的 Go agent）承担，连接由 Oracle 客户端库建立。OCI 驱动目前只提供 Windows x64 版本。

* **Instant Client 目录是全局设置**：填写包含 `oci.dll` 的目录，所有 OCI 连接共用；该目录会被加到 Agent 进程的动态库搜索路径最前面。
* **NLS\_LANG 在 Oracle Client 里是进程级的**，所以分两层配置：一个全局默认值，加上可选的连接级覆盖。一旦某个连接覆盖了 NLS\_LANG，它就会独占一个 Agent 进程，字符集不会在连接之间串。
* **TNS 别名与钱包 / sqlnet.ora**：`TNS_ADMIN` 支持全局默认与连接级覆盖（OCI 模式的连接表单里填写目录，留空跟随全局），任何 OCI 连接都能使用 tnsnames.ora 别名、ADB 钱包与 sqlnet.ora 网络选项（压缩、加密），不必切换到 TNS 连接方式；TNS 连接方式下目录也会随连接串传给 Agent 进程。
* OCI 只改变客户端库的加载方式；网格编辑、DDL、传输等功能与 thin 驱动一致。

## 能力等级

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)。

## 相关页面

### [专用工作区](/cn/docs/specialized-workspaces)

查看非关系型、搜索、向量、消息和配置中心界面。

### [驱动管理](/cn/docs/driver-management)

安装和诊断原生 Agent、sidecar、JDBC Agent 和 JRE。

### [生产环境安全](/cn/docs/production-safety)

了解数据库权限、只读保护、生产保护和自动化边界。