QT3连接SQLite及使用方法

文档简介

项目需要使用SQLite，这是一款主要用于嵌入式轻型的数据库，本文档主要目的在于记录如何使用基于QT平台的UI与SQLite进行连接，并简单介绍SQLite的使用方法。

文档分为以下几个部分：

A. SQLite的交叉编译；

B. QT连接SQLite；

C. SQLite的使用方法；

编译环境：

操作系统：Ubuntu 11.04

本机平台：X86

目标平台：Loongson 1B 开发板

交叉编译工具链：gcc-3.4.6-2f（1B交叉编译工具链）

所需软件及工具包：

qt-embedded-free-3.3.7.tar.gz

sqlite3_3.7.4.orig.tar.gz

1. SQLite的交叉编译

首先获取SQLite的源码包，可以在sqlite的官网下载源码包：

http://www.sqlite.org/download.html

也可以在Ubuntu中使用以下命令获取sqlite的源码包：

# apt-get source sqlite3

下载完在当前目录下能看到多了几个文件，其中

sqlite3_3.7.4.orig.tar.gz

即为sqlite的官方源码包。

解压后进入sqlite3-3.7.4目录：

执行以下命令：

#./configure --host mipsel-linux --prefix /mipsel-linux-sqlite3/

#make

#make install

编译过程一般出现的错误都是因为缺少相关组件的库的缘故，只需要根据相关错误打印信息搜索相关组件，然后apt-get安装后再次编译即可编译通过。

编译完成后在/mipsel-linux-sqlite3/目录下能看到三个文件夹：

bin/  include/  lib/

分别是sqlite的可执行文件、头文件和动态库，在接下来的QT连接SQLite过程中需要用到此目录下的sqlite头文件和动态库。

2. QT连接SQLite

在现有的QT程序内使用SQLite，主要是将sqlite的头文件包含到QT功能内，并指明sqlite头文件和动态库所在目录，在编译QT应用程序时将sqlite一起编译进去即可。

下边创建一个sqlite3-test工程为例子：

#mkdir  sqlite3-test

#cd sqlite3-test/

#vi main.cpp

/******main.cpp*******/
#include <qapplication.h> 
#include <qwidget.h>
#include <qstring.h>
#include <sqlite3.h> 	 // 添加sqlite头文件
#define SQL_FILE "/data/netDev.db" //sqlite数据库文件路径
sqlite3 *db; //sqlite文件描述符 
int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    db=NULL;
    int sqlite_error;
    sqlite_error = sqlite3_open(SQL_FILE, &db); //打开指定的数据库文件,如果不存在将创建一个同名的数据库文件
    if( sqlite_error != SQLITE_OK )
    {
        qDebug("sqlite_error");
    }
    int nRow, nColumn;
    int i,j;
    int index;
    char **dbResult;
    char * errmsg = NULL;
    int result = sqlite3_get_table( db, "select * from netDev", &dbResult, &nRow, &nColumn, &errmsg ); //执行指定指令："select * from netDev"其中netDev为打开的数据库文件的table名字
    if( SQLITE_OK == result )
    {
        printf( "-------\n" );
        index = nColumn;
        printf( "Check record:%d \n", nRow );
        for(  i = 0; i < nRow ; i++ )
        {
            printf( "NO. %d :\n", i+1 );
            for( j = 0 ; j < nColumn; j++ )
            {
                printf( "Name:%s  > Data:%s\n",  dbResult[j], dbResult [index] );
                ++index;
            }
            printf( "-------\n" );
        }
    }
    sqlite3_free_table( dbResult );
    return app.exec();
}

#vi sqlite3-test.pro

/****** sqlite3-test.pro *******/

TEMPLATE = app

CONFIG -= moc

INCLUDEPATH += .

#指定sqlite的头文件及动态库路径

SQLITE_PATH=/mipsel-linux-sqlite3

DEPENDPATH += $$SQLITE_PATH/include

INCLUDEPATH += $$SQLITE_PATH/include

LIBS += -L$$SQLITE_PATH/lib

LIBS += -lsqlite3

# Input

SOURCES += main.cpp

然后使用qmake-qt3工具生成Makefile后检查Makefile文件中的LIBS是否定义了 -L/mipsel-linux-sqlite3/lib -lsqlite3；以及INCPATH是否定义了-I/mipsel-linux-sqlite3/include；

再执行make进行编译，然后查看生成的二进制文件sqlite3-test所需的动态库文件，将目标板运行QT3应用程序相关文件以及自定义的sqlite数据库文件移植到目标板的文件系统中指定位置，在板上执行

#./sqlite3-test -qws

打印信息如下：

-------

Check record:3 

NO. 1 :

Name:ID  > Data:NO1

Name:message  > Data:chenyuxin

-------

NO. 2 :

Name:ID  > Data:NO2

Name:message  > Data:ethan

-------

NO. 3 :

Name:ID  > Data:NO3

Name:message  > Data:hello

-------

获取到三组数据，每一组有两个成员，分别是ID和message，到此已经验证QT成功连接sqlite了。

下边将介绍sqlite具体的一些使用方法。

3. SQLite的使用方法

3.1 SQLite工具的使用

首先在Ubuntu中获取sqlite工具包：

# apt-get install sqlite3

下边介绍一些该工具相关的常用使用方法：

1、创建一个新的数据库：sqlite3 name.db

先建立一个 Db 目录，并在 Db 目录中创建一个 test.db 数据库文件，打开控制台窗口，命令如下：

# mkdir sqlite3-test

# cd mkdir  sqlite3-test

# sqlite3 test.db

2、打开一个已经存在的数据库：sqlite3 name.db 

创建一个新数据库和打开一个已经存在的数据库命令是一模一样的，如果文件在当前目录下不存在，则新建；如果存在，则打开。

3、导入数据：.read name.sql

在sqlite3-test目录下创建一个空文件：test.sql，然后在里边写入相关的SQL语句，例如：

BEGIN TRANSACTION;

CREATE TABLE Cars(Id integer PRIMARY KEY, Name text, Cost integer);

INSERT INTO Cars VALUES(1,'Audi',52642);

INSERT INTO Cars VALUES(2,'Mercedes',57127);

INSERT INTO Cars VALUES(3,'Skoda',9000);

INSERT INTO Cars VALUES(4,'Volvo',29000);

INSERT INTO Cars VALUES(5,'Bentley',350000);

INSERT INTO Cars VALUES(6,'Citroen',21000);

INSERT INTO Cars VALUES(7,'Hummer',41400);

INSERT INTO Cars VALUES(8,'Volkswagen',21600);

COMMIT;

在命令行环境中输入

.read   test.sql

即将所有的数据导入到 test.db 数据库中

4、列出所有的数据表：.tables

完成上面所有的工作以后，我们就可以列出所有的数据表了

当前test.db内仅有一个表，表名为Cars。

5、导出某个表的数据：.dump

整个表以 SQL 语句的形式为导出来了，但是只是显示在终端上，如何把它导出到文件中呢？

6、设置导出目标：

.output

或者

.output stdout

先运行.output cars.sql ，然后再运行.dump则数据保存到cars.sql文件，如果要恢复成导出到终端（标准输出），则运行 .output stdout。

7、创建表

在命令行里大部份的SQL语句它都是支持的，现在来新建一个表

sqlite>create table Artists (

--->ArtistID INTEGER PRIMARY KEY,

--->ArtistName TEXT);

其中表名为Artists，有两个成员分别是ArtistID和ArtistName，后边是该成员携带的数据，INTEGER表示指定数据类型为整形；

sqlite 对SQL语句大小写不敏感，所以大写小写都可以。

使用.tables查询后可知现在本数据库文件有两个表：Artists、Cars。

8、插入数据

sqlite>insert into Artists (ArtistID,ArtistName) values (NULL,'Peter Gabriel');

sqlite>insert into Artists (ArtistID,ArtistName) values (NULL,'Bruce Hornsby');

sqlite>insert into Artists (ArtistID,ArtistName) values (NULL,'Lyle Lovett');

sqlite>insert into Artists (ArtistID,ArtistName) values (NULL,'Beach Boys');

9、表查询

查看指定表名的内容，若有需要，先打开表头，执行一下语句：

sqlite>.headers ON

sqlite>select * from Artists;

查询到的内容为：

ArtistID|ArtistName

1|Peter Gabriel

2|Bruce Hornsby

3|Lyle Lovett

4|Beach Boys

10、更新字段

若想更新ArtistID=4的歌手名字为Santana，执行一下指令：

sqlite>UPDATE Artists SET ArtistName ='Santana' WHERE ArtistID=4;

然后再次查询内容变更成：

ArtistID|ArtistName

1|Peter Gabriel

2|Bruce Hornsby

3|Lyle Lovett

4|Santana

11、删除字段

首先执行

sqlite>select * FROM Artists WHERE ArtistName LIKE 'Pet%';

看看是不是想要删除的数据，是的话执行

sqlite>DELETE FROM Artists WHERE ArtistName LIKE 'Pet%';

再次查新内容变更成：

ArtistID|ArtistName

2|Bruce Hornsby

3|Lyle Lovett

4|Santana

以上只是介绍了部分常用的SQL用法，SQLite支持的SQL包括：ATTACH DATABASE、BEGIN TRANSACTION、comment 、COMMIT、TRANSACTION 、COPY 、CREATE INDEX 、CREATE TABLE 、CREATE TRIGGER 、CREATE VIEW 、DELETE 、DETACH DATABASE 、DROP INDEX 、DROP TABLE 、DROP TRIGGER 、DROP VIEW 、END TRANSACTION 、EXPLAIN 、expression 、INSERT 、ON CONFLICT clause 、PRAGMA 、REPLACE 、ROLLBACK TRANSACTION 、SELECT 、UPDATE。

具体用法请自行查新相关文档。

3.2 SQLite在编程中的使用

主要是一些SQLite中提供的一些接口函数，下边介绍比较常用的一些接口函数的用法：

1、打开和关闭数据库

使用SQLite3接口操作数据库时都要先打开数据库

int sqlite3_open(const char *filename, sqlite3 **ppDb);

参数即返回值意义如下：

filename：要打开的数据库的文件名

ppDb：用户返回数据库句柄

返回值：SQLITE_OK代表成功，否则为错误码

返回的错误码可以在SQLite3源码的sqlite3.h头文件找到。需要说明的是这些错误是SQLite3编程接口共同使用的。而不是sqlite3_open函数私有。

使用完数据库后关闭：

int sqlite3_close(sqlite3 *ppDb);

2、执行SQL语句

SQLite3提供了一个一般化的编程接口，可以对以打开的数据库执行任何SQL语句。这个函数的原型如下：

int sqlite3_exec(sqlite3 *pDb, const char *sql,

                 int (*callback)(void* context, int nArg, char** azArg， char** azCol)，

                 void *context， char **errmsg)；

参数即返回值意义如下：

pDb：已打开的数据库的句柄

sql：字符串，内容是一条或多条sql语句

callback：回调函数

context：传递给回调函数的第一个参数，可称上下文参数

errmsg：指向一个字符串，其内容是对操作中发生的错误的文字描述

返回值：SQLITE_OK代表成功，否则为错误码

回调函数的作用是：当进行查询操作时，每查询到一条记录都会调用一次回调函数，这条记录的内容通过回调函数的参数传入。回调函数的参数既返回值的含义解释如下：

context：调用sqlite3_exec时传入的context指针。

nArg：数据的个数

azArg：字符串数组，有nArg个元素，表示每个字段的值

azCol：字符串数组，有nArg个元素，表示每个字段的名称

返回值：0表示要继续查询否则查询操作结束，对sqllite3_exe函数的调用将返回错误码SQLITE_ABORT.

即使记录中某个字段的类型为整数，它的值也是由C语言的字符串来代表中。

还有就是errmsg参数是一个字符指针变量的地址，通过它将得到一个字符串的首地址。显然，这个字符串的存储空间是在sqlite3_exec函数内动态分配得到的，因此用过后必须释放以免造成内存泄漏。鉴于外界并不知道sqlite3_exe函数内部是如何进行内存分配的。SQLite3平台专门提供了一个函数用于释放这块内存，其原型如下：

void sqlite3_free(void *p);

其中参数P指向要释放的内存。

3、查询数据库

使用上面的sqlite3_exec函数就可以对数据库进行查询操作，但它使用回调函数作为返回结果的手段，有时不是很方便，因此SQLite3也提供了一个专门的接口进行查询操作，其函数原型如下：

sqlite3_get_table(sqlite3 *pDb, const char *sql, char ***pResult, int *nrow, int *ncolumn, char **errmsg);

其中各个参数的含义解释如下：

pDb:已打开的数据库的实例

sql：字符串，内容是一条或多条SQL语句。

pResult：一个（char **）型变量的地址，用于返回查询结果，查询结果由字符串数组代表。

nrow：结果表的行数。

ncolumn：结果的列数

errmsg：指向一个字符串，其内容是对操作中发生的错误的文字描述

这里的参数都好理解，不好理解的是pResult是查询的结果，它是一个字符串数组，因此它的首地址是（char **）地址。虽然它是一个一维的字符串数组，但要以二维的方式去理解，其中前ncolumn个字符串表示结果表的字段名，随后的ncolumn个字符串则是第一条记录的各个字段的值，依次类推。

需要说明的一点是空间的问题，显然pResult所指向的字符串数组及各个字符串所占的空间都是在sqlite3_get_table函数内部动态分配得到的。因此需要使用后进行释放。由于它又不是一块平坦的内存，故也不能用sqlite3_free函数来释放，而必须用下面这个专用的函数：

void sqlite3_free_table(char **result);

其中，result参数就是查询得到的结果表的首地址。

以上就是在C编程或者QT编程中使用sqlite数据库的相关用法，其他平台的用法尚未验证，这里就不多讲了。

参考资料：

http://baike.baidu.com/view/19310.htm

http://blog.sina.com.cn/s/blog_4c7c21a9010009bm.html