SQLite学习手册(实例代码<二>)

3、高效的批量数据插入：

    在给出操做步骤以前先简单说明一下批量插入的概念，以帮助你们阅读其后的示例代码。事实上，批量插入并非什么新的概念，在其它关系型数据库的C接口API中都提供了必定的支持，只是接口的实现方式不一样而已。纵观众多流行的数据库接口，如OCI(Oracle API)、MySQL API和PostgreSQL API等，OCI提供的编程接口最为方便，实现方式也最为高效。SQLite做为一种简单灵活的嵌入式数据库也一样提供了该功能，可是实现方式并不像其余数据库那样方便明显，它只是经过一种隐含的技巧来达到批量插入的目的，其逻辑以下：
    1). 开始一个事物，以保证后面的数据操做语句均在该事物内完成。在SQLite中，若是没有手工开启一个事物，其全部的DML语句都是在自动提交模式下工做的，既每次操做后数据均被自动提交并写入磁盘文件。然而在非自动提交模式下，只有当其所在的事物被手工COMMIT以后才会将修改的数据写入到磁盘中，以前修改的数据都是仅仅驻留在内存中。显而易见，这样的批量写入方式在效率上势必会远远优于多迭代式的单次写入操做。
    2). 基于变量绑定的方式准备待插入的数据，这样能够节省大量的sqlite3_prepare_v2函数调用次数，从而节省了屡次将同一SQL语句编译成SQLite内部识别的字节码所用的时间。事实上，SQLite的官方文档中已经明确指出，在不少时候sqlite3_prepare_v2函数的执行时间要多于sqlite3_step函数的执行时间，所以建议使用者要尽可能避免重复调用sqlite3_prepare_v2函数。在咱们的实现中，若是想避免此类开销，只需将待插入的数据以变量的形式绑定到SQL语句中，这样该SQL语句仅需调用sqlite3_prepare_v2函数编译一次便可，其后的操做只是替换不一样的变量数值。
    3). 在完成全部的数据插入后显式的提交事物。提交后，SQLite会将当前链接自动恢复为自动提交模式。
    
    下面是示例代码的实现步骤：
    1). 建立测试数据表。
    2). 经过执行BEGIN TRANSACTION语句手工开启一个事物。
    3). 准备插入语句及相关的绑定变量。
    4). 迭代式插入数据。
    5). 完成后经过执行COMMIT语句提交事物。
    6). 删除测试表。
    见如下代码及关键性注释：

 1 #include <sqlite3.h>  2 #include <string>  3 #include <stdio.h>  4  5 using namespace std;  6  7 void doTest()  8 {  9 sqlite3* conn = NULL;  10 //1. 打开数据库  11 int result = sqlite3_open("D:/mytest.db",&conn);  12 if (result != SQLITE_OK) {  13 sqlite3_close(conn);  14 return;  15 }  16 const char* createTableSQL =  17 "CREATE TABLE TESTTABLE (int_col INT, float_col REAL, string_col TEXT)";  18 sqlite3_stmt* stmt = NULL;  19 int len = strlen(createTableSQL);  20 //2. 准备建立数据表，若是建立失败，须要用sqlite3_finalize释放sqlite3_stmt对象，以防止内存泄露。  21 if (sqlite3_prepare_v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE_OK) {  22 if (stmt)  23 sqlite3_finalize(stmt);  24 sqlite3_close(conn);  25 return;  26 }  27 //3. 经过sqlite3_step命令执行建立表的语句。对于DDL和DML语句而言，sqlite3_step执行正确的返回值  28 //只有SQLITE_DONE，对于SELECT查询而言，若是有数据返回SQLITE_ROW，当到达结果集末尾时则返回  29  //SQLITE_DONE。  30 if (sqlite3_step(stmt) != SQLITE_DONE) {  31 sqlite3_finalize(stmt);  32 sqlite3_close(conn);  33 return;  34 }  35 //4. 释放建立表语句对象的资源。  36 sqlite3_finalize(stmt);  37 printf("Succeed to create test table now.\n");  38  39 //5. 显式的开启一个事物。  40 sqlite3_stmt* stmt2 = NULL;  41 const char* beginSQL = "BEGIN TRANSACTION";  42 if (sqlite3_prepare_v2(conn,beginSQL,strlen(beginSQL),&stmt2,NULL) != SQLITE_OK) {  43 if (stmt2)  44 sqlite3_finalize(stmt2);  45 sqlite3_close(conn);  46 return;  47 }  48 if (sqlite3_step(stmt2) != SQLITE_DONE) {  49 sqlite3_finalize(stmt2);  50 sqlite3_close(conn);  51 return;  52 }  53 sqlite3_finalize(stmt2);  54  55 //6. 构建基于绑定变量的插入数据。  56 const char* insertSQL = "INSERT INTO TESTTABLE VALUES(?,?,?)";  57 sqlite3_stmt* stmt3 = NULL;  58 if (sqlite3_prepare_v2(conn,insertSQL,strlen(insertSQL),&stmt3,NULL) != SQLITE_OK) {  59 if (stmt3)  60 sqlite3_finalize(stmt3);  61 sqlite3_close(conn);  62 return;  63 }  64 int insertCount = 10;  65 const char* strData = "This is a test.";  66 //7. 基于已有的SQL语句，迭代的绑定不一样的变量数据  67 for (int i = 0; i < insertCount; ++i) {  68 //在绑定时，最左面的变量索引值是1。  69 sqlite3_bind_int(stmt3,1,i);  70 sqlite3_bind_double(stmt3,2,i * 1.0);  71 sqlite3_bind_text(stmt3,3,strData,strlen(strData),SQLITE_TRANSIENT);  72 if (sqlite3_step(stmt3) != SQLITE_DONE) {  73 sqlite3_finalize(stmt3);  74 sqlite3_close(conn);  75 return;  76 }  77 //从新初始化该sqlite3_stmt对象绑定的变量。  78 sqlite3_reset(stmt3);  79 printf("Insert Succeed.\n");  80 }  81 sqlite3_finalize(stmt3);  82  83 //8. 提交以前的事物。  84 const char* commitSQL = "COMMIT";  85 sqlite3_stmt* stmt4 = NULL;  86 if (sqlite3_prepare_v2(conn,commitSQL,strlen(commitSQL),&stmt4,NULL) != SQLITE_OK) {  87 if (stmt4)  88 sqlite3_finalize(stmt4);  89 sqlite3_close(conn);  90 return;  91 }  92 if (sqlite3_step(stmt4) != SQLITE_DONE) {  93 sqlite3_finalize(stmt4);  94 sqlite3_close(conn);  95 return;  96 }  97 sqlite3_finalize(stmt4);  98  99 //9. 为了方便下一次测试运行，咱们这里须要删除该函数建立的数据表，不然在下次运行时将没法 100 //建立该表，由于它已经存在。 101 const char* dropSQL = "DROP TABLE TESTTABLE"; 102 sqlite3_stmt* stmt5 = NULL; 103 if (sqlite3_prepare_v2(conn,dropSQL,strlen(dropSQL),&stmt5,NULL) != SQLITE_OK) { 104 if (stmt5) 105 sqlite3_finalize(stmt5); 106 sqlite3_close(conn); 107 return; 108 } 109 if (sqlite3_step(stmt5) == SQLITE_DONE) { 110 printf("The test table has been dropped.\n"); 111 } 112 sqlite3_finalize(stmt5); 113 sqlite3_close(conn); 114 } 115 116 int main() 117 { 118 doTest(); 119 return 0; 120 } 121 //输出结果以下： 122 //Succeed to create test table now. 123 //Insert Succeed. 124 //Insert Succeed. 125 //Insert Succeed. 126 //Insert Succeed. 127 //Insert Succeed. 128 //Insert Succeed. 129 //Insert Succeed. 130 //Insert Succeed. 131 //Insert Succeed. 132 //Insert Succeed. 133 //The test table has been dropped.

    该结果和上一个例子(普通数据插入)的结果彻底相同，只是在执行效率上明显优于前者。

4、数据查询：

    数据查询是每一个关系型数据库都会提供的最基本功能，下面的代码示例将给出如何经过SQLite API获取数据。
    1). 建立测试数据表。
    2). 插入一条测试数据到该数据表以便于后面的查询。
    3). 执行SELECT语句检索数据。
    4). 删除测试表。
    见如下示例代码和关键性注释：

 1 #include <sqlite3.h>  2 #include <string>  3 #include <stdio.h>  4  5 using namespace std;  6  7 void doTest()  8 {  9 sqlite3* conn = NULL;  10 //1. 打开数据库  11 int result = sqlite3_open("D:/mytest.db",&conn);  12 if (result != SQLITE_OK) {  13 sqlite3_close(conn);  14 return;  15 }  16 const char* createTableSQL =  17 "CREATE TABLE TESTTABLE (int_col INT, float_col REAL, string_col TEXT)";  18 sqlite3_stmt* stmt = NULL;  19 int len = strlen(createTableSQL);  20 //2. 准备建立数据表，若是建立失败，须要用sqlite3_finalize释放sqlite3_stmt对象，以防止内存泄露。  21 if (sqlite3_prepare_v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE_OK) {  22 if (stmt)  23 sqlite3_finalize(stmt);  24 sqlite3_close(conn);  25 return;  26 }  27 //3. 经过sqlite3_step命令执行建立表的语句。对于DDL和DML语句而言，sqlite3_step执行正确的返回值  28  //只有SQLITE_DONE，对于SELECT查询而言，若是有数据返回SQLITE_ROW，当到达结果集末尾时则返回  29 //SQLITE_DONE。  30 if (sqlite3_step(stmt) != SQLITE_DONE) {  31 sqlite3_finalize(stmt);  32 sqlite3_close(conn);  33 return;  34 }  35 //4. 释放建立表语句对象的资源。  36 sqlite3_finalize(stmt);  37 printf("Succeed to create test table now.\n");  38  39 //5. 为后面的查询操做插入测试数据。  40 sqlite3_stmt* stmt2 = NULL;  41 const char* insertSQL = "INSERT INTO TESTTABLE VALUES(20,21.0,'this is a test.')";  42 if (sqlite3_prepare_v2(conn,insertSQL,strlen(insertSQL),&stmt2,NULL) != SQLITE_OK) {  43 if (stmt2)  44 sqlite3_finalize(stmt2);  45 sqlite3_close(conn);  46 return;  47 }  48 if (sqlite3_step(stmt2) != SQLITE_DONE) {  49 sqlite3_finalize(stmt2);  50 sqlite3_close(conn);  51 return;  52 }  53 printf("Succeed to insert test data.\n");  54 sqlite3_finalize(stmt2);  55  56 //6. 执行SELECT语句查询数据。  57 const char* selectSQL = "SELECT * FROM TESTTABLE";  58 sqlite3_stmt* stmt3 = NULL;  59 if (sqlite3_prepare_v2(conn,selectSQL,strlen(selectSQL),&stmt3,NULL) != SQLITE_OK) {  60 if (stmt3)  61 sqlite3_finalize(stmt3);  62 sqlite3_close(conn);  63 return;  64 }  65 int fieldCount = sqlite3_column_count(stmt3);  66 do {  67 int r = sqlite3_step(stmt3);  68 if (r == SQLITE_ROW) {  69 for (int i = 0; i < fieldCount; ++i) {  70 //这里须要先判断当前记录当前字段的类型，再根据返回的类型使用不一样的API函数  71 //获取实际的数据值。  72 int vtype = sqlite3_column_type(stmt3,i);  73 if (vtype == SQLITE_INTEGER) {  74 int v = sqlite3_column_int(stmt3,i);  75 printf("The INTEGER value is %d.\n",v);  76 } else if (vtype == SQLITE_FLOAT) {  77 double v = sqlite3_column_double(stmt3,i);  78 printf("The DOUBLE value is %f.\n",v);  79 } else if (vtype == SQLITE_TEXT) {  80 const char* v = (const char*)sqlite3_column_text(stmt3,i);  81 printf("The TEXT value is %s.\n",v);  82 } else if (vtype == SQLITE_NULL) {  83 printf("This value is NULL.\n");  84 }  85 }  86 } else if (r == SQLITE_DONE) {  87 printf("Select Finished.\n");  88 break;  89 } else {  90 printf("Failed to SELECT.\n");  91 sqlite3_finalize(stmt3);  92 sqlite3_close(conn);  93 return;  94 }  95 } while (true);  96 sqlite3_finalize(stmt3);  97  98 //7. 为了方便下一次测试运行，咱们这里须要删除该函数建立的数据表，不然在下次运行时将没法  99  //建立该表，由于它已经存在。 100 const char* dropSQL = "DROP TABLE TESTTABLE"; 101 sqlite3_stmt* stmt4 = NULL; 102 if (sqlite3_prepare_v2(conn,dropSQL,strlen(dropSQL),&stmt4,NULL) != SQLITE_OK) { 103 if (stmt4) 104 sqlite3_finalize(stmt4); 105 sqlite3_close(conn); 106 return; 107 } 108 if (sqlite3_step(stmt4) == SQLITE_DONE) { 109 printf("The test table has been dropped.\n"); 110 } 111 sqlite3_finalize(stmt4); 112 sqlite3_close(conn); 113 } 114 115 int main() 116 { 117 doTest(); 118 return 0; 119 } 120 //输出结果以下： 121 //Succeed to create test table now. 122 //Succeed to insert test data. 123 //The INTEGER value is 20. 124 //The DOUBLE value is 21.000000. 125 //The TEXT value is this is a test.. 126 //Select Finished. 127 //The test table has been dropped.