sqlite3：深入理解sqlite3_stmt 机制

Posted 2022-02-03 hyhy904

  我们在使用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()，可以是一次，也可以是循环执行。

（4）重置（reset）sqlite3_stmt对象，使用sqlite3_reset(), 然后回退到步骤2，重新赋值。

（5）销毁sqlite3_stmt对象，使用sqlite3_finalize()函数，一般是循环操作完成后，销毁。

程序例程：

#include <sqlite3.h>
#include <string.h>

void
main(http://www.my516.com)

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机制。
---------------------