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. 代码解析

初始化 FreeTDS 库：dbinit() 用于初始化数据库库。
登录信息配置：通过 dblogin() 函数配置连接的用户名和密码。
连接数据库：使用 dbopen() 函数连接到指定的 SQL Server。
执行查询：dbcmd() 设置 SQL 查询，dbsqlexec() 执行查询。
处理查询结果：通过 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 数据库的操作集成到自己的应用程序中，满足复杂的数据库访问需求。在实际应用中，根据需求，可以进行适当的优化和错误处理，确保程序的稳定性和安全性。