freetds使用（二）---- 相关的API

参考网址：http://www.jb51.net/article/53450.htm
  http://infocenter.sybase.com/help/index.jsptopic=/com.sybase.help.ocs_12.5.1.dblib/html/dblib/X35104.htm
 
一、freetds API
1． Dbcmd和dbfcmd

      函数原形： Dbcmd(DBPROCESS *proc,char * sql);
Dbcmd(DBPROCESS *proc, char * format,char *args);
功      能：该函数主要是构造sql语句，一个是带参数的，一个不带参数。

2． Dbsqlexec
函数原形：Dbsqlexec（DBPROCESS *proc）；
功      能：该函数负责执行你所构造的sql语句。

3． Dbresults
函数原形：Dbrerults（DBPROCESS *proc）；
功      能：得到sql语句的执行结果。返回值如果为NO_MORE_RESULTS=0，表明sql查询为空值（就是没有一条满足条件的结果），如果为（FAIL）=-1，表明查询出错，如果为（SUCCESS）=1，表明有结果且不为空。

4． DBROWS（全大写）
函数原形：DBROWS（DBPROCESS *proc）；
功      能：取出一行记录的信息。

5． Dbbind
函数原形：Dbbind（DBPROCESS *proc，int colmn，
功      能：将sql查询出来的结果绑定到一个变量。第一个参数为从数据库那里拿的句柄，第二个参数是对应你的select语句中查询需要的字段

（注：必须是按照select顺序绑定的，例如select user，password from hist1 ，如果值为1，就是绑定的user），第三个参数是绑定字段的类型，最后一个参数是绑定的变量。

6．    Dbnextrow
函数原形：Dbnextrow（DBPROCESS *proc）；
功      能：该函数将取出满足sql语句的每一行，返回值为0，代表处理结束，返回值为-1出错。

7．  Dbcancel
函数原形：Dbcancel（DBPROCESS *proc）；
功      能：清空上次查询得到的数据集，如果是一个句柄的话，每次重新执行select语句之前都要调用它清空结果，不然数据库会报错的。

8． Dbclose
函数原形：Dbclose（DBPROCESS *proc）；

功      能：关闭句柄。当不再使用时必须关闭句柄。

9．  Dbinit

函数原形：Dbinit（）
功      能：初识化数据库连接。返回值为-1出错。

10． Dblogin
函数原形：LOGINREC       *Dblogin（）
DBSETLUSER(login,SOFT);  //set the database user 
DBSETLPWD(login,SOFTPASS);//set password
功     能：根据用户名和密码连接数据库。

11．Dbcount
函数原形：Dbcount（DBPROCESS *proc）；
功      能：该函数将得到sql结果集被处理的行数，可以用它来判断你的select语句是否得到正确的处理。

12．Dbopen
函数原形：DBPROCESS * Dbopen（LOGINREC     *login，NULL）；
功      能：返回一个操作数据库的句柄
另外再介绍两个关于数据库的出错信息的函数：
dberrhandle(int *err);
dbmsghandle(int* err);


二、freetds 查询操作

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sqlfront.h> /* sqlfront.h always comes first */
#include <sybdb.h> /* sybdb.h is the only other file you need */
#define SQLDBIP " " //SQL数据库服务器IP
#define SQLDBPORT " " //SQL数据库服务器端口
#define SQLDBNAME " " //SQL数据库服务器数据库名
#define SQLDBUSER " " //SQL数据库服务器数据库用户名
#define SQLDBPASSWD " " //SQL数据库服务器用户密码
#define SQLDBSERVER SQLDBIP":"SQLDBPORT
#define DBSQLCMD "select * from yancao"
int main(int argc, char *argv[])
{
int i, ch;
LOGINREC *login; //描述客户端的结构体，在连接时被传递到服务器.
DBPROCESS *dbproc; //描述连接的结构体，被dbopen()函数返回
RETCODE erc; //库函数中最普遍的返回类型.

/*************************************************************/
//在开始调用本库函数前常常要先调用dbinit()函数
if (dbinit() == FAIL) {
fprintf(stderr, "%s:%d: dbinit() failed\n",argv[0], __LINE__);
exit(1);
}
//dblogin()函数申请 LOGINREC 结构体，此结构体被传递给dbopen()函数，用来创建一个连接。
//虽然基本上不会调用失败，但是检查它！.
if ((login = dblogin()) == NULL) {
fprintf(stderr, "%s:%d: unable to allocate login structure\n",argv[0],__LINE__);
exit(1);
}
//LOGINREC结构体不能被直接访问，要通过以下宏设置，下面设置两个必不可少的域
DBSETLUSER(login, SQLDBUSER);
DBSETLPWD(login, SQLDBPASSWD); 
/*************************************************************/

//dbopen()与服务器建立一个连接. 传递 LOGINREC 指针和服务器名字
if ((dbproc = dbopen(login, SQLDBSERVER)) == NULL) {
fprintf(stderr, "%s:%d: unable to connect to %s as %s\n",
argv[0], __LINE__,
SQLDBSERVER, SQLDBUSER);
exit(1);
}
// 可以调用dbuser()函数选择我们使用的数据库名，可以省略，省略后使用用户默认数据库.
if (SQLDBNAME && (erc = dbuse(dbproc, SQLDBNAME)) == FAIL) {
fprintf(stderr, "%s:%d: unable to use to database %s\n",
argv[0], __LINE__, SQLDBNAME);
exit(1);
}
 
/*************************************************************/
dbcmd(dbproc, DBSQLCMD);//将SQL语句填充到命令缓冲区
printf("\n");
if ((erc = dbsqlexec(dbproc)) == FAIL) {
fprintf(stderr, "%s:%d: dbsqlexec() failed\n", argv[0], __LINE__);
exit(1); //等待服务器执行SQL语句，等待时间取决于查询的复杂度。
}
/*************************************************************/

//在调用dbsqlexec()、dbsqlok()、dbrpcsend()返回成功之后调用dbresults()函数
printf("then fetch results:\n");
int count = 0;
while ((erc = dbresults(dbproc)) != NO_MORE_RESULTS) {
struct col { //保存列的所有信息
char *name; //列名字
char *buffer; //存放列数据指针
int type, size, status;
} *columns, *pcol;

int ncols;
int row_code; 
if (erc == FAIL) {
fprintf(stderr, "%s:%d: dbresults failed\n",
argv[0], __LINE__);
exit(1);
} 
ncols = dbnumcols(dbproc);//返回执行结果的列数目 
if ((columns = calloc(ncols, sizeof(struct col))) == NULL) {
perror(NULL);
exit(1);
}
 
/* read metadata and bind. */
for (pcol = columns; pcol - columns < ncols; pcol++) {
int c = pcol - columns + 1;
pcol->name = dbcolname(dbproc, c); //返回指定列的列名
pcol->type = dbcoltype(dbproc, c);
pcol->size = dbcollen(dbproc, c); 
printf("%*s(%d)", 20, pcol->name, pcol->size);
if ((pcol->buffer = calloc(1, 20)) == NULL) {
perror(NULL);
exit(1);
}
erc = dbbind(dbproc, c, NTBSTRINGBIND, 20, (BYTE*)pcol->buffer);
if (erc == FAIL) {
fprintf(stderr, "%s:%d: dbbind(%d) failed\n",
argv[0], __LINE__, c);
exit(1);
}
erc = dbnullbind(dbproc, c, &pcol->status); //(5)
if (erc == FAIL) {
fprintf(stderr, "%s:%d: dbnullbind(%d) failed\n",
argv[0], __LINE__, c);
exit(1);
}
}
printf("\n");

/* 打印数据 */
while ((row_code = dbnextrow(dbproc)) != NO_MORE_ROWS) {//读取行数据
switch (row_code) {
case REG_ROW:
for (pcol=columns; pcol - columns < ncols; pcol++) {
char *buffer = pcol->status == -1?
"null" : pcol->buffer;
printf("%*s ", 20, buffer);
}
printf("\n"); break;
case BUF_FULL: break;
case FAIL:
fprintf(stderr, "%s:%d: dbresults failed\n",
argv[0], __LINE__);
exit(1); break;
default: // (7)
printf("data for computeid %d ignored\n", row_code);
}
}
 
/* free metadata and data buffers */
for (pcol=columns; pcol - columns < ncols; pcol++) {
free(pcol->buffer);
}
free(columns);

if (DBCOUNT(dbproc) > -1) /* 得到SQL语句影响的行数 */
fprintf(stderr, "%d rows affected\n", DBCOUNT(dbproc))
}

dbclose(dbproc);
dbexit();
}


三、freetds 插入操作

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sqlfront.h> /* sqlfront.h always comes first */
#include <sybdb.h> /* sybdb.h is the only other file you need */
#define SQLDBIP "192.168.9.72" //SQL数据库服务器IP
#define SQLDBPORT "1433" //SQL数据库服务器端口
#define SQLDBNAME "phonecast_userstat" //SQL数据库服务器数据库名
#define SQLDBUSER "developer" //SQL数据库服务器数据库用户名
#define SQLDBPASSWD "developer" //SQL数据库服务器用户密码
#define SQLDBSERVER SQLDBIP":"SQLDBPORT
#define DBSQLCMD "insert into tmp_crs_base(likenum, pnum, state ,ts ,uid ) values(0,1,2,3,0002)"
int main(int argc, char *argv[])
{
int i, ch;
LOGINREC *login; //描述客户端的结构体，在连接时被传递到服务器.
DBPROCESS *dbproc; //描述连接的结构体，被dbopen()函数返回
RETCODE erc; //库函数中最普遍的返回类型.

/*************************************************************/
//在开始调用本库函数前常常要先调用dbinit()函数
if (dbinit() == FAIL) {
fprintf(stderr, "%s:%d: dbinit() failed\n",argv[0], __LINE__);
exit(1);
}
//dblogin()函数申请 LOGINREC 结构体，此结构体被传递给dbopen()函数，用来创建一个连接。
//虽然基本上不会调用失败，但是检查它！.
if ((login = dblogin()) == NULL) {
fprintf(stderr, "%s:%d: unable to allocate login structure\n",argv[0],__LINE__);
exit(1);
}
//LOGINREC结构体不能被直接访问，要通过以下宏设置，下面设置两个必不可少的域
DBSETLUSER(login, SQLDBUSER);
DBSETLPWD(login, SQLDBPASSWD); 
/*************************************************************/

//dbopen()与服务器建立一个连接. 传递 LOGINREC 指针和服务器名字
if ((dbproc = dbopen(login, SQLDBSERVER)) == NULL) {
fprintf(stderr, "%s:%d: unable to connect to %s as %s\n",argv[0], __LINE__,SQLDBSERVER, SQLDBUSER);
exit(1);
}
// 可以调用dbuser()函数选择我们使用的数据库名，可以省略，省略后使用用户默认数据库.
if (SQLDBNAME && (erc = dbuse(dbproc, SQLDBNAME)) == FAIL) {
fprintf(stderr, "%s:%d: unable to use to database %s\n",argv[0], __LINE__, SQLDBNAME);
exit(1);
}
 
/*************************************************************/
dbcmd(dbproc, DBSQLCMD);//将SQL语句填充到命令缓冲区
printf("\n");
if ((erc = dbsqlexec(dbproc)) == FAIL) {
fprintf(stderr, "%s:%d: dbsqlexec() failed\n", argv[0], __LINE__);
exit(1); //等待服务器执行SQL语句，等待时间取决于查询的复杂度。
}


dbclose(dbproc);
dbexit();
}