sqlite3:深入理解sqlite3_stmt 机制
我们在使用sqlite3的过程中,涉及到批量操作时(批量插入、批量读。。。),总会遇到 sqlite3_stmt这个数据类型,按照官方解释说法是这样的:sqlite3_stmt是C接口中“准备语句对象”,该对象是一条SQL语句的实例,而且该语句已经编译成二进制形式,可以直接进行计算。
它并不是我们所熟悉的sql语句,而是一个已经把sql语句解析了的,用sqlite3自己标记记录的内部数据结构,可以被直接执行的语句,所以,如果结合变量,采用sqlite3_stmt结构,会使得批量操作执行的效率大大提高,我们可以进一步这么理解:
sqlite3的C接口函数,最重要函数之一的是 sqlite3_exec,也就是执行sql语句函数,该函数运行需要配套一个 sql语句字符串和相应的回调函数,当执行sqlite3_exec时,数据库先把sql语句字符串(就是普通的字符串)进行解析,然后再编译,然后再执行,基本上需要这3个步骤,要知道,解析和编译都是很耗费算力的,效率上势必 不会太好。如果引入sqlite3_stmt数据结构后,也是要配合一条普通的sql语句的,基本步骤也是解析、编译、执行,貌似没有太大的优势,但是sqlite3_stmt是可以结合 变量使用的,也就是可以通过 变量实现 相同操作的循环,这个时候,sqlite3_stmt结构通过sqlite3_prepare_v2函数,可以实现对sql语句(模板)的解析和编译,生成了可以被执行的 sql语句实例,那么后面我们只需要通过sqlite3_bind_xx函数去绑定赋值变量,通过sqlite3_step进行执行,相比较使用sqlite3_exec函数,sql语句的解析和编译只执行了一次,而sqlite3_step执行多次,整体的效率势必大大提升。
我们在进行循环操作时,与sqlit3_stmt配套的功能函数如下:
(1)创建sqlite3_stmt对象,使用 sqlite3_prepare_v2();
(2)绑定参数值到sqlite3_stmt独享,使用sqlite3_bind_*();
(3)运行sql语句,使用sqlite3_step(http://www.my516.com),可以是一次,也可以是循环执行。
(4)重置(reset)sqlite3_stmt对象,使用sqlite3_reset(), 然后回退到步骤2,重新赋值。
(5)销毁sqlite3_stmt对象,使用sqlite3_finalize()函数,一般是循环操作完成后,销毁。
程序例程:
#include <sqlite3.h>
#include <string.h>
void
main()
{
sqlite3* conn = NULL;
int i,nCol;
char *name = "tag";
char *zErrMsg;
const char *pzTail;
/* open */
int result = sqlite3_open("test.db", &conn);
if(result != SQLITE_OK){
sqlite3_close(conn);
return ;
}
const char* createTableSQL =
"CREATE TABLE TESTTABLE(int_col INT, float_col REAL, string_col TEXT)";
/* create prepare object*/
if(sqlite3_exec(conn, createTableSQL, NULL, NULL, &zErrMsg) != SQLITE_OK){
printf("%s\n", zErrMsg);
sqlite3_close(conn);
return 1;
}
sql = "INSERT INTO TESTTABLE(int_col, float_col, string_col) VALUES(?,?,?);";
sqlite3_stmt* stmt = NULL;
sqlite3_prepare_v2(conn, sql, strlen(sql), &stmt, &pzTail);
/* loop cycle */
for (int i = 0; i < 10; i++)
{
nCol = 1;
sqlite3_bind_int(stmt, nCol++, i);
sqlite3_bind_double(stmt, nCol++, (float)(i*1.0));
sqlite3_bind_text(stmt, nCol++, name, strlen(name));
sqlite3_step(stmt);
sqlite3_reset(stmt);
}
/*destory stmt */
sqlite3_finalize(stmt);
return 1;
}
小结:如果只是单条命令,那么 使用sqlite3_exec和sqlite3_stmt效率是一样的,但是在涉及到批量操作时,推荐使用sqlite3_stmt机制。
---------------------
=