feat: add ODBC setup docs for DM and GaussDB, update connection color indicator
This commit is contained in:
t8y2
parent
629bd02b0f
commit
2f3a81b0f1
|
|
@ -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 驱动，安装程序会自动注册。
|
||||
|
|
|
|||
|
|
@ -21,6 +21,8 @@ DBX supports 25+ database engines through native Rust drivers.
|
|||
| SQL Server | tiberius | TDS |
|
||||
| Oracle | oracle-rs | OCI |
|
||||
| Elasticsearch | HTTP client | REST |
|
||||
| DM (Dameng) | odbc-api | ODBC |
|
||||
| GaussDB | odbc-api | ODBC |
|
||||
|
||||
## MySQL Compatible
|
||||
|
||||
|
|
@ -43,13 +45,83 @@ These databases use PostgreSQL protocol and work with the PostgreSQL driver:
|
|||
|
||||
| Database | Default Port | Notes |
|
||||
|---|---|---|
|
||||
| openGauss | 5432 | |
|
||||
| GaussDB | 5432 | |
|
||||
| openGauss | 5432 | Use GaussDB (ODBC) if SHA256 auth fails |
|
||||
| KingBase | 54321 | |
|
||||
| Vastbase | 5432 | |
|
||||
| Redshift | 5439 | |
|
||||
| CockroachDB | 26257 | |
|
||||
| DM (Dameng) | 5236 | Requires PG compatibility mode |
|
||||
|
||||
> **DM (Dameng) Note:**
|
||||
> DM database requires PG compatibility mode to be enabled. Set `COMPATIBLE_MODE=7` in `dm.ini` and restart the service.
|
||||
## ODBC Databases
|
||||
|
||||
DM (Dameng) and GaussDB connect through ODBC, which requires an ODBC driver installed on your system.
|
||||
|
||||
### DM (Dameng)
|
||||
|
||||
DM8 connects via the DM ODBC driver. Default port: **5236**, default user: **SYSDBA**.
|
||||
|
||||
**Linux setup:**
|
||||
|
||||
```bash
|
||||
# Install unixODBC
|
||||
sudo apt install unixodbc
|
||||
|
||||
# Install DM8 (includes ODBC driver)
|
||||
# Download from https://eco.dameng.com/download/
|
||||
|
||||
# Register the driver in /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 setup:**
|
||||
|
||||
The DM8 installer automatically registers the ODBC driver. No manual configuration needed.
|
||||
|
||||
**macOS setup:**
|
||||
|
||||
DM does not provide a native macOS ODBC driver. For development/testing, DM is best accessed from Linux.
|
||||
|
||||
### GaussDB / openGauss
|
||||
|
||||
GaussDB connects via ODBC to bypass its custom SHA256 SASL authentication (which standard PostgreSQL drivers don't support). Default port: **5432**, default user: **gaussdb**.
|
||||
|
||||
> **Tip:** If your openGauss instance uses MD5 authentication, you can connect directly using the PostgreSQL (openGauss) driver without ODBC.
|
||||
|
||||
**Linux setup:**
|
||||
|
||||
```bash
|
||||
# Install unixODBC
|
||||
sudo apt install unixodbc
|
||||
|
||||
# Download GaussDB ODBC driver from Huawei Cloud
|
||||
# https://support.huaweicloud.com/mgtg-dws/dws_01_0032.html
|
||||
|
||||
# Register the driver in /etc/odbcinst.ini
|
||||
sudo tee -a /etc/odbcinst.ini << 'EOF'
|
||||
[GaussDBA]
|
||||
Description = GaussDB ODBC Driver
|
||||
Driver = /usr/lib/odbc/lib/psqlodbcw.so
|
||||
EOF
|
||||
```
|
||||
|
||||
**macOS setup (using psqlODBC as a workaround):**
|
||||
|
||||
```bash
|
||||
# Install unixODBC and psqlODBC
|
||||
brew install unixodbc psqlodbc
|
||||
|
||||
# Register as GaussDBA in odbcinst.ini
|
||||
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 setup:**
|
||||
|
||||
Download and install the GaussDB ODBC driver from [Huawei Cloud](https://support.huaweicloud.com/mgtg-dws/dws_01_0032.html). The installer registers the driver automatically.
|
||||
|
|
|
|||
Loading…
Reference in New Issue