在 Windows 下使用 Qt 连接 Ubuntu 上的达梦数据库

最新推荐文章于 2025-04-16 16:07:17 发布

原创最新推荐文章于 2025-04-16 16:07:17 发布 · 1.2k 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#windows #qt #ubuntu

在 Windows 环境下配置 Qt 应用程序，通过 ODBC 驱动成功连接远程的达梦数据库。

环境概述

客户端：Windows 10，Qt Creator（基于 C++ 进行开发）
服务器：Ubuntu，安装了达梦数据库（DM Database）
连接方式：ODBC 驱动程序

1. 安装并配置 ODBC 驱动程序

首先，需要在 Windows 上安装达梦数据库的 ODBC 驱动程序。这个驱动程序用于实现 Qt 应用程序和远程达梦数据库之间的通信。

产品下载-达梦数据

下载 ODBC 驱动：
- 从达梦数据库的官方网站或提供的安装介质下载适用于 Windows 系统的 ODBC 驱动程序。
安装 ODBC 驱动：
- 安装驱动程序，确保在 ODBC 数据源管理器 中可以看到 DM8 ODBC DRIVER，这是连接达梦数据库的关键组件。
检查驱动名称：
- 打开 ODBC 数据源管理器（odbcad32.exe）并切换到 驱动程序 选项卡，确认有 DM8 ODBC DRIVER。你需要在连接字符串中使用这个名称，确保与系统中的驱动名称完全一致。

2. 设置系统环境变量

为了确保 ODBC 驱动程序的所有依赖模块都能够被正确加载，需要将达梦数据库的 bin 目录添加到系统环境变量 Path 中。

打开系统属性：
- 右键点击 此电脑，选择属性 -> 高级系统设置 -> 环境变量。
添加 bin 目录：
- 在系统变量中找到 Path，点击编辑，然后添加 C:\dmdbms\bin，这是达梦数据库安装目录中的 bin 文件夹路径。
重启系统：
- 添加路径后，为确保生效，建议重启计算机。

3. 编写 Qt 数据库连接代码

接下来，在 Qt 中编写代码，通过 ODBC 驱动连接远程达梦数据库。确保驱动名称与 ODBC 数据源管理器中的一致，并正确配置连接参数。

bool dmdb::openConnection()
{
    db = QSqlDatabase::addDatabase("QODBC");
    QString connectionString = "Driver={DM8 ODBC DRIVER};"
                               "Server=192.168.1.223;"
                               "Database=DM_Database;"
                               "Uid=SYSDBA;"
                               "Pwd=GZCI17223;"
                               "Port=5236;"
                               "Encrypt=no;";  // 如果需要禁用加密，可以加入此项

    db.setDatabaseName(connectionString);

    if (!db.open()) {
        qDebug() << "数据库连接失败:" << db.lastError().text();
        return false;
    }

    qDebug() << "数据库连接成功";
    return true;
}

4. 常见问题及解决方案

在连接过程中，可能会遇到一些常见的错误，例如“加密模块加载失败”。以下是一些解决方案：

加密模块加载失败：
- 原因：本地缺少达梦 ODBC 驱动所需的加密库，或者连接字符串中没有正确配置加密选项。
- 解决方案：
  - 确保所有达梦相关的 DLL 文件（包括加密模块）都在 bin 目录中，且路径已添加到 Path 变量。
  - 在连接字符串中添加 Encrypt=no; 来禁用加密，确保问题不是由加密模块引起的。
权限问题：
- 原因：权限不足，可能导致程序无法加载某些 DLL 文件。
- 解决方案：以 管理员权限 运行 Qt 应用程序。
驱动不兼容：
- 原因：ODBC 驱动版本与达梦数据库服务器版本不匹配。
- 解决方案：确保本地安装的 ODBC 驱动版本与服务器上的达梦数据库版本相兼容，必要时可尝试更新驱动程序。