SQLite学习笔记（6）

准备查询的优点：

不需要回调接口，编码简单、清晰；关联了提供信息的函数，可以获得列的存储类型、声明类型、模式名称、表名、数据库名；sqlite3_exec( )的接口只是提供列的名称；准备查询提供一种文本外的获取字段、列值的方法，可以以C数据类型获取；准备查询能重新运行，可以重用已经编译的SQL；准备查询支持参数化的SQL语句

检查变化：

可以从sqlite3_changes()获得有多少记录受到影响，提供最后一次执行的更新、插入、删除语句影响的记录数目。不包含原始命令触发器的结果。而最后的字段信息可以通过sqlite3_last_inert_rowid( )获得该值。

获取表查询：

函数：sqlite3_get_table( )返回单独函数调用中一个命令的结果集。封装了sqlite3_exec( )且尽可能的返回数据，获取记录更便捷。

函数声明：

int sqlite3_get_table( sqlite *,/*打开的数据库*/

const char * sql,/*将要执行的sql语句*/

char ***resultp,/* 结果写入该指针指向的char *[ ]*/

int *nrow,/* 结果集中行的数目*/

int * ncolumn,/*结果集中列的数目*/

char ** errmsg /*error message*/

);

函数接收sql语句中返回的所有记录，使用堆上锁声明的内存，使用sqlite3_malloc( )存储在resultp中。必须使用sqlite3_free_table()释放内存，该函数的唯一参数就是resultp指针。

查询准备：

每个查询函数都有自己的行和列的获取方式。相对于准备查询来说，sqlite3_exec()和sqlite3_get_table()提供的功能还是比较少的；值得一提的是sqlite3_exec()对于运行修改数据库的命令的很合适，一个函数调用就可以完成工作。

准备查询使用一组特别函数进行列和行的访问。列值可以使用sqlite3_column_xxx()函数获取，xxx为返回值的数据类型；

准备查询的三个步骤：编译、执行、完成。

sqlite3_prepare_v2()编译查询，由sqlite3_step()分布执行查询，sqlite3_finalizer()完成关闭查询。sqlite3_reset()可以重用编译。

编译：

SQL语句 → VBDE字节码。由sqlite3_prepare_v2()完成。

函数声明：int sqlite3_prepare_v2(

sqlite* db,/*打开的数据库*/

const char *zSQl,/*sql文本*/

intnBYTES,/*zsql字节长度*/

sqlite3_stmt **ppStmt,/*语句句柄*/

const char **pzTail/*指向zSQl未使用的部分*/

);

分配执行该语句的所需的所有资源，将其字节码关联到单个语句句柄，参数ppStmt （是sqlite3_stmt的结构体）来指定。这种数据结构包含了命令的字节码、绑定的参数、B-tree游标、执行上下文、以及sqlite3_step( )在执行过程中查询状态所需的其他数据。sqlite3_prepare_v2()不会对连接或者数据库产生任何影响，也不启动事务或者获取锁。他可以直接通过编译器工作，未执行查询准备。 语句句柄高度依赖于他所被编译的数据库模式 ，数据库模式的更改对于准备查询语句会有失败的影响，此时可能会开启自动重新编译，而当无法重新编译的时候，sqlite3_step（）函数会返回sqlite_schema错误。此时，检查错误需用sqlite3_errmsg() 。

执行：

前提是查询语句准备就绪，利用sqlite3_step（）执行，声明：int sqlite3_step( sqlite3_stmt *pstmt);

sqlite3_step（）直接接受语句句柄与VDBE通信，生成vdbe字节码。

the first time 调用sqlite3_step()d的时候，vdbe会获取一个执行指令的数据库锁。如不能获取锁的时候，且无繁忙处理程序，比如说发邮件服务什么的，就会返回sqlite_busy错误。而有繁忙处理程序的时候，就会调用该程序。

若SQL不返回数据，那么第一次调用就完成工作，返回完成结果的指示性代码；若要返回数据，那么第一次调用将语句定位在第一个记录的B-tree游标上，后续调用的sqlite3_step()将游标定位在结果集的后续记录上。到达末尾前，sqlite3_step()将为结果集的每个记录返回sqlite_row. 如果返回的是sqlite_down()表示游标到达结果集的末尾。

完成与重置：

函数： int sqlite3_finalize(sqlite3_stmt *pStmt) ;

int sqlite3_reset( sqlite3_stmt *pStmt) ;

sqlite3_finalize()关闭语句，释放资源并提交或者回滚任何隐式事务，清除日志文件并释放相关联的锁。

sqlite3_reset()通过重置重复使用语句，保持已编译的sql语句，但是会将目前语句的变化提交到数据库。启动自动提交后，会释放并且锁定清除日志文件。相对于sqlite3_finalize（）来说，他保留了与语句相关的资源，可重复执行，避免了多次对于sqlite3_prepare()的调用。

函数：sqlite3_complete( )是提示符提出的工具。

获取记录：

函数:sqlite3_column_count( ) 和sqlite3_data_count( ) ；

函数声明：

int sqlite3_column_count(sqlite3_stmt *pStmt); 返回语句句柄相关的字段数；

int sqlite3_column_count(sqlite3_stmt *pStmt); sqlite3_step()返回SQLITE_ROW后，该函数返回当前记录的列数，但是要求语句句柄上有活动游标。

获取字段信息：

函数sqlite3_column_name( );

函数声明：const char *sqlite_column_name(

sqlite3_stmt *,/* 语句句柄*/

int iCol,/*字段的次序*/

);

获取当前记录中所有字段的关联的存储类：

函数声明：int sqlite3_column_type(

sqlite3_stmt *,/* 语句句柄*/

int iCol;,/*字段的次序*/

);

该函数返回5个存储类对应的整数值(原生数据类型或者存储类)：

#define SQLITE_INTEGER 1;

#define SQLITE_FLOAT2;

#define SQLITE_TEXT 3;

#define SQLITE_BLOB 4;

#define SQLITE_NULL 5;

可以使用sqlite3_column_decltype( )函数获取字段在表模式定义中声明的数据类型，函数声明：

const char *sqlite3_column_decltype(

sqlite3_stmt *,/* 语句句柄*/

int ;,/*字段的次序*/

)；

获取字段值：

sqlite3_column_xxx()返回字段值。通用形式：

xxx sqlite3_column_xxx(

sqlite3_stmt *,/* 语句句柄*/

int,/*字段的次序*/

);

最常用的sqlite3_column_xxx()函数：

int sqlite3_column_int(sqlite3_stmt * ， int iCol);

double sqlite3_column_double(sqlite3_stmt * ， int iCol);

long long int sqlite3_column_int64(sqlite3_stmt * ， int iCol);

const void *sqlite3_column_blob(sqlite3_stmt * ， int iCol);

const unsigned char *sqlite3_column_text(sqlite3_stmt * ， int iCol);

const void *sqlite3_column_text16(sqlite3_stmt * ， int iCol);

列类型之间可以相互转换，具体的转换规则参照《SQLite权威指南》page187.

其中，对于blob列，复制时要指明其长度。获取其长度后，利用sqlite3_column_blob()复制二进制数据。

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!