Linux/Unix下ODBC的安裝、配置與編程

←手機掃碼閱讀     火星人 @ 2014-03-09 , reply:0

齊亮 (cavendish@eyou.com)

本文主要內容是介紹ODBC的簡單原理,以及如何在Linux/Unix下進行ODBC的安裝、配置與編程.

一、 ODBC原理

ODBC 是Open Database Connect 即開放資料庫互連的簡稱,它是由Microsoft 公司於1991 年提出的一個用於訪問資料庫的統一界面標準,是應用程序和資料庫系統之間的中間件.它通過使用相應應用平台上和所需資料庫對應的驅動程序與應用程序的交互來實現對資料庫的操作,避免了在應用程序中直接調用與資料庫相關的操作,從而提供了資料庫的獨立性.

ODBC 主要由驅動程序和驅動程序管理器組成.驅動程序是一個用以支持ODBC 函數調用的模塊,每個驅動程序對應於相應的資料庫,當應用程序從基於一個資料庫系統移植到另一個時,只需更改應用程序中由ODBC 管理程序設定的與相應資料庫系統對應的別名即可.驅動程序管理器可鏈接到所有ODBC 應用程序中,它負責管理應用程序中ODBC 函數與DLL 中函數的綁定.

ODBC 使用層次的方法來管理資料庫,在資料庫通信結構的每一層,對可能出現依賴資料庫產品自身特性的地方,ODBC 都引入一個公共介面以解決潛在的不一致性,從而很好地解決了基於資料庫系統應用程序的相對獨立性,這也是ODBC 一經推出就獲得巨大成功的重要原因之一.

從結構上分,ODBC 分為單束式和多束式兩類.

1. 單束式驅動程序
單束式驅動程序介於應用程序和資料庫之間,像中介驅動程序一樣數據提供一個統一的數據訪問方式.
當用戶進行資料庫操作時,應用程序傳遞一個ODBC 函數調用給ODBC 驅動程序管理器,由ODBC API 判斷該調用是由它直接處理並將結果返回還是送交驅動程序執行並將結果返回.
由上可見,單束式驅動程序本身是一個資料庫引擎,由它直接可完成對資料庫的操作,儘管該資料庫可能位於網路的任何地方.
2. 多束式驅動程序
多束式驅動程序負責在資料庫引擎和客戶應用程序之間傳送命令和數據,它本身並不執行數據處理操作而用於遠程操作的網路通信協議的一個界面.
前端應用程序提出對資料庫處理的請求,該請求轉給ODBC 驅動程序管理器,驅動程序管理器依據請求的情況,就地完成或傳給多束驅動程序,多束式驅動程序將請求翻譯為特定廠家的資料庫通信介面(如Oracle 的SQLNet)所能理解的形式並交於介面去處理,介面把請求經網路傳送給伺服器上的數據引擎,伺服器處理完后把結果發回給資料庫通信介面,資料庫介面將結果傳給多束式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下),

和Windows下的ODBC設置窗口是不是很像?我想大家都能看懂吧.

第一步:安裝資料庫的ODBC驅動程序
Drivers這一欄中用來設置資料庫的驅動程序,點擊Add按鈕,

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…

列表中會列出你已經安裝好的資料庫驅動程序,我這裡只裝了MySQL和PostgreSQL,然後選擇你所要使用的驅動程序,然後點擊OK

我這裡使用的是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一欄中顯示出來,

第四步:使用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)
",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
");
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
");
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
",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
",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)
",V_OD_msg,V_OD_err);
SQLFreeHandle(SQL_HANDLE_ENV, V_OD_Env);
exit(0);
}
printf("Connected !
");
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
",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)
",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
",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)
",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
",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
",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
",V_OD_rowanz);
V_OD_erg=SQLFetch(V_OD_hstmt);
while(V_OD_erg != SQL_NO_DATA)
{
printf("Result: %d %s
",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中相應文檔,也很好使用的.

參考資料:

1. 微軟的ODBC主頁:http://www.microsoft.com/data/odbc/;
2. UnixODBC的主頁:http://www.unixodbc.org;
3. FreeODBC的主頁:http://www.jepstone.net/FreeODBC/;
4. EasySoft的主頁:http://www.easysoft.com;
5. TrollTech的QT 3.0文檔主頁:http://doc.trolltech.com/3.0/.

個人簡介:

齊亮,有幸於2001年參與Happy Linux 3.0的研發工作,對Linux情有獨鍾,現在從事Linux/Windows跨平台應用的開發,歡迎您通過電子郵件 cavendish@eyou.com跟他聯繫,希望能與更多的朋友交流關於Linux方面的知識.





[火星人 ] Linux/Unix下ODBC的安裝、配置與編程已經有825次圍觀

http://coctec.com/docs/linux/show-post-56468.html