mirror of
https://github.com/t8y2/dbx.git
synced 2026-10-24 23:57:49 +00:00
142 lines
12 KiB
Plaintext
142 lines
12 KiB
Plaintext
---
|
||
title: 数据库支持
|
||
description: 了解 DBX 可以连接哪些数据库，以及每类高级功能支持哪些引擎。
|
||
---
|
||
|
||
<Callout type="info">DBX 主应用会尽量使用 Rust 原生驱动。部分数据库通过 MySQL 或 PostgreSQL 兼容协议连接，部分数据库通过 Agent 驱动或可选的 [JDBC 插件](/cn/docs/plugins) 扩展。</Callout>
|
||
|
||
## 连接类型
|
||
|
||
新建连接窗口会提供带默认端口和驱动标签的预设类型。
|
||
|
||
| 分组 | 类型 | 说明 |
|
||
| ------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
|
||
| 核心 SQL 数据库 | MySQL、PostgreSQL、SQLite、DuckDB、ClickHouse、SQL Server、Oracle、Redshift、DM、GaussDB、KWDB、Teradata、Vertica、Exasol、Firebird、SAP HANA、崖山 YashanDB、GBase | 直接出现在 DBX 连接选择器中 |
|
||
| 文档、键值与配置服务 | Redis、MongoDB、Elasticsearch、etcd、Nacos | 根据数据模型使用专门浏览器、管理控制台或查询流程，不完全等同于关系型表格 |
|
||
| MySQL 兼容类型 | MariaDB、TiDB、OceanBase、Doris、SelectDB、StarRocks、Manticore Search、GoldenDB、TDSQL、PolarDB、GreatSQL、自定义 MySQL | 复用 MySQL 风格连接能力 |
|
||
| PostgreSQL 兼容类型 | openGauss、KingBase、HighGo、Vastbase、CockroachDB、自定义 PostgreSQL | 复用 PostgreSQL 风格连接能力 |
|
||
| 文件型数据库 | SQLite、DuckDB、Microsoft Access、RQLite、Turso | 选择本地数据库文件或 HTTP 端点，不填写主机和端口 |
|
||
| 时序与边缘数据库 | InfluxDB、IoTDB、TDengine、Databend、QuestDB | 面向时序、IoT 或边缘场景优化 |
|
||
| Agent/JDBC 扩展类型 | H2、Snowflake、Trino、PrestoSQL、Hive、DB2、Informix、Neo4j、Cassandra、BigQuery、Kylin、SunDB、XuguDB、Databricks、IRIS、JDBC | 功能覆盖取决于对应驱动路径 |
|
||
|
||
## 默认端口
|
||
|
||
| 类型 | 默认端口 |
|
||
| ------------------------------------------- | -------: |
|
||
| MySQL / MariaDB / GoldenDB / TDSQL / PolarDB / GreatSQL | 3306 |
|
||
| PostgreSQL / openGauss / GaussDB / Vastbase | 5432 |
|
||
| Redis | 6379 |
|
||
| MongoDB | 27017 |
|
||
| ClickHouse | 8123 |
|
||
| SQL Server | 1433 |
|
||
| Oracle | 1521 |
|
||
| Elasticsearch | 9200 |
|
||
| TiDB | 4000 |
|
||
| OceanBase | 2881 |
|
||
| Doris / SelectDB / StarRocks / Databend | 9030 |
|
||
| Manticore Search | 9306 |
|
||
| Redshift | 5439 |
|
||
| CockroachDB | 26257 |
|
||
| DM | 5236 |
|
||
| KingBase | 54321 |
|
||
| HighGo | 5866 |
|
||
| KWDB | 26257 |
|
||
| 崖山 YashanDB | 1688 |
|
||
| GBase | 5258 |
|
||
| Firebird | 3050 |
|
||
| Teradata | 1025 |
|
||
| Vertica | 5433 |
|
||
| Exasol | 8563 |
|
||
| SAP HANA | 39015 |
|
||
| Databricks | 443 |
|
||
| InfluxDB | 8086 |
|
||
| IoTDB | 6667 |
|
||
| etcd | 2379 |
|
||
| Nacos | 8848 |
|
||
| Nacos 控制台/admin API | 8085 |
|
||
| IRIS | 1972 |
|
||
| RQLite | 4001 |
|
||
| H2 | 9092 |
|
||
| Snowflake | 443 |
|
||
| Trino | 8080 |
|
||
| PrestoSQL | 8080 |
|
||
| Hive | 10000 |
|
||
| DB2 | 50000 |
|
||
| Informix | 9088 |
|
||
| Neo4j | 7687 |
|
||
| Cassandra | 9042 |
|
||
| BigQuery | 443 |
|
||
| Kylin | 7070 |
|
||
| SunDB | 22000 |
|
||
| TDengine | 6041 |
|
||
| XuguDB | 5138 |
|
||
| QuestDB | 8812 |
|
||
|
||
<Callout type="info">SQLite、DuckDB、Access 和 JDBC 在不需要网络端口时，会在连接模型中保存为端口 `0`。</Callout>
|
||
|
||
## 功能矩阵
|
||
|
||
DBX 只会在具备足够元数据和 SQL 生成能力的数据库上启用高级功能。
|
||
|
||
| 功能 | 支持类型 |
|
||
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| Schema 感知树 | PostgreSQL、SQL Server、Oracle、Redshift、DM、GaussDB、KWDB、KingBase、HighGo、Vastbase、JDBC、H2、Snowflake、Trino、DB2、TDengine、XuguDB、Teradata、Vertica、Exasol、Firebird、SAP HANA、YashanDB、GBase |
|
||
| ER 图 | MySQL、PostgreSQL、SQLite、SQL Server、Oracle、Redshift、DM、GaussDB、KWDB、KingBase、HighGo、Vastbase、GoldenDB、Access、H2、DB2、Teradata、Vertica、Firebird、Exasol、GBase、YashanDB |
|
||
| 数据库搜索 | MySQL、PostgreSQL、SQLite、SQL Server、Oracle、Redshift、DuckDB、ClickHouse、DM、GaussDB、KWDB、KingBase、HighGo、Vastbase、GoldenDB、Access、H2、Snowflake、Trino、Hive、DB2、Informix、Neo4j、Cassandra、BigQuery、Kylin、SunDB、TDengine、XuguDB、Databricks、Teradata、Vertica |
|
||
| 表数据导入 | MySQL、PostgreSQL、SQLite、DuckDB、ClickHouse、SQL Server、Oracle、Doris、StarRocks、Redshift、DM、GaussDB、KWDB、KingBase、HighGo、Vastbase、GoldenDB、Access、Databend |
|
||
| 几何字段地图预览 | PostgreSQL、HighGo、KingBase、Vastbase、openGauss、GaussDB（PostGIS `geometry` / `geography` 列在结果集中以 WKT 显示，并提供网格工具栏的"地图预览"按钮） |
|
||
| 表结构编辑器 | MySQL、PostgreSQL、SQLite、SQL Server、KWDB |
|
||
| 创建数据库 | MySQL、PostgreSQL、SQL Server、ClickHouse、Oracle、DM、GaussDB、KWDB、Doris、StarRocks、Redshift、Teradata、Vertica |
|
||
| 字段血缘 | MySQL、PostgreSQL、SQLite、SQL Server、Oracle、Redshift、DM、GaussDB、KWDB |
|
||
| 数据传输 | MySQL、PostgreSQL、SQLite、SQL Server、Oracle、ClickHouse、DuckDB、DM、GaussDB、KWDB |
|
||
| 不支持 SQL 文件执行 | Redis、MongoDB、Elasticsearch、etcd、Nacos |
|
||
|
||
<Callout type="warn">如果某个数据库可以连接，但没有出现在某个功能行中，该功能可能会被隐藏或受限。这是为了避免 DBX 生成无法可靠审查的 SQL。</Callout>
|
||
|
||
## 连接选项
|
||
|
||
大多数网络数据库支持主机、端口、用户名、密码、默认数据库、URL 参数、SSL、连接颜色、SSH 隧道和代理设置。文件型数据库会改为选择本地文件。
|
||
|
||
DBX 也可以解析常见连接 URL，例如 MySQL、PostgreSQL、Redis、MongoDB、ClickHouse、SQL Server、Oracle、Elasticsearch、DM、GaussDB、KWDB、openGauss、TDengine、XuguDB、Access、Teradata、Vertica、Firebird、Exasol、GBase、YashanDB、SAP HANA、InfluxDB、QuestDB、IoTDB、etcd、Nacos、RQLite 和 Databricks。
|
||
|
||
### Nacos 控制台
|
||
|
||
Nacos 连接会打开专用管理控制台，用于管理命名空间、配置、服务、实例、配置历史和 Raw API 请求。创建连接时请填写 Nacos 控制台/admin API 地址。Nacos 3 Docker 部署通常使用 `8085` 暴露控制台；旧版本也可能与服务端口共用 `8848`。
|
||
|
||
### ClickHouse TLS
|
||
|
||
ClickHouse 连接支持 TLS 加密。创建 ClickHouse 连接时，启用 TLS 开关即可通过 HTTPS 而非 HTTP 进行连接。建议对生产环境的 ClickHouse 实例或 ClickHouse Cloud 部署启用此选项。
|
||
|
||
### GaussDB 原生驱动
|
||
|
||
GaussDB 和 openGauss 现在使用原生 Rust 驱动（`rust-gaussdb`）而非 ODBC。之前使用 PostgreSQL 兼容路径的连接会自动迁移到 GaussDB 驱动。原生驱动提供更好的类型处理和针对 GaussDB 的元数据支持。
|
||
|
||
### DuckDB 文件与内存模式
|
||
|
||
DuckDB 连接支持两种模式：
|
||
|
||
- **文件模式**：选择 `.db` 或 `.duckdb` 文件进行持久化存储
|
||
- **内存模式**：使用内存数据库进行临时分析。连接关闭后数据会丢失。
|
||
|
||
可以直接从连接表单创建新的 DuckDB 数据库文件，只需输入尚不存在的文件路径即可。
|
||
|
||
### SQLite 内存模式
|
||
|
||
SQLite 连接可以使用 `:memory:` 作为文件路径，创建临时的内存数据库。适用于快速实验或临时数据转换。
|
||
|
||
## 扩展支持
|
||
|
||
当目标数据库不在内置类型中，或团队必须使用厂商 JDBC 驱动时，可以使用 [JDBC 插件](/cn/docs/plugins)。JDBC 会把厂商驱动 JAR 放在 DBX 主应用之外，由你决定安装哪些驱动文件。
|
||
|
||
<Cards>
|
||
<Card title="创建连接" href="/cn/docs/getting-started">
|
||
安装 DBX、选择数据库类型并测试第一个连接。
|
||
</Card>
|
||
<Card title="JDBC 插件" href="/cn/docs/plugins">
|
||
安装可选 JDBC 插件并导入厂商驱动 JAR。
|
||
</Card>
|
||
<Card title="SSH 隧道" href="/cn/docs/ssh-tunnel">
|
||
连接私有网络或跳板机后的数据库。
|
||
</Card>
|
||
</Cards>
|