feat: add ODBC setup docs for DM and GaussDB, update connection color indicator

This commit is contained in:
t8y2 committed 2026-05-07 02:45:59 +08:00
1 parent 629bd02b0f
commit 2f3a81b0f1
2 files changed
+154 -9

No files matched your search

+77 -4
View File
@@ -19,6 +19,8 @@ DBX 通过 Rust 原生驱动支持 25+ 种数据库。
| SQL Server | tiberius | TDS |
| Oracle | oracle-rs | OCI |
| Elasticsearch | HTTP client | REST |
| DM(达梦) | odbc-api | ODBC |
| GaussDB | odbc-api | ODBC |
## MySQL 兼容
@@ -41,12 +43,83 @@ DBX 通过 Rust 原生驱动支持 25+ 种数据库。
| 数据库 | 默认端口 | 备注 |
|---|---|---|
| openGauss | 5432 | |
| GaussDB | 5432 | |
| openGauss | 5432 | SHA256 认证失败时可选 GaussDB(ODBC)连接 |
| KingBase(人大金仓) | 54321 | |
| Vastbase | 5432 | |
| Redshift | 5439 | |
| CockroachDB | 26257 | |
| DM(达梦) | 5236 | 需开启 PG 兼容模式 |
**达梦数据库说明:** 达梦数据库需要开启 PG 兼容模式。在 `dm.ini` 中设置 `COMPATIBLE_MODE=7` 并重启服务。
## ODBC 数据库
DM(达梦)和 GaussDB 通过 ODBC 连接,需要在系统上安装对应的 ODBC 驱动。
### DM(达梦)
达梦 DM8 通过 ODBC 驱动连接。默认端口:**5236**,默认用户:**SYSDBA**。
**Linux 配置:**
```bash
# 安装 unixODBC
sudo apt install unixodbc
# 安装达梦数据库(安装包含 ODBC 驱动)
# 下载地址:https://eco.dameng.com/download/
# 在 /etc/odbcinst.ini 中注册驱动
sudo tee -a /etc/odbcinst.ini << 'EOF'
[DM8 ODBC DRIVER]
Description = DM8 ODBC Driver
Driver = /opt/dmdbms/bin/libdodbc.so
EOF
```
**Windows 配置:**
达梦安装程序会自动注册 ODBC 驱动,无需手动配置。
**macOS 配置:**
达梦暂未提供 macOS 原生 ODBC 驱动。开发/测试建议使用 Linux 环境连接。
### GaussDB / openGauss
GaussDB 通过 ODBC 连接,用于绕过其自有的 SHA256 SASL 认证(标准 PostgreSQL 驱动不支持)。默认端口:**5432**,默认用户:**gaussdb**。
> **提示:** 如果你的 openGauss 实例使用 MD5 认证,可以直接选择 PostgreSQL(openGauss)驱动连接,无需 ODBC。
**Linux 配置:**
```bash
# 安装 unixODBC
sudo apt install unixodbc
# 从华为云下载 GaussDB ODBC 驱动
# https://support.huaweicloud.com/mgtg-dws/dws_01_0032.html
# 在 /etc/odbcinst.ini 中注册驱动
sudo tee -a /etc/odbcinst.ini << 'EOF'
[GaussDBA]
Description = GaussDB ODBC Driver
Driver = /usr/lib/odbc/lib/psqlodbcw.so
EOF
```
**macOS 配置(使用 psqlODBC 替代):**
```bash
# 安装 unixODBC 和 psqlODBC
brew install unixodbc psqlodbc
# 在 odbcinst.ini 中注册为 GaussDBA
DRIVER_PATH=$(find /opt/homebrew/Cellar/psqlodbc -name "psqlodbcw.so" | head -1)
sudo tee -a /opt/homebrew/etc/odbcinst.ini << EOF
[GaussDBA]
Description = GaussDB ODBC Driver (via psqlODBC)
Driver = $DRIVER_PATH
EOF
```
**Windows 配置:**
从[华为云](https://support.huaweicloud.com/mgtg-dws/dws_01_0032.html)下载并安装 GaussDB ODBC 驱动,安装程序会自动注册。