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()函数，一般是循环操作完成后，销毁。

程序例程：

1. #include <sqlite3.h>

2. #include <string.h>

4. void

5. main()

6. {

7. sqlite3* conn = NULL;

8. int i,nCol;

9. char *name = "tag";

10. char *zErrMsg;

11. const char *pzTail;

12. /* open */

13. int result = sqlite3_open("test.db", &conn);

14. if(result != SQLITE_OK){

15. sqlite3_close(conn);

16. return ;

17. }

19. const char* createTableSQL =

20. "CREATE TABLE TESTTABLE(int_col INT, float_col REAL, string_col TEXT)";

21. /* create prepare object*/

22. if(sqlite3_exec(conn, createTableSQL, NULL, NULL, &zErrMsg) != SQLITE_OK){

23. printf("%s\n", zErrMsg);

24. sqlite3_close(conn);

25. return 1;

26. }

29. sql = "INSERT INTO TESTTABLE(int_col, float_col, string_col) VALUES(?,?,?);";

30. sqlite3_stmt* stmt = NULL;

32. sqlite3_prepare_v2(conn, sql, strlen(sql), &stmt, &pzTail);

34. /* loop cycle */

35. for (int i = 0; i < 10; i++)

36. {

37. nCol = 1;

38. sqlite3_bind_int(stmt, nCol++, i);

39. sqlite3_bind_double(stmt, nCol++, (float)(i*1.0));

40. sqlite3_bind_text(stmt, nCol++, name, strlen(name));

42. sqlite3_step(stmt);

43. sqlite3_reset(stmt);

44. }

46. /*destory stmt */

47. sqlite3_finalize(stmt);

49. return 1;

50. }

  小结：如果只是单条命令，那么 使用sqlite3_exec和sqlite3_stmt效率是一样的，但是在涉及到批量操作时，推荐使用sqlite3_stmt机制。