分类： SQLite/嵌入式数据库
2012-12-11 16:33:02
SQLite3的确很好用。小巧、速度快。这些天正在研究它，将它移植到ARM系统里面，又有一些收获，这里把我对sqlite3的研究列出来，以备忘记。【其中有摘抄自互联网】
SQLite3提供的是一些C函数接口，你可以用这些函数操作数据库。通过使用这些接口，传递一些标准sql语句（以char *类型）给SQLite3函数，SQLite3就会为你操作数据库。
SQLite3跟MS的access一样是文件型数据库，就是说，一个数据库就是一个文件，此数据库里可以建立很多的表，可以建立索引、触发器等等，但是，它实际上得到的就是一个文件。备份这个文件就备份了整个数据库。
SQLite3不需要任何数据库引擎，这意味着如果你需要SQLite3来保存一些用户数据，甚至都不需要安装数据库。
打开数据库
int sqlite3_open(const char *zFilename, sqlite3 **ppDb)
需要传入两个参数，一是数据库文件名，比如："/flash/mydb1.db"。文件名不需要一定存在，如果此文件不存在，SQLite3会自动建立它。如果它存在，就尝试把它当数据库文件来打开。sqlite3 **ppDb参数是关键数据结构。这个结构底层细节如何，你不要关它。
函数返回值表示操作是否正确，如果是SQLITE_OK则表示操作正常。相关的返回值sqlite定义了一些宏。具体这些宏的含义可以参考sqlite3.h文件。里面有详细定义（顺便说一下，SQLite3的代码注释率自称是非常高的，实际上也的确很高。只要你会看英文，SQLite3可以让你学到不少东西）。
关闭数据库
int sqlite3_close(sqlite3 *db)
如果用sqlite3_open开启了一个数据库，结尾时不要忘了用这个函数关闭数据库。
使用例题：
{
sqlite3 *db;
int res;
res = sqlite3_open("/flash/db1.db", &db);
if(res != SQLITE_OK) {
return -1;
}
sqlite3_close(db);
}
执行sql语句
int sqlite3_exec(sqlite3 *db,const char *zSql,sqlite3_callback xCallback,void *pArg,char **pzErrMsg)
这就是执行一条sql语句的函数。
第1个参数不再说了，是前面open函数得到的指针。说了是关键数据结构。
第2个参数const char *sql是一条sql语句，以/0结尾。
第3个参数sqlite3_callback是回调，当这条语句执行之后，sqlite3会去调用你提供的这个函数。
第4个参数void *pArg是你所提供的指针，你可以传递任何一个指针参数到这里，这个参数最终会传到回调函数里面，如果不需要传递指针给回调函数，可以填NULL。等下我们再看回调函数的写法，以及这个参数的使用。
第5个参数char ** errmsg是错误信息。注意是指针的指针。sqlite3里面有很多固定的错误信息。执行sqlite3_exec之后，执行失败时可以查阅这个指针（直接printf(“%s/n”,errmsg)）得到一串字符串信息，这串信息告诉你错在什么地方。sqlite3_exec函数通过修改你传入的指针的指针，把你提供的指针指向错误提示信息，这样sqlite3_exec函数外面就可以通过这个char*得到具体错误提示。
说明：通常，sqlite3_callback和它后面的void *这两个位置都可以填NULL。填NULL表示你不需要回调。比如你做insert操作，做delete操作，就没有必要使用回调。而当你做select时，就要使用回调，因为sqlite3把数据查出来，得通过回调告诉你查出了什么数据。
exec的回调
typedef int(*sqlite3_callback)(void *,int,char**,char**);
你的回调函数必须定义成上面这个函数的类型。下面给个简单的例子：
//sqlite3的回调函数
// sqlite每查到一条记录，就调用一次这个回调
intLoadMyInfo(void* para,intn_column,char** column_value,char** column_name ) {
//para是你在sqlite3_exec里传入的void *参数
//通过para参数，你可以传入一些特殊的指针（比如类指针、结构指针），然后在这里面强制转换成对应的类型（这里面是void*类型，必须强制转换成你的类型才可用）。然后操作这些数据
//n_column是这一条记录有多少个字段(即这条记录有多少列)
// char ** column_value是个关键值，查出来的数据都保存在这里，它实际上是个1维数组（不要以为是2维数组），每一个元素都是一个char *值，是一个字段内容（用字符串来表示，以/0结尾）
//char ** column_name跟column_value是对应的，表示这个字段的字段名称
//这里，我不使用para参数。忽略它的存在.
int i;
printf(“记录包含%d个字段/n”, n_column );
for( i = 0 ; i < n_column; i ++ ) {
printf(“字段名:%s ß>字段值:%s/n”, column_name[i], column_value[i] );
}
printf(“------------------/n“);
return 0;
}
int main( int , char ** )
{
sqlite3 * db;
int result;
char * errmsg = NULL;
result = sqlite3_open("/flash/db1.db", &db);
//数据库操作代码
//创建一个测试表，表名叫MyTable_1，有2个字段：ID和name。其中ID是一个自动增加的类型，以后insert时可以不去指定这个字段，它会自己从0开始增加
result = sqlite3_exec( db,“create table MyTable_1( ID integer primary key autoincrement, name nvarchar(32) )”, NULL, NULL, errmsg );
//插入一些记录
result = sqlite3_exec( db,“insert into MyTable_1( name ) values (‘走路’)”, 0, 0, errmsg );
result = sqlite3_exec( db,“insert into MyTable_1( name ) values (‘骑单车’)”, 0, 0, errmsg );
result = sqlite3_exec( db,“insert into MyTable_1( name ) values (‘坐汽车’)”, 0, 0, errmsg );
//开始查询数据库
result = sqlite3_exec( db,“select * from MyTable_1”, LoadMyInfo, NULL, errmsg );
//关闭数据库
sqlite3_close( db );
return0;
}
通过上面的例子，应该可以知道如何打开一个数据库，如何做数据库基本操作。有这些知识，基本上可以应付很多数据库操作了。
不使用回调查询数据库
上面介绍的sqlite3_exec是使用回调来执行select操作。还有一个方法可以直接查询而不需要回调。但是，我个人感觉还是回调好，因为代码可以更加整齐，只不过用回调很麻烦，你得声明一个函数，如果这个函数是类成员函数，你还不得不把它声明成static的（要问为什么？这又是C++基础了。C++成员函数实际上隐藏了一个参数：this，C++调用类的成员函数的时候，隐含把类指针当成函数的第一个参数传递进去。结果，这造成跟前面说的sqlite回调函数的参数不相符。只有当把成员函数声明成static时，它才没有多余的隐含的this参数）。
虽然回调显得代码整齐，但有时候你还是想要非回调的select查询。这可以通过sqlite3_get_table函数做到。
intsqlite3_get_table(sqlite3*,constchar*sql,char***resultp,int*nrow,int*ncolumn,char**errmsg );
第1个参数不再多说，看前面的例子。
第2个参数是sql语句，跟sqlite3_exec里的sql是一样的。是一个很普通的以/0结尾的char *字符串。
第3个参数是查询结果，它依然一维数组（不要以为是二维数组，更不要以为是三维数组）。它内存布局是：第一行是字段名称，后面是紧接着是每个字段的值。下面用例子来说事。
第4个参数是查询出多少条记录（即查出多少行）。
第5个参数是多少个字段（多少列）。
第6个参数是错误信息，跟前面一样，这里不多说了。
下面给个简单例子:
int main( int , char ** )
{
sqlite3 * db;
int result;
char * errmsg = NULL;
char **dbResult;//是char **类型，两个*号
int nRow, nColumn;
int i , j;
int index;
result = sqlite3_open(/flash/db1.db", &db);
//数据库操作代码
//假设前面已经创建了MyTable_1表
//开始查询，传入的dbResult已经是char **，这里又加了一个&取地址符，传递进去的就成了char ***
result = sqlite3_get_table( db,“select * from MyTable_1”, &dbResult, &nRow, &nColumn, &errmsg );
if(SQLITE_OK== result )
{
//查询成功
index = nColumn;//前面说过dbResult前面第一行数据是字段名称，从nColumn索引开始才是真正的数据
printf(“查到%d条记录/n”, nRow );
for( i = 0; i < nRow ; i++ )
{
printf(“第%d条记录/n”, i+1 );
for( j = 0 ; j < nColumn; j++ )
{
printf(“字段名:%s ß>字段值:%s/n”, dbResult[j], dbResult [index] );
++index;// dbResult的字段值是连续的，从第0索引到第nColumn - 1索引都是字段名称，从第nColumn索引开始，后面都是字段值，它把一个二维的表（传统的行列表示法）用一个扁平的形式来表示
}
printf(“-------/n”);
}
}
//到这里，不论数据库查询是否成功，都释放char**查询结果，使用sqlite提供的功能来释放
sqlite3_free_table( dbResult );
//关闭数据库
sqlite3_close( db );
return0;
}
到这个例子为止，sqlite3的常用用法都介绍完了。
用以上的方法，再配上sql语句，完全可以应付绝大多数数据库需求 .
