sqlite入门.docx
《sqlite入门.docx》由会员分享,可在线阅读,更多相关《sqlite入门.docx(53页珍藏版)》请在冰豆网上搜索。
sqlite入门
C语言程序调用SQLite实例
现在我们来写个C/C++程序,调用sqlite 的API接口函数。
下面是一个C程序的例子,显示怎么使用sqlite的C/C++接口.数据库的名字由第一个参数取得且第二个参数或更多的参数是SQL执行语句.这个函数调用sqlite3_open()在22行打开数据库,sqlite3_exec()在27行执行SQL命令,并且sqlite3_close()在31行关闭数据库连接。
代码:
[cpp] viewplaincopy
1.// name:
opendbsqlite.c
2.// This file is used to test C/C++ API for sqlite
3.// Author :
zieckey
4.// 2006/04/11
5.#include
6.#include
7.
8.int main( void )
9.{
10. sqlite3 *db=NULL;
11. char *zErrMsg = 0;
12. int rc;
13. rc = sqlite3_open("zieckey.db", &db); //打开指定的数据库文件,如果不存在将创建一个同名的数据库文件
14. if( rc ){
15. fprintf(stderr, "Can't open database:
%s\n", sqlite3_errmsg(db));
16. sqlite3_close(db);
17. exit
(1);
18. }
19. else printf("open zieckey.db successfully!
\n");
20.
21. sqlite3_close(db); //关闭数据库
22. return 0;
23.}
编译:
#gccopendbsqlite.c-odb.out
也许会碰到类似这样的问题:
/tmp/ccTkItnN.o(.text+0x2b):
Infunction`main':
:
undefinedreferenceto`sqlite3_open'
/tmp/ccTkItnN.o(.text+0x45):
Infunction`main':
:
undefinedreferenceto`sqlite3_errmsg'
/tmp/ccTkItnN.o(.text+0x67):
Infunction`main':
:
undefinedreferenceto`sqlite3_close'
/tmp/ccTkItnN.o(.text+0x8f):
Infunction`main':
:
undefinedreferenceto`sqlite3_close'
collect2:
ldreturned1exitstatus
这是个没有找到库文件的问题。
由于用到了用户自己的库文件,所用应该指明所用到的库,我们可以这样编译:
#gccopendbsqlite.c-odb.out-lsqlite3
我用用-lsqlite3选项就可以了(前面我们生成的库文件是libsqlite3.so.0.8.6等,
去掉前面的lib和后面的版本标志,就剩下sqlite3了所以是-lsqlite3)。
如果我们在编译安装的时候,选择了安装路径,例如这样的话:
.......
#../sqlite/configure--prefix=/usr/local/arm-linux/sqlite-ix86-linux
.......
这样编译安装时,sqlite的库文件将会生成在/usr/local/arm-linux/sqlite-ix86-linux/lib目录下
这时编译还要指定库文件路径,因为系统默认的路径没有包含/usr/local/arm-linux/sqlite-ix86-linux/lib
#gccopendbsqlite.c-lsqlite3-L/usr/local/arm-linux/sqlite-ix86-linux/lib
如果还不行的话,可能还需要指定头文件sqlite3.h的路径,如下:
#gccopendbsqlite.c-lsqlite3-L/usr/local/arm-linux/sqlite-ix86-linux/lib-I/usr/local/arm-linux/sqlite-ix86-linux/include
这样编译应该就可以了,运行:
#./db.out
openming.dbsuccessfully!
在这个操作中我们执行了如下操作:
∙打开数据库
∙执行SQL语句
∙关闭数据库
当然这中间会有一些状态的判断以及内存指针的释放等。
打开数据库的API如下:
int sqlite3_open(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb /* OUT:
SQLite db handle */
);
这里会引入一个非常复杂的sqlite3的数据结构。
这个根据需要以后酌情了解些。
打开数据库除了这种形式意外,还有sqlite3_open、sqlite3_open16、sqlite3_open_v2几种形式,基本上类似。
大部分sql操作都可以通过sqlite3_exec来完成,它的API形式如下:
int sqlite3_exec(
sqlite3*, /* An open database */
const char *sql, /* SQL to be evaluated */
int (*callback)(void*,int,char**,char**), /* Callback function */
void *, /* 1st argument to callback */
char **errmsg /* Error msg written here */
);
各个参数的意义为:
∙sqlite3描述的是数据库句柄
∙sql要执行的SQL语句
∙callback回调函数
∙void*回调函数的第一个参数
∙errmsg错误信息,如果没有SQL问题则值为NULL
回调函数式一个比较复杂的函数。
它的原型是这样的:
int callback(void *params,int column_size,char **column_value,char **column_name){
每一个参数意义如下:
∙params是sqlite3_exec传入的第四个参数
∙column_size是结果字段的个数
∙column_value是返回记录的一位字符数组指针
∙column_name是结果字段的名称
通常情况下callback在select操作中会使用到,尤其是处理每一行记录数。
返回的结果每一行记录都会调用下“回调函数”。
如果回调函数返回了非0,那么sqlite3_exec将返回SQLITE_ABORT,并且之后的回调函数也不会执行,同时未执行的子查询也不会继续执行。
对于更新、删除、插入等不需要回调函数的操作,sqlite3_exec的第三、第四个参数可以传入0或者NULL。
通常情况下sqlite3_exec返回SQLITE_OK=0的结果,非0结果可以通过errmsg来获取对应的错误描述。
Windows下编译:
D:
\home\dev\c>cl/nologo/TCsqlite3-demo.csqlite3.c
GCC下编译:
$gcc-osqlite3-demo.binsqlite3-demo.csqlite3.c
删除表操作
为了防止垃圾数据,我们在加载数据库的时候删除表操作。
简单的删除操作可以直接使用sqlite3_exec即可。
这里不需要回调函数以及回调函数的参数。
当然需要可以关注sqlite3_exec返回的结果是否为SQLITE_OK的值。
const char *sql_drop_table="drop table if exists t";
const char *sql_create_table="create table t(id int primary key,msg varchar(128))";
sqlite3_exec(db,sql_drop_table,0,0,&errmsg);
sqlite3_exec(db,sql_create_table,0,0,&errmsg);
插入数据
插入第一条数据
ret = sqlite3_exec(db,"insert into t(id,msg) values(1,'Ady Liu')",NULL,NULL,&errmsg);
printf("Insert a record %s\n",ret == SQLITE_OK ?
"OK":
"FAIL");
返回值ret为SQLITE_OK即操作成功。
插入多条数据,并删除数据
ret = sqlite3_exec(db,"insert into t(id,msg) values(1,'Ady Liu')",NULL,NULL,&errmsg);
printf("Insert a record %s\n",ret == SQLITE_OK ?
"OK":
"FAIL");
ret = sqlite3_exec(db,"insert into t(id,msg) values(2,'IMXYLZ')",NULL,NULL,&errmsg);
printf("Insert a record %s\n",ret == SQLITE_OK ?
"OK":
"FAIL");
ret = sqlite3_exec(db,"delete from t where id < 3",NULL,NULL,&errmsg);
printf("Delete records:
%s\n",ret == SQLITE_OK ?
"OK":
"FAIL");
插入多条数据,简单的使用sqlite3_exec进行SQL执行即可。
当然这里是完整的SQL字符串。
预编译操作
int i = 0;
sqlite3_stmt *stmt;
char ca[255];
//prepare statement
sqlite3_prepare_v2(db,"insert into t(id,msg) values(?
?
)",-1,&stmt,0);
for(i=10;i<20;i++){
sprintf(ca,"HELLO#%i",i);
sqlite3_bind_int(stmt,1,i);
sqlite3_bind_text(stmt,2,ca,strlen(ca),NULL);
sqlite3_step(stmt);
sqlite3_reset(stmt);
}
sqlite3_finalize(stmt);
预编译操作比较麻烦的,完整的预编译操作的流程是:
1.通过sqlite3_prepare_v2()创建一个sqlite3_stmt对象
2.通过sqlite3_bind_*()绑定预编译字段的值
3.通过sqlite3_step()执行SQL语句
4.通过sqlite3_reset()重置预编译语句,重复操作2多次
5.通过sqlite3_finalize()销毁资源
sqlite3_prepare_v2()有个多种类似的形式,完整的API语法是:
int sqlite3_prepare(
sqlite3 *db, /* Database handle */
const char *zSql, /* SQL statement, UTF-8 encoded */
int nByte, /* Maximum length of zSql in bytes. */
sqlite3_stmt **ppStmt, /* OUT:
Statement handle */
const char **pzTail /* OUT:
Pointer to unused portion of zSql */
);
各个参数的定义为:
∙db为sqlite3的句柄
∙zSql为要执行的SQL语句
∙nByte为要执行语句在zSql中的最大长度,如果是负数,那么就需要重新自动计算
∙ppStmt为预编译后的句柄
∙pzTail预编译后剩下的字符串(未预编译成功或者多余的)的指针,通常没什么用,传入0或者NULL即可。
绑定参数sqlite3_bind_*有多种形式,分别对应不同的数据类型:
int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*));
int sqlite3_bind_double(sqlite3_stmt*, int, double);
int sqlite3_bind_int(sqlite3_stmt*, int, int);
int sqlite3_bind_int64(sqlite3_stmt*, int, sqlite3_int64);
int sqlite3_bind_null(sqlite3_stmt*, int);
int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*));
int sqlite3_bind_text16(sqlite3_stmt*, int, const void*, int, void(*)(void*));
int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*);
int sqlite3_bind_zeroblob(sqlite3_stmt*, int, int n);
预编译SQL语句中可以包含如下几种形式:
∙?
∙?
NNN
∙:
VVV
∙@VVV
∙$VVV
NNN代表数字,VVV代表字符串。
如果是?
或者?
NNN,那么可以直接sqlite3_bind_*()进行操作,如果是字符串,还需要通过sqlite3_bind_parameter_index()获取对应的index,然后再调用sqlite3_bind_*()操作。
这通常用于构造不定条件的SQL语句(动态SQL语句)。
查询操作
回调函数的解释参考最上面的描述。
首先声明一个回调函数。
intprint_record(void*,int,char**,char**);
查询代码
//select data
ret = sqlite3_exec(db,"select * from t",print_record,NULL,&errmsg);
if(ret !
= SQLITE_OK){
fprintf(stderr,"query SQL error:
%s\n",errmsg);
}
现在定义回调函数,只是简单的输出字段值。
int print_record(void *params,int n_column,char **column_value,char **column_name){
int i;
for(i=0;i printf("\t%s",column_value[i]);
}
printf("\n");
return 0;
}
不使用回调的查询操作
定义使用的变量
char**dbresult;intj,nrow,ncolumn,index;
查询操作
//select table
ret = sqlite3_get_table(db,"select * from t",&dbresult,&nrow,&ncolumn,&errmsg);
if(ret == SQLITE_OK){
printf("query %i records.\n",nrow);
index=ncolumn;
for(i=0;i printf("[%2i]",i);
for(j=0;j printf(" %s",dbresult[index]);
index++;
}
printf("\n");
}
}
sqlite3_free_table(dbresult);
sqlite3_get_table的API语法:
int sqlite3_get_table(
sqlite3 *db, /* An open database */
const char *zSql, /* SQL to be evaluated */
char ***pazResult, /* Results of the query */
int *pnRow, /* Number of result rows written here */
int *pnColumn, /* Number of result columns written here */
char **pzErrmsg /* Error msg written here */
);
void sqlite3_free_table(char **result);
其中:
∙db是sqlite3的句柄
∙zSql是要执行的sql语句
∙pazResult是执行查询操作的返回结果集
∙pnRow是记录的行数
∙pnColumn是记录的字段个数
∙pzErrmsg是错误信息
由于sqlite3_get_table是sqlite3_exec的包装,因此返回的结果和sqlite3_exec类似。
pazResult是一个(pnRow+1)*pnColumn结果集的字符串数组,其中前pnColumn个结果是字段的名称,后pnRow行记录是真实的字段值,如果某个字段为空,则对应值为NULL。
最后需要通过sqlite3_free_table()释放完整的结果集。
更新操作
sqlite3_exec(db,"updatetsetmsg='MESSAGE#10'whereid=10",NULL,NULL,&errmsg);
当然了,我们也可以使用预编译方法进行更新操作。
受影响的记录数
我们可以使用sqlite3_change(sqlite3*)的API来统计上一次操作受影响的记录数。
ret=sqlite3_exec(db,"deletefromt",NULL,NULL,&errmsg);
if(ret==SQLITE_OK){
printf("deleterecords:
%i\n",sqlite3_changes(db));
}
总结
这里我们接触了SQLITE3的13个API:
∙sqlite3_open()
∙sqlite3_exec()
∙sqlite3_close()
∙sqlite3_prepare_v2
∙sqlite3_bind_*()
∙sqlite3_bind_parameter_index()
∙sqlite3_step()
∙sqlite3_reset()
∙sqlite3_finalize()
∙sqlite3_get_table
∙sqlite3_change()
∙sqlite3_free()
∙sqlite3_free_table()
事实上截止到SQLITE3.7.14(2012/09/03)一共提供了204个API函数(http:
//www.sqlite.org/c3ref/funclist.html)。
但最精简的API函数大概有6个:
∙sqlite3_open()
∙sqlite3_prepare()
∙sqlite3_step()
∙sqlite3_column()
∙sqlite3_finalize()
∙sqlite3_close()
核心API也就10个(在精简API基础上增加4个):
∙sqlite3_exec()
∙sqlite3_get_table()
∙sqlite3_reset()
∙sqlite3_bind()
linux下的sqlite3的使用
一、SQLite的基本语法
这一章我们将会学习到sqlite的基本语法,sqlite的语法现象和SQL92是比较相象的,
或者说sqlite3兼容大部份SQL92的语法现象。
下面我们看看怎么用这些语法现象来创建数据库以及对数据库的各种操作。
2.1新建一个数据库
例如我们想新建一个数据库命名为zieckey.db,可以直接在shell下输入sqlite3zieckey.db,
前提是:
先进放sqlite的安装文件夹下然后执行下面的操作:
#./sqlite3zieckey.db
SQLiteversion3.0.8
Enter".help"forinstructions
sqlite>
这里SQLiteversion3.0.8是SQLite的版本信息。
也就是说本文使用的sqlite