FreeTDS C 接口访问 SQL Server 的实战教程

FreeTDS 是一个开源的库，它允许在 Linux 和其他类 Unix 系统上通过 TDS（Tabular Data Stream）协议与 Microsoft SQL Server 进行通信。通过 C 接口，开发者可以使用 FreeTDS 在应用程序中访问 SQL Server 数据库。本文将详细介绍如何通过 FreeTDS C 接口访问 SQL Server，包括环境搭建、配置、基本操作以及一些实战技巧。

一、环境搭建与安装

1. 安装 FreeTDS

在开始使用 FreeTDS 之前，首先需要在系统上安装 FreeTDS 库。在 Linux 系统上，可以通过包管理工具（如 apt-get、yum）来安装。

Ubuntu/Debian 系统：

sudo apt-get update
sudo apt-get install freetds-dev

CentOS/RHEL 系统：

sudo yum install freetds-devel

2. 安装 TDS 驱动

FreeTDS 安装完成后，你需要配置 TDS 驱动以便能够与 SQL Server 进行通信。配置通常包括编辑 FreeTDS 的配置文件 /etc/freetds/freetds.conf，指定 SQL Server 的地址和端口。

编辑 /etc/freetds/freetds.conf 文件，添加 SQL Server 配置信息：

[MyServer]
    host = 192.168.1.100
    port = 1433
    tds version = 7.3

其中：

• MyServer 是连接的 SQL Server 的名称（可以自定义）。
• host 是 SQL Server 的 IP 地址或主机名。
• port 是 SQL Server 的端口（默认是 1433）。
• tds version 是 TDS 协议的版本，通常 SQL Server 2012 或更高版本使用 7.3。

二、C 接口连接 SQL Server

1. 编写 C 程序

FreeTDS 提供了一个 ct_lib 库，可以通过 C 接口访问 SQL Server。以下是一个简单的 C 程序，演示如何使用 FreeTDS 连接到 SQL Server，并执行查询。

#include <stdio.h>
#include <stdlib.h>
#include <sybdb.h>

int main() {
    DBPROCESS *dbproc;
    LOGINREC *login;
    DBRESULT *result;
    DBINT numcols, i;
    char *server = "MyServer";  // 配置的服务器名称
    char *query = "SELECT name, age FROM users";  // 查询语句

    // 初始化 FreeTDS 库
    dbinit();

    // 创建登录信息
    login = dblogin();
    DBSETLUSER(login, "username");  // 数据库用户名
    DBSETLPWD(login, "password");  // 数据库密码

    // 连接数据库
    dbproc = dbopen(login, server);
    if (dbproc == NULL) {
        printf("Unable to connect to server.\n");
        return 1;
    }

    // 执行查询
    dbcmd(dbproc, query);
    dbsqlexec(dbproc);

    // 获取查询结果
    result = dbresults(dbproc);
    if (result == NULL) {
        printf("No result.\n");
        return 1;
    }

    // 获取列数
    numcols = dbnumcols(dbproc);
    while (dbnextrow(dbproc) != NO_MORE_ROWS) {
        for (i = 1; i <= numcols; i++) {
            printf("%s\t", dbgetdata(dbproc, i, 0, NULL, 0));
        }
        printf("\n");
    }

    // 关闭连接
    dbclose(dbproc);
    return 0;
}

2. 代码解析

1. 初始化 FreeTDS 库：dbinit() 用于初始化数据库库。
2. 登录信息配置：通过 dblogin() 函数配置连接的用户名和密码。
3. 连接数据库：使用 dbopen() 函数连接到指定的 SQL Server。
4. 执行查询：dbcmd() 设置 SQL 查询，dbsqlexec() 执行查询。
5. 处理查询结果：通过 dbresults() 获取查询结果集，使用 dbnextrow() 遍历每一行数据，dbgetdata() 获取每列数据。

3. 编译与执行

编译此 C 程序时需要链接 FreeTDS 库：

gcc -o dbtest dbtest.c -ldblib

执行程序：

./dbtest

程序会连接到 SQL Server，执行查询，并打印查询结果。

三、常见操作与技巧

1. 错误处理

在实际使用中，处理数据库连接错误、查询错误和数据获取错误非常重要。FreeTDS 提供了丰富的错误处理函数，如 dbperror()、dbgetmessage() 等，用于捕获和打印错误信息。

if (dbproc == NULL) {
    dbperror(dbproc, "Database connection failed");
    return 1;
}

2. 事务控制

FreeTDS 支持事务控制，通过 dbcmd() 和 dbsqlexec() 可以执行 SQL 语句控制事务。例如，开始事务、提交事务和回滚事务：

dbcmd(dbproc, "BEGIN TRANSACTION");
dbsqlexec(dbproc);

// 提交事务
dbcmd(dbproc, "COMMIT");
dbsqlexec(dbproc);

3. 使用参数化查询

使用参数化查询可以防止 SQL 注入攻击。通过 dbbind() 函数可以为查询绑定参数。

char *query = "SELECT name FROM users WHERE age = ?";
DBCHAR age = 30;
dbcmd(dbproc, query);
dbbind(dbproc, 1, INTBIND, sizeof(age), (BYTE *) &age);
dbsqlexec(dbproc);

4. 多行处理与批量查询

FreeTDS 支持处理多行结果。在执行批量查询时，可以使用 dbnextrow() 获取所有返回的行数据。

while (dbnextrow(dbproc) != NO_MORE_ROWS) {
    // 处理每一行数据
}

四、总结

通过 FreeTDS，开发者可以在 Linux 或其他类 Unix 系统中使用 C 接口方便地访问 SQL Server 数据库。本文详细介绍了如何安装和配置 FreeTDS，如何编写 C 程序与 SQL Server 交互，以及如何进行错误处理、事务控制和参数化查询等常见操作。

通过 FreeTDS 的 C 接口，开发者可以将 SQL Server 数据库的操作集成到自己的应用程序中，满足复杂的数据库访问需求。在实际应用中，根据需求，可以进行适当的优化和错误处理，确保程序的稳定性和安全性。