sqlite

SQLite学习手册(C/C++接口简介)

http://www.2cto.com/database/201202/119555.html

一、概述：
 
在SQLite提供的C/C++接口中，其中5个APIs属于核心接口。在这篇博客中我们将主要介绍它们的用法，以及它们所涉及到的核心SQLite对象，如database_connection和prepared_statement。相比于其它 数据库引擎提供的APIs，如OCI、MySQL API等，SQLite提供的接口还是非常易于理解和掌握的。
 
二、核心对象和接口：
 
1. 核心对象：
在SQLite中最主要的两个对象是，database_connection和prepared_statement。database_connection对象是由sqlite3_open()接口函数创建并返回的，在应用程序使用任何其他SQLite接口函数之前，必须先调用该函数以便获得database_connnection对象，在随后的其他APIs调用中，都需要该对象作为输入参数以完成相应的工作。至于prepare_statement，我们可以简单的将它视为编译后的SQL语句，因此，所有和SQL语句执行相关的函数也都需要该对象作为输入参数以完成指定的SQL操作。
 
2. 核心接口：
1). sqlite3_open
上面已经提到过这个函数了，它是操作SQLite数据库的入口函数。该函数返回的database_connection对象是很多其他SQLite APIs的句柄参数。注意，我们通过该函数既可以打开已经存在的数据库文件，也可以创建新的数据库文件。对于该函数返回的database_connection对象，我们可以在多个线程之间共享该对象的指针，以便完成和数据库相关的任意操作。然而在多线程情况下，我们更为推荐的使用方式是，为每个线程创建独立的database_connection对象。对于该函数还有一点也需要额外说明，我们没有必要为了访问多个数据库而创建多个数据库连接对象，因为通过SQLite自带的ATTACH命令可以在一个连接中方便的访问多个数据库。
 
2). sqlite3_prepare
该函数将SQL文本转换为prepared_statement对象，并在函数执行后返回该对象的指针。事实上，该函数并不会评估参数指定SQL语句，它仅仅是将SQL文本初始化为待执行的状态。最后需要指出的，对于新的应用程序我们可以使用sqlite3_prepare_v2接口函数来替代该函数以完成相同的工作。
 
3). sqlite3_step
该函数用于评估sqlite3_prepare函数返回的prepared_statement对象，在执行完该函数之后，prepared_statement对象的内部指针将指向其返回的结果集的第一行。如果打算进一步迭代其后的数据行，就需要不断的调用该函数，直到所有的数据行都遍历完毕。然而对于INSERT、UPDATE和DELETE等DML语句，该函数执行一次即可完成。
 
4). sqlite3_column
该函数用于获取当前行指定列的数据，然而严格意义上讲，此函数在SQLite的接口函数中并不存在，而是由一组相关的接口函数来完成该功能，其中每个函数都返回不同类型的数据，如：
sqlite3_column_blob
sqlite3_column_bytes
sqlite3_column_bytes16
sqlite3_column_double
sqlite3_column_int
sqlite3_column_int64
sqlite3_column_text
sqlite3_column_text16
sqlite3_column_type
sqlite3_column_value
sqlite3_column_count
其中sqlite3_column_count函数用于获取当前结果集中的字段数据。下面是使用sqlite3_step和sqlite3_column函数迭代结果集中每行数据的伪代码，注意这里作为示例代码简化了对字段类型的判断：
1     int fieldCount = sqlite3_column_count(...);
2     while (sqlite3_step(...) <> EOF) {
3         for (int i = 0; i < fieldCount; ++i) {
4             int v = sqlite3_column_int(...,i);
5         }
6     }
 
5). sqlite3_finalize
该函数用于销毁prepared statement对象，否则将会造成内存泄露。
 
6). sqlite3_close
该函数用于关闭之前打开的database_connection对象，其中所有和该对象相关的prepared_statements对象都必须在此之前先被销毁。
 
三、参数绑定：
 
和大多数关系型数据库一样，SQLite的SQL文本也支持变量绑定，以便减少SQL语句被动态解析的次数，从而提高数据查询和数据操作的效率。要完成该操作，我们需要使用SQLite提供的另外两个接口APIs，sqlite3_reset和sqlite3_bind。见如下示例：
 1     void test_parameter_binding() {
 2         //1. 不带参数绑定的情况下插入多条数据。
 3         char strSQL[128];
 4         for (int i = 0; i < MAX_ROWS; ++i) {
 5             sprintf(strSQL,"insert into testtable values(%d)",i);
 6             sqlite3_prepare_v2(..., strSQL);
 7             sqlite3_step(prepared_stmt);
 8             sqlite3_finalize(prepared_stmt);
 9         }
10         //2. 参数绑定的情况下插入多条数据。
11         string strSQLWithParameter = "insert into testtable values(?)";
12         sqlite3_prepare_v2(..., strSQL);
13         for (int i = 0; i < MAX_ROWS; ++i) {
14             sqlite3_bind(...,i);
15             sqlite3_step(prepared_stmt);
16             sqlite3_reset(prepared_stmt);
17         }
18         sqlite3_finalize(prepared_stmt);
19     }
 
这里首先需要说明的是，SQL语句"insert into testtable values(?)"中的问号(?)表示参数变量的占位符，该规则在很多关系型数据库中都是一致的，因此这对于数据库移植操作还是比较方便的。
通过上面的示例代码可以显而易见的看出，参数绑定写法的执行效率要高于每次生成不同的SQL语句的写法，即2)在效率上要明显优于1)，下面是针对这两种写法的具体比较：
1). 单单从程序表面来看，前者在for循环中执行了更多的任务，比如字符串的填充、SQL语句的prepare，以及prepared_statement对象的释放。
2). 在SQLite的官方文档中明确的指出，sqlite3_prepare_v2的执行效率往往要低于sqlite3_step的效率。

3). 当插入的数据量较大时，后者带来的效率提升还是相当可观的

sqlite 编程接口

• 数据库的打开和关闭  

 

    int sqlite3_open(constchar*, sqlite3**);
    int sqlite3_close(sqlite3*);

       
       sqlite3为一个结构，它代指一个数据库连接，之后调用的大部分API函数都需要使用它作为其中一个参数。sqlite3_open的第一个参数为文件名字符串。两个函数都是成功返回SQLITE_OK，失败返回错误码。可以使用sqlite3_errmsg函数获得错误描述:

    constchar*sqlite3_errmsg(sqlite3*); 

 

• 数据库操作-执行SQL语句

    

    int sqlite3_prepare(sqlite3*,constchar*,int, sqlite3_stmt**,

                                                            constchar**);
    int sqlite3_finalize(sqlite3_stmt*);
    int sqlite3_reset(sqlite3_stmt*);

       sqlite3_stmt结构代指一条SQL语句，上述三个函数的功能就是创建、销毁和重置sqlite3_stmt结构。sqlite3_prepare函数的第二个参数为SQL语句字符串，第三个参数为字符串长度。如果传入的SQL语句字符串超出了一条SQL语句，则第五个参数返回SQL语句字符串中指向下一条SQL语句的char指针。SQL语句字符串可以带?号，它是SQL语句中的不确定部分，需要对它另外赋值。

    int sqlite3_bind_text(sqlite3_stmt*,int,constchar*,int n,                                                                        void(*)(void*));

       sqlite3_bind_*系列函数有好多，这里只对sqlite3_bind_text进行一下说明，sqlite3_bind_text的第二个参数为序号（从1开始），第三个参数为字符串值，第四个参数为字符串长度。sqlite3_bind_text的第五个参数为一个函数指针，SQLITE3执行完操作后回调此函数，通常用于释放字符串占用的内存。（这个函数指针参数具体怎么使用，我现在还不清楚）。此参数有两个常数，SQLITE_STATIC告诉sqlite3_bind_text函数字符串为常量，可以放心使用；而SQLITE_TRANSIENT会使得sqlite3_bind_text函数对字符串做一份拷贝。一般使用这两个常量参数来调用sqlite3_bind_text。
       statement准备好了以后，就是操作的执行了。

    int sqlite3_step(sqlite3_stmt*);

       
       它的返回值相对有些特殊。返回SQLITE_BUSY表示暂时无法执行操作，SQLITE_DONE表示操作执行完毕，SQLITE_ROW表示执行完毕并且有返回（执行select语句时）。当返回值为SQLITE_ROW时，我们需要对查询结果进行处理，SQLITE3提供sqlite3_column_*系列函数。

    constunsignedchar*sqlite3_column_text(sqlite3_stmt*,int iCol);

       其中参数iCol为列的序号，从0开始。如果返回值有多行，则可以再次调用sqlite3_step函数，然后由sqlite3_column_*函数取得返回值。


       使用上述这些函数基本上可以完成对SQLITE3数据库的操作了（不过我这里只针对text数据类型做了说明）。当然，sqlite3还有很多其它的接口函数，以后再慢慢摸索吧，现在只是刚开始。

       下面是一段示例代码：

#include<stdio.h>
#include"sqlite3.h"

int main(){
     sqlite3 *db;
    char*zErrMsg =NULL;
    int rv;
    char szSql[128]={ 0 };
     sqlite3_stmt *stmt;

     rv = sqlite3_open("test.db",&db);
    if( rv ){
        fprintf(stderr,"Can't open database: %s\n", sqlite3_errmsg(db));
         sqlite3_close(db);
        return 1;
      }
     else
        fprintf(stderr,"sqlite3_open OK\n");

    //这里查询时，假定数据库中存在表test，并且有一列为COL1(text类型)

    strcpy(szSql,"SELECT COL1 FROM test where COL1=?");
     rv = sqlite3_prepare(db, szSql, 128,&stmt,NULL);
    if( rv != SQLITE_OK ){
        fprintf(stderr,"sqlite3_prepare(%d): %s\n", rv, sqlite3_errmsg(db));
        return-1;
    }
    
    rv = sqlite3_bind_text(stmt, 1, "VALUE1",strlen("VALUE1"), SQLITE_STATIC);
    if( rv != SQLITE_OK ){
        fprintf(stderr,"sqlite3_bind_text(%d): %s\n", rv, sqlite3_errmsg(db));
        return-1;
    }

     rv = sqlite3_step(stmt);
    if((rv != SQLITE_OK)&&(rv != SQLITE_DONE)&&(rv != SQLITE_ROW)){
        fprintf(stderr,"sqlite3_step(%d): %s\n", rv, sqlite3_errmsg(db));
        return-1;
    }

    while( rv == SQLITE_ROW ){
        fprintf(stderr,"result: %s\n", sqlite3_column_text(stmt,0));
         rv = sqlite3_step(stmt);
    }

    rv = sqlite3_finalize(stmt);
    if( rv != SQLITE_OK ){
        fprintf(stderr,"sqlite3_finalize(%d): %s\n", rv, sqlite3_errmsg(db));
        return-1;
    }

    sqlite3_close(db);
    return 0;
}