一、简介
SQLite是一个基于文件的轻量级数据库,但功能还挺强,速度也很快,对于小型数据库应用开发绝对够用了。使用起来也非常方便,下面的介绍可以看出来,使用起来真的非常简单。
二、官方网站
Sqlite的官方网站www.sqlite.org,在该网站可以下载最新的sqlite版本。
三、辅助工具
Sqlite数据库的管理工具有SQLiteManager、SqliteAdmin等。
SqliteManager只有英文版(需要注册或者破解方可使用)。其自带的帮助文档有SQL语句的详细介绍,对于不熟悉Sql语句的人来说很方便。而且它的很多操作都有自动的SQL语句提示,对于不常使用数据库的人来说也很好用。
SqliteAdmin有绿色中文版,功能相对于SqliteManager略少,对于熟悉Sql语句的人,该版本够用了。
另外说明一下,在我们的程序中以UTF-8方式(大部分人应该都是以这种方式打开的)打开数据库进行操作时,两种软件的表现如下:
如果插入数据库的数据,汉字是以ANSI字符存储的话,那么在SqliteAdmin中打开时,会显示正常汉字,而在SqliteManager中,会显示为乱码。
如果插入数据库的数据,汉字是以UTF-8字符存储的话,那么在SqliteManager中打开时,会显示正常汉字,而在SqliteAdmin中,会显示为乱码。
很明显,SqliteManager的表现,要正常一些。SqliteManager更加值得推荐,不过需要安装和破解。SqliteAdmin是绿色的,但面对ANSI汉字,可能在某些时候力不从心,而且功能没有SqliteManager强大。
四、C/C++使用前准备
直接将sqlite3.h和sqlite3.c加入自己的C/C++工程中,即可使用sqlite3。
使用VC的用户特别注意,大多数VC工程,默认都是使用预编译头的,需要对sqlite3.c这个文件,去掉预编译头,方可编译通过。去掉的方法是在工程中的文件视图中,右键点击sqlite3.c这个文件,打开“配置属性”中的“C/C++”,找到“预编译头”,设置为不使用预编译头即可。
Sqlite支持UTF-8和UTF-16,不过它居然不支持C/C++程序中最常用的ANSI。因此数据库路径中如果包含中文字符的话,需要将路径转换成相应的字符格式。
1、以UTF-8方式打开(如果数据库路径中包含中文字符,需要进行ANSI到UTF8的转换)
示例中的路径是全英文字符,ANSI和UTF8是相同的,因此省去转化。
//打开数据库 sqlite3 *db = NULL; int result = sqlite3_open("c:\\abc.db", &db); if (SQLITE_OK != result) { return; } //关闭数据库 sqlite3_close(db);
2、以UTF-16方式打开
如要以UTF-16方式打开,把打开数据库的语句改为"sqlite3_open16(L"c:\\abc.db", &db)"即可。
注意:如果以UTF-8方式打开数据库,那么以后任何数据库操作,都必须以UTF-8方式进行。UTF-16也同理。
一个比较常见的错误是,以UTF-8打开了数据库,但却插入了ANSI的汉字。犯下这种错误是很不经意的,因为对于英文字符,UTF-8和ANSI是一模一样的嘛!一个我所知的非常典型的后果就是使用模糊查找语句进行检索时,可能查询的结果,并不是你想要的。
执行SQL语句可以调用sqlite3_exec函数,一般来说,如果不需要返回的数据和错误信息,执行方式如下:
sqlite3_exec(db, strSQL, 0, 0, 0);
1、创建表
假设创建如下图所示的数据库:
其SQL语句为:
CREATE TABLE [MyTable] ([ID] INTEGER PRIMARY KEY NOT NULL,[MyText] TEXT NULL, [MyDate] DATE NOT NULL, [MyTime] TIME NULL,[MyFloat] FLOAT NULL)
下面是插入一条记录的示例SQL语句。
INSERT INTO MyTable (MyText, MyDate, MyTime, MyFloat) VALUES ('---上班好远!', '2012-03-23', '9:00:00', 1000)
下面是更新若干条记录的示例SQL语句。
UPDATE MyTable SET MyText='真的吗?', MyTime='10:00:00' WHERE ID >=0 AND ID <=20
下面是删除若干条记录的示例SQL语句。
DELETE FROM MyTable WHERE ID >=3 AND ID <=5
如果要进行大量的操作,比如要插入10000条数据,如果逐条执行SQL语句,则消耗的时间非常长。采用事务的方式批量处理,可以极大程度提升操作速度(我用1000条记录实验了一下,速度提高了500倍以上)。
下面是一个批量插入10000条数据的代码示例:
//插入条数据(在Begin和Commit之间批量操作,可以大幅度提高效率) result = sqlite3_exec(db, "BEGIN;", 0, 0, 0); for (int i=0; i<10000; i++) { //插入一条数据 result = sqlite3_exec(db, "INSERT INTO MyTable (MyText, MyDate, MyTime, MyFloat) VALUES ('---上班好远!', '2012-03-23', '9:00:00', 1000);", 0, 0, 0); } result = sqlite3_exec(db, "COMMIT;", 0, 0, 0);
下面是以表单形式获取数据的示例代码:
//查询记录(返回数据表的方式) char **pazResult; int nRow, nCol; sqlite3_get_table(db, "SELECT * FROM MyTable LIMIT 1000 OFFSET 2000", &pazResult, &nRow, &nCol, 0); //nRow指示出有多少行 //nCol指示出有多少列 //从pazResult中可以解析出所有记录,记录以字符串形式返回 //第n列的名称,存放于pazResult[n] //第n行第m列的数据,存放与paszResult[(n + 1) * nCol + m] //使用完后,务必释放为记录分配的内存 sqlite3_free_table(pazResult);
下面以代码形式示例如何获得查询语句返回的记录。
首先需要定义一个回调函数如下(参数意义待会再说):
int Result(void* pContext, int nCol, char** azValue, char** azName);
然后调用sqlite函数执行查询语句,在回调函数一栏输入上面定义的回调函数:
sqlite3_exec(db, "SELECT * FROM MyTable LIMIT 10 OFFSET 20", Result, 0, 0);
执行该SQL语句时,每返回一条记录都会触发一次上面的回调函数,在该回调函数的实现中,即可得到查询结果。
在上面的Result函数中,各个参数意义如下:
pContext |
这个参数是调用sqlite3_exec函数是输入的第4个参数。它通常作为环境变量用于指示出当前执行代码的主体。示例代码中我忽略了这个参数,但正式使用时一般不会忽略它。 |
nCol |
表示该条记录有多少列。 |
azValue |
返回的数据都蕴含在该变量中,它也是一个字符串数组。azValue[n]即为第n列的数据。 |
azName |
存放列的名称,azName[n]就是第n列的名称。 |
考虑到sqlite作为轻量级数据库我很少用它存储二进制数据,因此本文之前并未详细解决二进制数据的存取。
但后来我发现实际使用时候,有时候存储一些二进制数据也是很必要的,比如一些简单的图片。另外一些可能包含一些sql语句的保留字符的文本时,如果想避免进行字符串检查,也可以考虑当作二进制数据存取。
在sqlite中,二进制数据的数据类型为blob,本文还是以代码来示范其应用,包括创建表格、存入二进制数据,读出二进制数据。
向数据库中存入二进制数据过程大体如下:
1.使用sqlite3_prepare进行sql语句准备,其中二进制内容以"?"替代;
2.以sqlite3_bind_blob将"?"的内容以二进制数据填充。
3.调用sqlite3_step执行sql语句完成存入操作。
从数据库中读取二进制数据过程大体如下:
1.使用sqlite3_prepare语句进行查询行为;
2.调用sqlite3_step获得查询到的结果,第一次调用时,返回查询到的第一行数据;
3.调用sqlite3_column_blob获得二进制数据指针,调用sqlite3_column_bytes获得二进制数据长度,两者结合可以获得完整二进制数据。
4.继续执行第二步,获得查询到的下一条结果。
其余详情,可以参看代码示例:
//打开数据库(不存在则自动创建) sqlite3* db = NULL; int result = sqlite3_open("C:\\TestBlob.db", &db); if(SQLITE_OK != result) { return; } //创建数据表(本次不检查返回结果,由于数据表不允许重复创建,因此只有首次执行才会成功) result = sqlite3_exec(db, "CREATE TABLE tb" //创建的表名为tb "(id integer NOT NULL PRIMARY KEY AUTOINCREMENT UNIQUE" //第一列使用一个自动增长的integer数据 ", b1 blob" //第二列为blob类型,列名为b1 ", b2 blob);" //第三列为blob类型,列名为b2 , 0, 0, 0); //此处我不再精心构造二进制数据了,随便用两个字符串替代用作演示 //blob1我随便加了几个经常会导致sql语句出问题的字符 std::string blob1 = "abc'<?%", blob2 = "bcd"; //准备一个statement用于后续进行二进制操作 sqlite3_stmt* stmt = NULL; //准备执行包含二进制数据的sql操作中,注意下面的两个“?”表示的是二进制数据 sqlite3_prepare(db, "insert into tb (b1, b2) values (?, ?);", -1, &stmt, NULL); //下面以二进制数据分别填充这两个"?",注意序号从1开始的 sqlite3_bind_blob(stmt, 1, blob1.data(), blob1.length(), NULL); sqlite3_bind_blob(stmt, 2, blob2.data(), blob2.length(), NULL); //真正开始执行前面的sql语句 sqlite3_step(stmt); //释放前面为stmt分配的内存,必须要有,否则会有内存泄露 sqlite3_finalize(stmt); // //**接下来,演示一下如何读取插入的数据 // //读取二进制数据 result = sqlite3_prepare(db, "select * from tb", -1, &stmt, 0); while (SQLITE_ROW == sqlite3_step(stmt)) { //借助两个string来读取反馈结果(仅供演示) std::string blobRet1, blobRet2; //示范一下如何读取整形数据 int id = sqlite3_column_int(stmt, 0); //示范一下如何读取二进制数据 blobRet1.append( (char *)sqlite3_column_blob(stmt, 1) , sqlite3_column_bytes(stmt, 1) ); //读取blob2的内容 blobRet2.append( (char *)sqlite3_column_blob(stmt, 2) , sqlite3_column_bytes(stmt, 2) ); } //**如果希望从头遍历一次反馈的结果,调用sqlite3_reset(stmt);可以达到此效果 //同样需要记得释放资源 sqlite3_finalize(stmt); //关闭数据库 sqlite3_close(db);