docs: add system dependencies and update GaussDB driver info

- Add platform-specific system dependencies (unixODBC, Tauri libs) to
  README and getting-started docs
- Update GaussDB driver from odbc-api to rust-gaussdb in database docs
- Remove obsolete GaussDB ODBC setup instructions
- Fix Docker image and port in getting-started docs
This commit is contained in:
t8y2 committed 2026-05-07 13:18:02 +08:00
1 parent a0ceefd1ef
commit aab6d7c3a4
6 files changed
+85 -100

No files matched your search

+3 -45
View File
@@ -20,7 +20,7 @@ DBX 通过 Rust 原生驱动支持 25+ 种数据库。
| Oracle | oracle-rs | OCI |
| Elasticsearch | HTTP client | REST |
| DM(达梦) | odbc-api | ODBC |
| GaussDB | odbc-api | ODBC |
| GaussDB | rust-gaussdb | GaussDB |
## MySQL 兼容
@@ -43,7 +43,7 @@ DBX 通过 Rust 原生驱动支持 25+ 种数据库。
| 数据库 | 默认端口 | 备注 |
|---|---|---|
| openGauss | 5432 | SHA256 认证失败时可选 GaussDB(ODBC)连接 |
| openGauss | 5432 | |
| KingBase(人大金仓) | 54321 | |
| Vastbase | 5432 | |
| Redshift | 5439 | |
@@ -51,7 +51,7 @@ DBX 通过 Rust 原生驱动支持 25+ 种数据库。
## ODBC 数据库
DM(达梦)和 GaussDB 通过 ODBC 连接,需要在系统上安装对应的 ODBC 驱动。
DM(达梦)通过 ODBC 连接,需要在系统上安装对应的 ODBC 驱动。
### DM(达梦)
@@ -81,45 +81,3 @@ EOF
**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 驱动,安装程序会自动注册。