如何用C语言连接达梦数据库？详细步骤和代码是什么？

在现代软件开发中，C 语言凭借其卓越的性能和对底层硬件的直接操作能力，在系统级编程、嵌入式开发以及高性能计算领域依然占据着不可动摇的地位，当 C 语言应用需要与数据库交互时，连接国产数据库达梦（DM）成为了一个日益常见的需求，本文将详细、系统地介绍如何在 C 语言环境中连接达梦数据库，涵盖从环境配置到核心代码实现的完整流程，旨在为开发者提供一份清晰、实用的技术指南。

环境准备与驱动配置

在开始编写 C 代码之前，必须确保开发环境已经准备就绪，这包括安装达梦数据库、C 语言编译器以及最关键的 ODBC 驱动。

1. 安装达梦数据库：您需要在服务器或本地机器上安装并配置好达梦数据库，确保数据库服务正在运行，并且您拥有一个可以访问的数据库实例、用户名和密码。

2. 安装 C 语言编译器：在 Linux 系统上，通常使用 GCC（sudo apt-get install build-essential 或 sudo yum groupinstall "Development Tools"），在 Windows 上，可以使用 Visual Studio 提供的 MSVC 编译器或 MinGW-w64。

3. 配置达梦 ODBC 驱动：ODBC（Open Database Connectivity）是 C 语言连接关系型数据库最标准、最通用的方法，达梦数据库提供了完整的 ODBC 驱动包。

   • 驱动安装：ODBC 驱动会随达梦数据库安装包一同提供，如果没有,请从达梦官网下载对应的驱动版本。
   • 配置数据源 (DSN)：ODBC 通过数据源名称（DSN）来定位具体的数据库连接信息，您需要编辑 odbc.ini 文件来创建一个 DSN，该文件通常位于 /etc/（Linux 系统）或 ODBC 安装目录下。

   一个典型的 odbc.ini 配置示例如下：

   配置项	值示例	说明
   [DM8_DSN]	DSN 名称，方括号内为自定义的数据源名。
   Description	DM8 ODBC DSN	对该数据源的描述，可为空。
   Driver	/dm/dmdbms/drivers/odbc/libdodbc.so	至关重要，指定 ODBC 驱动库文件的绝对路径，Windows 下为 .dll 文件。
   SERVER	localhost	数据库服务器地址。
   PORT	5236	数据库监听端口号。
   UID	SYSDBA	登录用户名。
   PWD	SYSDBA	登录密码。
   DATABASE	DAMENG	要连接的数据库名称。

   配置完成后，可以使用 isql -v DM8_DSN（Linux）或 ODBC 数据源管理工具（Windows）测试连接是否成功。

   

C 语言通过 ODBC 连接达梦数据库的核心步骤

ODBC 编程遵循一个固定的流程：分配环境句柄 -> 分配连接句柄 -> 建立连接 -> 分配语句句柄 -> 执行 SQL -> 处理结果 -> 释放资源,理解这个流程是编写代码的关键。

核心代码示例

以下是一个完整的 C 语言示例，它连接到达梦数据库,执行一个简单的查询并打印结果。

#include <stdio.h>
#include <stdlib.h>
#include <sql.h>
#include <sqlext.h>
void handle_error(SQLHANDLE handle, SQLSMALLINT type, RETCODE retCode) {
    SQLCHAR sqlState[6], message[SQL_MAX_MESSAGE_LENGTH];
    SQLINTEGER nativeError;
    SQLSMALLINT i, msgLen;
    if (retCode != SQL_SUCCESS && retCode != SQL_SUCCESS_WITH_INFO) {
        printf("Error occurred!n");
        i = 1;
        while (SQLGetDiagRec(type, handle, i, sqlState, &nativeError, message, sizeof(message), &msgLen) == SQL_SUCCESS) {
            printf("SQLState: %s, Native Error: %ld, Message: %sn", sqlState, nativeError, message);
            i++;
        }
        exit(EXIT_FAILURE);
    }
}
int main() {
    SQLHENV envHandle;
    SQLHDBC dbcHandle;
    SQLHSTMT stmtHandle;
    RETCODE retCode;
    // 1. 分配环境句柄
    retCode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &envHandle);
    handle_error(envHandle, SQL_HANDLE_ENV, retCode);
    // 2. 设置 ODBC 版本
    retCode = SQLSetEnvAttr(envHandle, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0);
    handle_error(envHandle, SQL_HANDLE_ENV, retCode);
    // 3. 分配连接句柄
    retCode = SQLAllocHandle(SQL_HANDLE_DBC, envHandle, &dbcHandle);
    handle_error(dbcHandle, SQL_HANDLE_DBC, retCode);
    // 4. 建立连接 (使用 DSN)
    SQLCHAR dsn[] = "DM8_DSN";
    retCode = SQLConnect(dbcHandle, dsn, SQL_NTS, NULL, SQL_NTS, NULL, SQL_NTS);
    handle_error(dbcHandle, SQL_HANDLE_DBC, retCode);
    printf("Successfully connected to DM database!n");
    // 5. 分配语句句柄并执行查询
    retCode = SQLAllocHandle(SQL_HANDLE_STMT, dbcHandle, &stmtHandle);
    handle_error(stmtHandle, SQL_HANDLE_STMT, retCode);
    SQLCHAR query[] = "SELECT TOP 5 OBJECT_ID, OBJECT_NAME FROM ALL_OBJECTS WHERE OBJECT_TYPE = 'TABLE'";
    retCode = SQLExecDirect(stmtHandle, query, SQL_NTS);
    handle_error(stmtHandle, SQL_HANDLE_STMT, retCode);
    printf("Query Results:n");
    printf("------------n");
    // 6. 绑定列并获取结果
    SQLINTEGER objectId;
    SQLCHAR objectName[256];
    SQLLEN objectIdLen, objectNameLen;
    retCode = SQLBindCol(stmtHandle, 1, SQL_C_LONG, &objectId, 0, &objectIdLen);
    retCode = SQLBindCol(stmtHandle, 2, SQL_C_CHAR, objectName, sizeof(objectName), &objectNameLen);
    while (SQLFetch(stmtHandle) == SQL_SUCCESS) {
        printf("ID: %-5d, Name: %sn", objectId, objectName);
    }
    // 7. 释放资源
    SQLFreeHandle(SQL_HANDLE_STMT, stmtHandle);
    SQLDisconnect(dbcHandle);
    SQLFreeHandle(SQL_HANDLE_DBC, dbcHandle);
    SQLFreeHandle(SQL_HANDLE_ENV, envHandle);
    return 0;
}

编译与运行

在 Linux 系统下，使用 GCC 编译上述代码时，需要链接 ODBC 库 (-lodbc),命令如下：

gcc -o connect_dm connect_dm.c -lodbc

然后运行生成的可执行文件：

./connect_dm

如果一切配置正确,您将看到连接成功的消息以及查询返回的表信息。

最佳实践与注意事项

1. 资源管理：务必确保在程序结束前，使用 SQLFreeHandle 和 SQLDisconnect 释放所有分配的句柄并断开连接,否则可能导致资源泄露。
2. 错误处理：ODBC API 调用可能返回多种状态码（SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR 等），一个健壮的应用程序必须检查每个 API 的返回值，并使用 SQLGetDiagRec 获取详细的错误信息,这对于调试至关重要。
3. 字符编码：达梦数据库内部支持多种字符集，在处理含有中文字符的数据时，需确保 C 程序、ODBC 驱动和数据库的字符集设置一致,避免乱码。
4. SQL 注入防范：当需要根据用户输入构建 SQL 语句时，应优先使用参数化查询（SQLPrepare 和 SQLExecute 配合 SQLBindParameter），而不是直接拼接字符串，以防止 SQL 注入攻击。

探索达梦原生接口 (DPI)

除了通用的 ODBC，达梦数据库还提供了一套原生的 C 语言编程接口（DPI, DM Programming Interface），使用 DPI 可以绕过 ODBC 驱动层，直接调用数据库客户端的动态库，理论上能获得更高的性能和更丰富的数据库特性支持，但其缺点是代码与达梦数据库强绑定，失去了可移植性，对于追求极致性能且不担心厂商锁定的场景，可以考虑使用 DPI，其编程模型与 ODBC 类似,但函数名和参数细节有所不同。

---

相关问答 (FAQs)

问题1：连接失败，提示 “Data source name not found and no default driver specified”，我该怎么办？
解答：这是一个非常常见的错误，意味着 ODBC 管理器无法找到您在 SQLConnect 中指定的 DSN,请按以下步骤排查：

1. ：确保您正在编辑正确的 odbc.ini 文件（通常是 /etc/odbc.ini 或用户家目录下的 .odbc.ini）。
2. 检查 DSN 名称：确保 SQLConnect 函数中传入的 DSN 名称（如示例中的 "DM8_DSN"）与 odbc.ini 文件中方括号 [] 内的名称完全一致,包括大小写。
3. 验证 Driver 路径：检查 odbc.ini 中 Driver 配置项的路径是否正确指向了达梦 ODBC 驱动的库文件（.so 或 .dll）,并且该文件存在且有读取权限。
4. 使用工具测试：在 Linux 下，使用 isql -v <DSN_Name> 命令；在 Windows 下，使用 ODBC 数据源管理器进行测试,可以快速定位是配置问题还是驱动问题。

问题2：ODBC 和达梦自带的 DPI 接口有什么区别，我该如何选择？
解答：两者主要区别在于：

• 标准性与可移植性：ODBC 是行业标准，使用 ODBC 编写的 C 代码只需更换驱动和 DSN 配置，即可连接到其他支持 ODBC 的数据库（如 MySQL, PostgreSQL），可移植性好，DPI 是达梦专有接口,代码与达梦数据库强绑定。
• 性能与功能：DPI 作为原生接口，少了一层驱动转换，理论上性能开销更小，DPI 能第一时间支持达梦数据库新增的一些高级特性，而 ODBC 驱动的更新可能会稍有滞后。
• 部署复杂度：两者都需要安装对应的客户端库，ODBC 需要额外配置 odbc.ini，而 DPI 的连接信息通常直接在代码中指定,配置上可能更直接一些。

选择建议：

• 如果您的项目未来可能需要适配多种数据库，或者您希望代码具备更好的通用性，请优先选择 ODBC。
• 如果您的项目是纯粹的达梦数据库应用，追求极致的性能，并且需要利用达梦独有的高级功能，可以考虑使用 DPI，对于绝大多数应用场景，ODBC 的性能已经足够,其标准化带来的好处远大于理论上微小的性能差距。