SQLite應用之實例代碼

目錄

一、獲取表的Schema信息

二、常規數據插入

三、高效的批量數據插入

四、數據查詢

一、獲取表的Schema信息
    1). 動態創建表。
    2). 根據sqlite3提供的API，獲取表字段的信息，如字段數量以及每個字段的類型。
    3). 刪除該表。
    見以下代碼及關鍵性注釋：

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

using namespace std;

void doTest()
{
    sqlite3* conn = NULL;
    //1. 打開數據庫
    int result = sqlite3_open("D:/mytest.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)";
    sqlite3_stmt* stmt = NULL;
    int len = strlen(createTableSQL);
    //2. 准備創建數據表，如果創建失敗，需要用sqlite3_finalize釋放sqlite3_stmt對象，以防止內存泄露。
    if (sqlite3_prepare_v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE_OK) {
        if (stmt)
            sqlite3_finalize(stmt);
        sqlite3_close(conn);
        return;
    }
    //3. 通過sqlite3_step命令執行創建表的語句。對於DDL和DML語句而言，sqlite3_step執行正確的返回值只有SQLITE_DONE。
    //對於SELECT查詢而言，如果有數據返回SQLITE_ROW，當到達結果集末尾時則返回SQLITE_DONE。
    if (sqlite3_step(stmt) != SQLITE_DONE) {
        sqlite3_finalize(stmt);
        sqlite3_close(conn);
        return;
    }
    //4. 釋放創建表語句對象的資源。
    sqlite3_finalize(stmt);
    printf("Succeed to create test table now.\n");
    //5. 構造查詢表數據的sqlite3_stmt對象。
    const char* selectSQL = "SELECT * FROM TESTTABLE WHERE 1 = 0";
    sqlite3_stmt* stmt2 = NULL;
    if (sqlite3_prepare_v2(conn,selectSQL,strlen(selectSQL),&stmt2,NULL) != SQLITE_OK) {
        if (stmt2)
            sqlite3_finalize(stmt2);
        sqlite3_close(conn);
        return;
    }
    //6. 根據select語句的對象，獲取結果集中的字段數量。
    int fieldCount = sqlite3_column_count(stmt2);
    printf("The column count is %d.\n",fieldCount);
    //7. 遍歷結果集中每個字段meta信息，並獲取其聲明時的類型。    
    for (int i = 0; i < fieldCount; ++i) {
        //由於此時Table中並不存在數據，再有就是SQLite中的數據類型本身是動態的，所以在沒有數據時無法通過sqlite3_column_type函數獲取，此時sqlite3_column_type只會返回SQLITE_NULL，
        //直到有數據時才能返回具體的類型，因此這里使用了sqlite3_column_decltype函數來獲取表聲明時給出的聲明類型。
        string stype = sqlite3_column_decltype(stmt2,i);
        stype = strlwr((char*)stype.c_str());
        //數據類型以決定字段親緣性的規則解析
        if (stype.find("int") != string::npos) {
            printf("The type of %dth column is INTEGER.\n",i);
        } else if (stype.find("char") != string::npos
            || stype.find("text") != string::npos) {
            printf("The type of %dth column is TEXT.\n",i);
        } else if (stype.find("real") != string::npos 
            || stype.find("floa") != string::npos 
            || stype.find("doub") != string::npos ) {
            printf("The type of %dth column is DOUBLE.\n",i);
        }
    }
    sqlite3_finalize(stmt2);
    //8. 為了方便下一次測試運行，我們這里需要刪除該函數創建的數據表，否則在下次運行時將無法創建該表，因為它已經存在。
    const char* dropSQL = "DROP TABLE TESTTABLE";
    sqlite3_stmt* stmt3 = NULL;
    if (sqlite3_prepare_v2(conn,dropSQL,strlen(dropSQL),&stmt3,NULL) != SQLITE_OK) {
        if (stmt3)
            sqlite3_finalize(stmt3);
        sqlite3_close(conn);
        return;
    }
    if (sqlite3_step(stmt3) == SQLITE_DONE) {
        printf("The test table has been dropped.\n");
    }
    sqlite3_finalize(stmt3);
    sqlite3_close(conn);
}

int main()
{
    doTest();
    return 0;
}
//輸出結果為：
//Succeed to create test table now.
//The column count is 3.
//The type of 0th column is INTEGER.
//The type of 1th column is DOUBLE.
//The type of 2th column is TEXT.
//The test table has been dropped.

二、常規數據插入
    1). 創建測試數據表。
    2). 通過INSERT語句插入測試數據。
    3). 刪除測試表。
    見以下代碼及關鍵性注釋：

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

using namespace std;

void doTest()
{
    sqlite3* conn = NULL;
    //1. 打開數據庫
    int result = sqlite3_open("D:/mytest.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)";
    sqlite3_stmt* stmt = NULL;
    int len = strlen(createTableSQL);
    //2. 准備創建數據表，如果創建失敗，需要用sqlite3_finalize釋放sqlite3_stmt對象，以防止內存泄露。
    if (sqlite3_prepare_v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE_OK) {
        if (stmt)
            sqlite3_finalize(stmt);
        sqlite3_close(conn);
        return;
    }
    //3. 通過sqlite3_step命令執行創建表的語句。對於DDL和DML語句而言，sqlite3_step執行正確的返回值只有SQLITE_DONE。
    //對於SELECT查詢而言，如果有數據返回SQLITE_ROW，當到達結果集末尾時則返回SQLITE_DONE。
    if (sqlite3_step(stmt) != SQLITE_DONE) {
        sqlite3_finalize(stmt);
        sqlite3_close(conn);
        return;
    }
    //4. 釋放創建表語句對象的資源。
    sqlite3_finalize(stmt);
    printf("Succeed to create test table now.\n");

    int insertCount = 10;
    //5. 構建插入數據的sqlite3_stmt對象。
    const char* insertSQL = "INSERT INTO TESTTABLE VALUES(%d,%f,'%s')";
    const char* testString = "this is a test.";
    char sql[1024];
    sqlite3_stmt* stmt2 = NULL;
    for (int i = 0; i < insertCount; ++i) {
        sprintf(sql,insertSQL,i,i * 1.0,testString);
        if (sqlite3_prepare_v2(conn,sql,strlen(sql),&stmt2,NULL) != SQLITE_OK) {
            if (stmt2)
                sqlite3_finalize(stmt2);
            sqlite3_close(conn);
            return;
        }
        if (sqlite3_step(stmt2) != SQLITE_DONE) {
            sqlite3_finalize(stmt2);
            sqlite3_close(conn);
            return;
        }
        printf("Insert Succeed.\n");
    }
    sqlite3_finalize(stmt2);
    //6. 為了方便下一次測試運行，我們這里需要刪除該函數創建的數據表，否則在下次運行時將無法創建該表，因為它已經存在。
    const char* dropSQL = "DROP TABLE TESTTABLE";
    sqlite3_stmt* stmt3 = NULL;
    if (sqlite3_prepare_v2(conn,dropSQL,strlen(dropSQL),&stmt3,NULL) != SQLITE_OK) {
        if (stmt3)
            sqlite3_finalize(stmt3);
        sqlite3_close(conn);
        return;
    }
    if (sqlite3_step(stmt3) == SQLITE_DONE) {
        printf("The test table has been dropped.\n");
    }
    sqlite3_finalize(stmt3);
    sqlite3_close(conn);
}

int main()
{
    doTest();
    return 0;
}
//輸出結果如下：
//Succeed to create test table now.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//The test table has been dropped.

三、高效的批量數據插入
    在給出操作步驟之前先簡單說明一下批量插入的概念，以幫助大家閱讀其后的示例代碼。事實上，批量插入並不是什么新的概念，在其它關系型數據庫的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). 刪除測試表。
    見以下代碼及關鍵性注釋：

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

using namespace std;

void doTest()
{
    sqlite3* conn = NULL;
    //1. 打開數據庫
    int result = sqlite3_open("D:/mytest.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)";
    sqlite3_stmt* stmt = NULL;
    int len = strlen(createTableSQL);
    //2. 准備創建數據表，如果創建失敗，需要用sqlite3_finalize釋放sqlite3_stmt對象，以防止內存泄露。
    if (sqlite3_prepare_v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE_OK) {
        if (stmt)
            sqlite3_finalize(stmt);
        sqlite3_close(conn);
        return;
    }
    //3. 通過sqlite3_step命令執行創建表的語句。對於DDL和DML語句而言，sqlite3_step執行正確的返回值只有SQLITE_DONE。
    //對於SELECT查詢而言，如果有數據返回SQLITE_ROW，當到達結果集末尾時則返回SQLITE_DONE。
    if (sqlite3_step(stmt) != SQLITE_DONE) {
        sqlite3_finalize(stmt);
        sqlite3_close(conn);
        return;
    }
    //4. 釋放創建表語句對象的資源。
    sqlite3_finalize(stmt);
    printf("Succeed to create test table now.\n");

    //5. 顯式的開啟一個事物。
    sqlite3_stmt* stmt2 = NULL;
    const char* beginSQL = "BEGIN TRANSACTION";
    if (sqlite3_prepare_v2(conn,beginSQL,strlen(beginSQL),&stmt2,NULL) != SQLITE_OK) {
        if (stmt2)
            sqlite3_finalize(stmt2);
        sqlite3_close(conn);
        return;
    }
    if (sqlite3_step(stmt2) != SQLITE_DONE) {
        sqlite3_finalize(stmt2);
        sqlite3_close(conn);
        return;
    }
    sqlite3_finalize(stmt2);

    //6. 構建基於綁定變量的插入數據。
    const char* insertSQL = "INSERT INTO TESTTABLE VALUES(?,?,?)";
    sqlite3_stmt* stmt3 = NULL;
    if (sqlite3_prepare_v2(conn,insertSQL,strlen(insertSQL),&stmt3,NULL) != SQLITE_OK) {
        if (stmt3)
            sqlite3_finalize(stmt3);
        sqlite3_close(conn);
        return;
    }
    int insertCount = 10;
    const char* strData = "This is a test.";
    //7. 基於已有的SQL語句，迭代的綁定不同的變量數據
    for (int i = 0; i < insertCount; ++i) {
        //在綁定時，最左面的變量索引值是1。
        sqlite3_bind_int(stmt3,1,i);
        sqlite3_bind_double(stmt3,2,i * 1.0);
        sqlite3_bind_text(stmt3,3,strData,strlen(strData),SQLITE_TRANSIENT);
        if (sqlite3_step(stmt3) != SQLITE_DONE) {
            sqlite3_finalize(stmt3);
            sqlite3_close(conn);
            return;
        }
        //重新初始化該sqlite3_stmt對象綁定的變量。
        sqlite3_reset(stmt3);
        printf("Insert Succeed.\n");
    }
    sqlite3_finalize(stmt3);

    //8. 提交之前的事物。
    const char* commitSQL = "COMMIT";
    sqlite3_stmt* stmt4 = NULL;
    if (sqlite3_prepare_v2(conn,commitSQL,strlen(commitSQL),&stmt4,NULL) != SQLITE_OK) {
        if (stmt4)
            sqlite3_finalize(stmt4);
        sqlite3_close(conn);
        return;
    }
    if (sqlite3_step(stmt4) != SQLITE_DONE) {
        sqlite3_finalize(stmt4);
        sqlite3_close(conn);
        return;
    }
    sqlite3_finalize(stmt4);

    //9. 為了方便下一次測試運行，我們這里需要刪除該函數創建的數據表，否則在下次運行時將無法創建該表，因為它已經存在。
    const char* dropSQL = "DROP TABLE TESTTABLE";
    sqlite3_stmt* stmt5 = NULL;
    if (sqlite3_prepare_v2(conn,dropSQL,strlen(dropSQL),&stmt5,NULL) != SQLITE_OK) {
        if (stmt5)
            sqlite3_finalize(stmt5);
        sqlite3_close(conn);
        return;
    }
    if (sqlite3_step(stmt5) == SQLITE_DONE) {
        printf("The test table has been dropped.\n");
    }
    sqlite3_finalize(stmt5);
    sqlite3_close(conn);
}

int main()
{
    doTest();
    return 0;
}
//輸出結果如下：
//Succeed to create test table now.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//Insert Succeed.
//The test table has been dropped.

    該結果和上一個例子(普通數據插入)的結果完全相同，只是在執行效率上明顯優於前者。
四、數據查詢
    數據查詢是每個關系型數據庫都會提供的最基本功能，下面的代碼示例將給出如何通過SQLite API獲取數據。
    1). 創建測試數據表。
    2). 插入一條測試數據到該數據表以便於后面的查詢。
    3). 執行SELECT語句檢索數據。
    4). 刪除測試表。
    見以下示例代碼和關鍵性注釋：

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

using namespace std;

void doTest()
{
    sqlite3* conn = NULL;
    //1. 打開數據庫
    int result = sqlite3_open("D:/mytest.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)";
    sqlite3_stmt* stmt = NULL;
    int len = strlen(createTableSQL);
    //2. 准備創建數據表，如果創建失敗，需要用sqlite3_finalize釋放sqlite3_stmt對象，以防止內存泄露。
    if (sqlite3_prepare_v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE_OK) {
        if (stmt)
            sqlite3_finalize(stmt);
        sqlite3_close(conn);
        return;
    }
    //3. 通過sqlite3_step命令執行創建表的語句。對於DDL和DML語句而言，sqlite3_step執行正確的返回值只有SQLITE_DONE。
    //對於SELECT查詢而言，如果有數據返回SQLITE_ROW，當到達結果集末尾時則返回SQLITE_DONE。
    if (sqlite3_step(stmt) != SQLITE_DONE) {
        sqlite3_finalize(stmt);
        sqlite3_close(conn);
        return;
    }
    //4. 釋放創建表語句對象的資源。
    sqlite3_finalize(stmt);
    printf("Succeed to create test table now.\n");

    //5. 為后面的查詢操作插入測試數據。
    sqlite3_stmt* stmt2 = NULL;
    const char* insertSQL = "INSERT INTO TESTTABLE VALUES(20,21.0,'this is a test.')";
    if (sqlite3_prepare_v2(conn,insertSQL,strlen(insertSQL),&stmt2,NULL) != SQLITE_OK) {
        if (stmt2)
            sqlite3_finalize(stmt2);
        sqlite3_close(conn);
        return;
    }
    if (sqlite3_step(stmt2) != SQLITE_DONE) {
        sqlite3_finalize(stmt2);
        sqlite3_close(conn);
        return;
    }
    printf("Succeed to insert test data.\n");
    sqlite3_finalize(stmt2);

    //6. 執行SELECT語句查詢數據。
    const char* selectSQL = "SELECT * FROM TESTTABLE";
    sqlite3_stmt* stmt3 = NULL;
    if (sqlite3_prepare_v2(conn,selectSQL,strlen(selectSQL),&stmt3,NULL) != SQLITE_OK) {
        if (stmt3)
            sqlite3_finalize(stmt3);
        sqlite3_close(conn);
        return;
    }
    int fieldCount = sqlite3_column_count(stmt3);
    do {
        int r = sqlite3_step(stmt3);
        if (r == SQLITE_ROW) {
            for (int i = 0; i < fieldCount; ++i) {
                //這里需要先判斷當前記錄當前字段的類型，再根據返回的類型使用不同的API函數
                //獲取實際的數據值。
                int vtype = sqlite3_column_type(stmt3,i);
                if (vtype == SQLITE_INTEGER) {
                    int v = sqlite3_column_int(stmt3,i);
                    printf("The INTEGER value is %d.\n",v);
                } else if (vtype == SQLITE_FLOAT) {
                    double v = sqlite3_column_double(stmt3,i);
                    printf("The DOUBLE value is %f.\n",v);
                } else if (vtype == SQLITE_TEXT) {
                    const char* v = (const char*)sqlite3_column_text(stmt3,i);
                    printf("The TEXT value is %s.\n",v);
                } else if (vtype == SQLITE_NULL) {
                    printf("This value is NULL.\n");
                }
            }
        } else if (r == SQLITE_DONE) {
            printf("Select Finished.\n");
            break;
        } else {
            printf("Failed to SELECT.\n");
            sqlite3_finalize(stmt3);
            sqlite3_close(conn);
            return;
        }
    } while (true);
    sqlite3_finalize(stmt3);

    //7. 為了方便下一次測試運行，我們這里需要刪除該函數創建的數據表，否則在下次運行時將無法創建該表，因為它已經存在。
    const char* dropSQL = "DROP TABLE TESTTABLE";
    sqlite3_stmt* stmt4 = NULL;
    if (sqlite3_prepare_v2(conn,dropSQL,strlen(dropSQL),&stmt4,NULL) != SQLITE_OK) {
        if (stmt4)
            sqlite3_finalize(stmt4);
        sqlite3_close(conn);
        return;
    }
    if (sqlite3_step(stmt4) == SQLITE_DONE) {
        printf("The test table has been dropped.\n");
    }
    sqlite3_finalize(stmt4);
    sqlite3_close(conn);
}

int main()
{
    doTest();
    return 0;
}
//輸出結果如下：
//Succeed to create test table now.
//Succeed to insert test data.
//The INTEGER value is 20.
//The DOUBLE value is 21.000000.
//The TEXT value is this is a test..
//Select Finished.
//The test table has been dropped.