Linux/Unix下ODBC的安装

很多程序员已经体会到了在Windows平台下的ODBC的益处，而在Linux/Unix下进行数据库编程的时候却不得不根据不同的数据库来选择特有的API进行编程，一旦数据库发生了改变，所有与这些API相关的程序都必须进行修改。其实在Linux/Unix下现在也有了自己的ODBC，可以使我们的数据库编程就像在Windows平台下一样简单。

下面我们开始介绍Linux/Unix下的ODBC：

回页首

Linux/Unix下ODBC的安装

方法一：
先下载最新的unixODBC源码包（ http://www.unixodbc.org/unixODBC-2.2.1.tar.gz）放到/usr/local下，然后运行下述命令：

tar zxvf unixODBC-2.2.1.tar.gz
cd unixODBC-2.2.1 
./configure --prefix=/usr/local/unixODBC-2.2.1 --includedir=/usr/include 
--libdir=/usr/lib -bindir=/usr/bin --sysconfdir=/etc
make
make install

安装成功后，unixODBC所需的头文件都被安装到了/usr/inlucde下，编译好的库文件安装到了/usr/lib下，与unixODBC相关的可执行文件安装到了/usr/bin下，配置文件放到了/etc下。

方法二：
下载rpm包进行安装，我们这里以Red Hat 7.3为例：
unixODBC-2.2.0-5 RPM for i386（安装包及源码包）
（ ftp://speakeasy.rpmfind.net/linux/redhat/7.3/en/os/i386/RedHat/RPMS/unixODBC-2.2.0-5.i386.rpm、ftp://ftp.rpmfind.net/linux/redhat/7.3/en/os/i386/SRPMS/unixODBC-2.2.0-5.src.rpm）
unixODBC-devel-2.2.0-5 RPM for i386
（ ftp://speakeasy.rpmfind.net/linux/redhat/7.3/en/os/i386/RedHat/RPMS/unixODBC-devel-2.2.0-5.i386.rpm）
直接将unixODBC-2.2.0-5.i386.rpm和unixODBC-devel-2.2.0-5.i386.rpm装入系统就可以了，命令如下：

rpm -ivh unixODBC-2.2.0-5.i386.rpm
rpm -ivh unixODBC-devel-2.2.0-5.i386.rpm

安装好以后，所需的各个部分与上面所列的位置相同。

回页首

Linux/Unix下ODBC的配置

运行ODBCConfig程序（在/usr/bin下），如下图：

图一：ODBCConfig主窗口

和Windows下的ODBC设置窗口是不是很像？我想大家都能看懂吧。

第一步：安装数据库的ODBC驱动程序
Drivers这一栏中用来设置数据库的驱动程序，点击Add按钮，会出现下图：

图二：ODBCConfig Driver Properties窗口

Name一栏填入数据库驱动的名称，Description是数据库驱动的描述，Driver是用来选择数据库驱动程序的，Setup是用来选择数据库驱动安装程序的，如果你是按照上述安装方法安装的，这些程序都放在/usr/lib下，下面是数据库驱动程序的列表：

数据库	数据库驱动程序	数据库驱动安装程序
TXT	libodbctxt.so	libodbctxtS.so
NNTP	libnn.so	libodbcnnS.so
MiniSQL	libodbcmini.so	libodbcminiS.so
PostgreSQL	libodbcpsql.so	libodbcpsqlS.so
MySQL	（注释）	libodbcmyS.so
Sybase/MS SQL	（注释）	libtdsS.so
Oracle	（注释）	liboraodbcS.so

注释：
MySQL、Sybase/MS SQL和Oracle的数据库驱动可以在下列网址找到：
MySQL　　　　　　　　　　 http://www.unixodbc.org/myodbc.html
Sybase/MS SQL　　　　　　 http://www.freetds.org
Oracle　　　　　　　　　　 http://www.easysoft.org

MySQL的驱动程序MyODBC-2.50.39-4 RPM for i386以及源码包：
ftp://speakeasy.rpmfind.net/linux/redhat/7.3/en/os/i386/RedHat/RPMS/MyODBC-2.50.39-4.i386.rpm
ftp://ftp.redhat.com/pub/redhat/linux/7.3/en/os/i386/SRPMS/MyODBC-2.50.39-4.src.rpm

选择好驱动程序之后，点击"√"保存退出。

第二步：设置DSN
DSN分为User DSN、System DSN和File DSN三种，我们以System DSN为例。选中System DSN一栏以后，点击Add…按钮就会见到下图：

图三：创建DSN选择数据库驱动

列表中会列出你已经安装好的数据库驱动程序，我这里只装了MySQL和PostgreSQL，然后选择你所要使用的驱动程序，然后点击OK就会出现下图：

图四：DSN的设置

我这里使用的是MySQL的数据库驱动，不同的数据库，这个窗口的内容会有所不同。Name是数据源的名称，Description是描述，Server可以选择服务器，如果本机启动了MySQL就可以选择localhost，如果Port和Socket有特殊要求，再根据实际情况进行修改，Database是用来选择数据库的，下拉菜单不一定包含所有的数据库，你可以把自己已经创建好的数据库名称填写在这里。都配置好之后，点击"√"保存退出。

这样Linux/Unix下的ODBC数据源就已经设置好了，大家还可以在ODBCConfig程序的Status栏中查看ODBC的使用情况，在Advanced栏中设置是否做日志或者启动连接池，在About栏中，有一个Linux/Unix ODBC的示意图，在Credits按钮中可以看到所有开发者的名字的列表。 ODBCConfig程序中所有有关数据库驱动程序的信息被放在odbcinst.ini（在/etc下）文件中，有关DSN的信息被放在odbc.ini（在/etc下）文件中，大家有兴趣的话，可以自己去观察一下。

第三步：使用DataManager程序浏览数据库
运行DataManager程序之后就可以查看Drivers、System DSN和User DSN这几项内容，，在浏览数据库的时候，可以在右面的SQL栏中输入SQL语句，然后点击人形按钮就可以运行SQL语句，运行结果会在Results一栏中显示出来，具体情况可以见下图：

图五：使用DataManager浏览数据库

第四步：使用isql程序查看数据库
unixODBC还提供了命令台下查看数据库的程序，这就是isql，用法如下：

isql DSN [UID [PWD]] [options]
DSN		数据源名称
UID		用户ID
PWD		用户密码
Options：
-b		批处理，没有提示符的模式
-dx		设置列之间的分隔符为x
-w		将查询结果输出为HTML格式
-c		第一行输出列名
--version	           输出isql的版本号

回页首

Linux/Unix下ODBC的编程

1、使用unixODBC提供的ODBC API进行编程：
在进行编程之前，我们来看一下ODBC API中的常用数据类型与我们在C语言中使用的数据类型的对应关系：

类型标识符	ODBC数据类型	C数据类型
SQL_C_CHAR	SQLCHAR *	unsigned char *
SQL_C_SSHORT	SQLSMALLINT	short int
SQL_C_USHORT	SQLUSMALLINT	unsigned short int
SQL_C_SLONG	SQLINTEGER	long int
SQL_C_FLOAT	SQLREAL	float
SQL_C_DOUBLE	SQLDOUBLE, SQLFLOAT	double
SQL_C_BINARY	SQLCHAR *	unsigned char *
SQL_C_TYPE_DATE	SQL_DATE_STRUCT	struct tagDATE_STRUCT {SQLSMALLINT year; SQLUSMALLINT month; SQLUSMALLINT day; } DATE_STRUCT;
SQL_C_TYPE_TIME	SQL_TIME_STRUCT	struct tagTIME_STRUCT {SQLUSMALLINT hour; SQLUSMALLINT minute; SQLUSMALLINT second; } TIME_STRUCT;

我们这里使用的数据库名称为test（DSN），这个DSN使用的用户名是root，密码为空，表的名称是web，字段情况如下：

字段名	数据类型
id	integer
name	char(40)
size	integer

第一：设定ODBC环境句柄并设置参数
首先我们需要声明一个ODBC环境句柄（SQLHENV），它可以用来获得有关的ODBC环境信息，我们需要调用SQLAllocHandle ( SQL_HANDLE_ENV, SQL_NULL_HANDLE, &V_OD_Env )来获得这个句柄，V_OD_Env就是要分配的SQLHENV类型的环境句柄。分配好句柄之后，你给它需要设定所使用的ODBC版本，你可以调用SQLSetEnvAttr ( V_OD_Env, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0 )，SQL_ATTR_ODBC_VERSION是存放你定义的ODBC版本号的变量，SQL_OV_ODBC3则说明你的程序使用的是ODBC 3.0。

第二：设定连接句柄并设置超时参数
我们需要声明一个连接句柄（SQLHDBC），用来存放数据库连接信息的，调用SQLAllocHandle ( SQL_HANDLE_DBC, V_OD_Env, &V_OD_hdbc )获得连接句柄，V_OD_hdbc就是要分配的SQLHDBC类型的连接句柄。分配好之后，我们可以调用SQLSetConnectAttr ( V_OD_hdbc, SQL_LOGIN_TIMEOUT, (SQLPOINTER *)5, 0 )来设定连接超时参数。

第三：连接数据库
调用SQLConnect ( V_OD_hdbc, (SQLCHAR*) "Test", SQL_NTS, (SQLCHAR*) "root", SQL_NTS, (SQLCHAR*) "", SQL_NTS )连接我前面提到的数据库，需要设定三个参数，就是数据库名称、用户名和密码（因为我的数据库密码为空，所以这里的密码也为空），后面的SQL_NTS的位置应该写入这些参数的长度，如果写的是SQL_NTS就是让SQLConnect来决定参数的长度。

第四：分配SQL语句的句柄并进行查询：
需要声明一个SQL语句的句柄（SQLHSTMT），用来存放SQL语句信息的，调用SQLAllocHandle ( SQL_HANDLE_STMT, V_OD_hdbc, &V_OD_hstmt )来获得这个句柄，V_OD_hstmt就是我们要分配的SQLHSTMT类型的SQL语句句柄。

我们的查询语句是：

SELECT name, id FROM web ORDER BY id

执行这条查询语句之后，查询结果可能有很多行，但每行只有两列，分别对应name和id，它们的数据类型为integer和char*，在ODBC中的数据类型标识符为SQL_C_ULONG和SQL_C_CHAR。我们需要先声明这样的两个变量来存贮查询结果：

SQLINTEGER		V_OD_id;
char		V_OD_buffer[200];

然后我们需要使用SQLBindCol函数把查询结果和我们定义的变量进行绑定：

SQLBindCol(V_OD_hstmt,1,SQL_C_CHAR, &V_OD_buffer,150,&V_OD_err);
SQLBindCol(V_OD_hstmt,2,SQL_C_ULONG,&V_OD_id,150,&V_OD_err);

这里的V_OD_err是用来存放错误信息编号的变量，类型也是SQLINTEGER。
接下来，我们调用SQLExecDirect来进行查询：

SQLExecDirect ( V_OD_hstmt, "SELECT dtname,iduser FROM web order by iduser", SQL_NTS );

我们可以用SQLNumResultCols ( V_OD_hstmt, &V_OD_colanz )来获得结果的列数，也可以用SQLRowCount( V_OD_hstmt, &V_OD_rowanz )来获得结果的条数，V_OD_colanz和V_OD_rowanz分别存储相应的结果，类型分别为SQLSMALLINT和SQLINTEGER。
在读取结果之前，我们需要调用SQLFetch ( V_OD_hstmt )语句，这个语句可以用来获得第一条结果也可以用来都下一条，有点像next的感觉。然后我们就可以在V_OD_id和V_OD_buffer里面获得每条记录的结果了。

第五：关于关闭连接和释放句柄
关闭数据库的连接，调用SQLDisconnect ( V_OD_hdbc )就可以了，但在关闭数据库之前需要先释放SQL语句的句柄，而且在关闭数据库之后应该释放连接句柄和ODBC环境句柄，语句如下（按正常的顺序）：

SQLFreeHandle(SQL_HANDLE_STMT,V_OD_hstmt);
SQLDisconnect(V_OD_hdbc);
SQLFreeHandle(SQL_HANDLE_DBC,V_OD_hdbc);
SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);

第六：关于上述情况中的错误信息处理
我们需要定义两个变量：

long	V_OD_erg;
SQLINTEGER	V_OD_err;

SQLAllocHandle、SQLSetEnvAttr、SQLSetConnectAttr、SQLConnect、SQLExecDirect、SQLNumResultCols和SQLRowCount的调用结果都可以用V_OD_erg来存储，V_OD_err可以获得SQLBindCol中的错误信息。

第七：获得本机的DSN信息
我们可以在声明SQLHENV句柄之后，使用SQLDataSources函数来获得本机的DSN信息。程序如下：

void OD_ListDSN(void)
{
char       l_dsn[100],l_desc[100];
short int  l_len1,l_len2,l_next;
l_next=SQL_FETCH_FIRST;
while( SQLDataSources(V_OD_Env,l_next,l_dsn, sizeof(l_dsn),
&l_len1, l_desc, sizeof(l_desc), &l_len2) == SQL_SUCCESS)
{
printf("Server=(%s) Beschreibung=(%s)\n",l_dsn,l_desc);
l_next=SQL_FETCH_NEXT;
}
}

l_next变量是用来指定我们所要获得的DSN的类别：

SQL_FETCH_FIRST	设定SQLDataSources()函数找到第一个可用的数据源（可以是User DSN，也可以是Systerm DSN）
SQL_FETCH_FIRST_USER	设定SQLDataSources()函数找到第一个User DSN
SQL_FETCH_FIRST_SYSTEM	设定SQLDataSources()函数找到第一个System DSN
SQL_FETCH_NEXT	找到下一个数据源，至于数据源类型则要根据前面的定义

到这里，我们在Unix的C语言下面进行ODBC编程已经讲完，上述ODBC API需要引用以下几个头文件（这些文件已经安装到/usr/include下了）：

#include <sql.h>
#include <sqlext.h>
#include <sqltypes.h>

另外如果大家使用GTK进行编程，由于到目前为止GTK还没有加入专门处理数据库的部件，所以大家可以在GTK中调用上述的ODBC API即可。

这里附上例程供大家参考学习：

/* odbc.c
    testing unixODBC
*/
#include <stdlib.h>
#include <stdio.h>
#include <odbc/sql.h>
#include <odbc/sqlext.h>
#include <odbc/sqltypes.h>
SQLHENV       V_OD_Env;    // Handle ODBC environment
long       V_OD_erg;    // result of functions
SQLHDBC       V_OD_hdbc;                      // Handle connection
char       V_OD_stat[10];    // Status SQL
SQLINTEGER     V_OD_err,V_OD_rowanz,V_OD_id;
SQLSMALLINT     V_OD_mlen,V_OD_colanz;
char             V_OD_msg[200],V_OD_buffer[200];
int main(int argc,char *argv[])
{
  // 1. allocate Environment handle and register version 
  V_OD_erg=SQLAllocHandle(SQL_HANDLE_ENV,SQL_NULL_HANDLE,&V_OD_Env);
  if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
  {
    printf("Error AllocHandle\n");
    exit(0);
  }
  V_OD_erg=SQLSetEnvAttr(V_OD_Env, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0); 
  if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
  {
    printf("Error SetEnv\n");
    SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
    exit(0);
  }
  // 2. allocate connection handle, set timeout
  V_OD_erg = SQLAllocHandle(SQL_HANDLE_DBC, V_OD_Env, &V_OD_hdbc); 
  if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
  {
    printf("Error AllocHDB %d\n",V_OD_erg);
    SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
    exit(0);
  }
  SQLSetConnectAttr(V_OD_hdbc, SQL_LOGIN_TIMEOUT, (SQLPOINTER *)5, 0);
  // 3. Connect to the datasource "web" 
  V_OD_erg = SQLConnect(V_OD_hdbc, (SQLCHAR*) "Test", SQL_NTS,
                                     (SQLCHAR*) "root", SQL_NTS,
                                     (SQLCHAR*) "", SQL_NTS);
  if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
  {
    printf("Error SQLConnect %d\n",V_OD_erg);
    SQLGetDiagRec(SQL_HANDLE_DBC, V_OD_hdbc,1, 
                  V_OD_stat, &V_OD_err,V_OD_msg,100,&V_OD_mlen);
    printf("%s (%d)\n",V_OD_msg,V_OD_err);
    SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
    exit(0);
  }
  printf("Connected !\n");
  V_OD_erg=SQLAllocHandle(SQL_HANDLE_STMT, V_OD_hdbc, &V_OD_hstmt);
  if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
  {
    printf("Fehler im AllocStatement %d\n",V_OD_erg);
    SQLGetDiagRec(SQL_HANDLE_DBC, V_OD_hdbc,1, V_OD_stat,&V_OD_err,V_OD_msg,100,&V_OD_mlen);
    printf("%s (%d)\n",V_OD_msg,V_OD_err);
    SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
    exit(0);
  }
    SQLBindCol(V_OD_hstmt,1,SQL_C_CHAR, &V_OD_buffer,150,&V_OD_err);
    SQLBindCol(V_OD_hstmt,2,SQL_C_ULONG,&V_OD_id,150,&V_OD_err);

    V_OD_erg=SQLExecDirect(V_OD_hstmt,"SELECT dtname,iduser FROM web order by iduser",SQL_NTS);   
    if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
    {
       printf("Error in Select %d\n",V_OD_erg);
       SQLGetDiagRec(SQL_HANDLE_DBC, V_OD_hdbc,1, V_OD_stat,&V_OD_err,V_OD_msg,100,&V_OD_mlen);
       printf("%s (%d)\n",V_OD_msg,V_OD_err);
       SQLFreeHandle(SQL_HANDLE_STMT,V_OD_hstmt);
       SQLFreeHandle(SQL_HANDLE_DBC,V_OD_hdbc);
       SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
       exit(0);
    }
    V_OD_erg=SQLNumResultCols(V_OD_hstmt,&V_OD_colanz);
    if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
    {
        SQLFreeHandle(SQL_HANDLE_STMT,V_OD_hstmt);
        SQLDisconnect(V_OD_hdbc);
        SQLFreeHandle(SQL_HANDLE_DBC,V_OD_hdbc);
        SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
        exit(0);
    }
    printf("Number of Columns %d\n",V_OD_colanz);
    V_OD_erg=SQLRowCount(V_OD_hstmt,&V_OD_rowanz);
    if ((V_OD_erg != SQL_SUCCESS) && (V_OD_erg != SQL_SUCCESS_WITH_INFO))
    {
      printf("Number of RowCount %d\n",V_OD_erg);
      SQLFreeHandle(SQL_HANDLE_STMT,V_OD_hstmt);
      SQLDisconnect(V_OD_hdbc);
      SQLFreeHandle(SQL_HANDLE_DBC,V_OD_hdbc);
      SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
      exit(0);
    }
    printf("Number of Rows %d\n",V_OD_rowanz);
    V_OD_erg=SQLFetch(V_OD_hstmt);  
    while(V_OD_erg != SQL_NO_DATA)
    {
     printf("Result: %d %s\n",V_OD_id,V_OD_buffer);
     V_OD_erg=SQLFetch(V_OD_hstmt);  
    }  ;
    SQLFreeHandle(SQL_HANDLE_STMT,V_OD_hstmt);
    SQLDisconnect(V_OD_hdbc);
    SQLFreeHandle(SQL_HANDLE_DBC,V_OD_hdbc);
    SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
    return(0);
}

2．QT下进行ODBC编程
QT 3.0提供了Data Table、Data Browser和Data View三个与数据库相关的控件。你可以在QT的Project设置你要连接的数据库，Driver一栏中选择QODBC3即可，其它选项你一看就明白了。上述的三个数据库控件的使用方法可以参见QT中相应文档，也很好使用的。

秒客网

Linux/Unix下ODBC的安装

Linux/Unix下ODBC的安装

Linux/Unix下ODBC的配置

图一：ODBCConfig主窗口

图二：ODBCConfig Driver Properties窗口

图三：创建DSN选择数据库驱动

图四：DSN的设置

图五：使用DataManager浏览数据库

Linux/Unix下ODBC的编程

相关文章