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

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