SQLite,作為一款嵌入式關係型資料庫管理系統,一直以其輕量級、零配置以及跨平臺等特性而備受青睞。不同於傳統的資料庫系統,SQLite是一個庫,直接與應用程式一同編譯和連結,無需單獨的資料庫伺服器程式,實現了資料庫的零配置管理。這種設計理念使得SQLite成為許多嵌入式系統、移動應用和小型專案中的首選資料庫引擎。
SQLite的特點包括:
- 嵌入式資料庫引擎: SQLite 是一個嵌入式資料庫引擎,意味著它是一個庫,與應用程式一同編譯和連結,而不是作為獨立的程式執行。
- 零配置: 無需配置或管理。SQLite 不需要一個獨立的資料庫伺服器程式,所有的操作都是直接在儲存在檔案中的資料庫上執行。
- 輕量級: SQLite 是一個輕量級的資料庫,相對於一些其他資料庫管理系統來說,它的記憶體佔用和資源消耗相對較小。
- 支援 SQL: SQLite 支援大部分標準的 SQL 語法,並提供了事務支援,包括隔離級別和回滾。
- 跨平臺: SQLite 可以在各種作業系統上執行,包括 Windows、Linux、macOS 和其他嵌入式系統。
- 自給自足: SQLite 資料庫是一個單一的磁碟檔案,整個資料庫被儲存在一個檔案中,這使得備份、複製或傳輸資料庫變得非常容易。
- 開源: SQLite 是一個開源專案,採用公共領域授權(Public Domain License),可以在商業和非商業專案中免費使用。
SQLite 資料庫以其獨特的自給自足特性脫穎而出,整個資料庫被儲存在一個單一的磁碟檔案中,使得備份、複製或傳輸資料庫變得異常簡單。而作為一款開源專案,SQLite採用了公共領域授權,可以在商業和非商業專案中免費使用。
由於該資料庫的小巧和簡潔所以在使用上也非常容易,當讀者下載好附件以後會看到如下圖所示的檔案;
使用時只需要將sqlite3.h
與sqlite3.c
檔案匯入到專案中並使用#include "sqlite3.h"
即可,無需做其他配置,圖中的sqlite3.dll
是動態庫,sqlite3.exe
則是一個命令列版本的資料庫可在測試時使用它。
開啟與關閉庫
sqlite3_open
用於開啟或建立一個 SQLite 資料庫檔案。該函式的原型如下:
int sqlite3_open(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb /* OUT: SQLite db handle */
);
filename
: 要開啟或建立的 SQLite 資料庫檔案的路徑。如果檔案不存在,將會建立一個新的資料庫檔案。ppDb
: 用於儲存 SQLite 資料庫控制程式碼(handle)的指標。SQLite 資料庫控制程式碼是與一個開啟的資料庫關聯的結構,它在後續的 SQLite 操作中用作標識。
該函式返回一個整數值,代表函式的執行狀態。如果函式成功執行,返回 SQLITE_OK
。如果有錯誤發生,返回一個表示錯誤程式碼的整數值。可以透過 sqlite3_errmsg
函式獲取更詳細的錯誤資訊。
sqlite3_close
用於關閉資料庫連線的函式。其原型如下:
int sqlite3_close(sqlite3*);
sqlite3
: 要關閉的 SQLite 資料庫連線的控制程式碼。
該函式返回一個整數值,用於表示函式的執行狀態。如果函式成功執行,返回 SQLITE_OK
。如果有錯誤發生,返回一個表示錯誤程式碼的整數值。
使用 sqlite3_close
函式可以釋放與資料庫連線相關的資源,並確保資料庫檔案被正確關閉。在關閉資料庫連線之前,應該確保已經完成了所有需要執行的 SQL 語句,並在需要的情況下檢查執行結果。
// 開啟資料庫並返回控制程式碼
sqlite3* open_database(std::string database_name)
{
int ref =-1;
sqlite3 *db = 0;
ref = sqlite3_open(database_name.c_str(), &db);
if (ref == SQLITE_OK)
return db;
return false;
}
// 關閉資料庫
bool close_database(sqlite3 *db)
{
int ref = sqlite3_close(db);
if (ref == SQLITE_OK)
return true;
return false;
}
執行查詢語句
sqlite3_exec
用於執行 SQL 語句的高階介面函式。它的原型如下:
int sqlite3_exec(
sqlite3* db, /* Database handle */
const char* sql, /* SQL statement, UTF-8 encoded */
int (*callback)( /* Callback function */
void*, /* Callback parameter */
int, /* Number of columns in the result set */
char**, /* Array of column values */
char** /* Array of column names */
),
void* callback_param, /* 1st argument to callback function */
char** errmsg /* Error msg written here */
);
db
: SQLite 資料庫連線的控制程式碼。sql
: 要執行的 SQL 語句,以 UTF-8 編碼。callback
: 回撥函式,用於處理查詢結果的每一行資料。callback_param
: 傳遞給回撥函式的引數。errmsg
: 用於儲存錯誤訊息的指標。
sqlite3_exec
函式執行一個或多個 SQL 語句,並對每一條語句的執行結果呼叫指定的回撥函式。回撥函式的原型如下:
int callback(
void* callback_param, /* 引數,由 sqlite3_exec 傳遞給回撥函式 */
int num_columns, /* 結果集中的列數 */
char** column_values, /* 指向結果集中當前行的列值的陣列 */
char** column_names /* 指向結果集中列名的陣列 */
);
callback_param
: 回撥函式的引數,由sqlite3_exec
傳遞給回撥函式。num_columns
: 結果集中的列數。column_values
: 指向結果集中當前行的列值的陣列。column_names
: 指向結果集中列名的陣列。
回撥函式返回一個整數,用於指示是否繼續執行後續的 SQL 語句。如果回撥函式返回非零值,sqlite3_exec
將停止執行 SQL,並立即返回。
sqlite3_prepare_v2
用於準備 SQL 語句的介面函式。它的原型如下:
int sqlite3_prepare_v2(
sqlite3* db, /* Database handle */
const char* sql, /* SQL statement, UTF-8 encoded */
int sql_len, /* Length of SQL statement in bytes, or -1 for zero-terminated */
sqlite3_stmt** stmt, /* OUT: Statement handle */
const char** tail /* OUT: Pointer to unused portion of SQL statement */
);
db
: SQLite 資料庫連線的控制程式碼。sql
: 要準備的 SQL 語句,以 UTF-8 編碼。sql_len
: SQL 語句的長度,如果為 -1,則表示 SQL 語句以 null 結尾。stmt
: 用於儲存準備好的語句控制程式碼的指標。tail
: 用於儲存未使用的 SQL 語句的指標。
sqlite3_prepare_v2
函式用於將 SQL 語句編譯成一個 SQLite 語句物件(prepared statement)。這個物件可以被多次執行,每次執行時可以繫結不同的引數。stmt
引數將用於儲存編譯後的語句的控制程式碼,以供後續的操作。
sqlite3_step
執行預編譯 SQL 語句的介面函式。它的原型如下:
int sqlite3_step(sqlite3_stmt*);
sqlite3_stmt*
: 由sqlite3_prepare_v2
預編譯的 SQL 語句的控制程式碼。
sqlite3_step
函式用於執行由 sqlite3_prepare_v2
預編譯的 SQL 語句。在執行過程中,可以透過不斷呼叫 sqlite3_step
來逐行獲取查詢結果,直到結果集結束。對於非查詢語句(如 INSERT
、UPDATE
、DELETE
),sqlite3_step
函式執行一次即可完成操作。
該函式的返回值表示執行的結果,可能的返回值包括:
SQLITE_ROW
: 成功獲取一行資料。SQLITE_DONE
: 執行完成,沒有更多的資料可用(用於非查詢語句)。- 其他錯誤碼,表示執行過程中出現了錯誤。
sqlite3_column_text
用於獲取查詢結果集中某一列的文字值。其原型為:
const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);
sqlite3_stmt*
: 由sqlite3_prepare_v2
預編譯的 SQL 語句的控制程式碼。int iCol
: 列的索引,從0開始。
該函式返回指向字串值的指標,該字串值是查詢結果集中指定列的文字表示。需要注意的是,返回的指標指向 SQLite 內部的儲存區,應該在使用完之後儘早釋放資源。
sqlite3_column_int
用於獲取查詢結果集中某一列的整數值。其原型為:
int sqlite3_column_int(sqlite3_stmt*, int iCol);
sqlite3_stmt*
: 由sqlite3_prepare_v2
預編譯的 SQL 語句的控制程式碼。int iCol
: 列的索引,從0開始。
該函式返回查詢結果集中指定列的整數表示。需要注意的是,如果該列不是整數型別,或者包含的資料無法轉換為整數,那麼返回的結果可能不是有效的整數值。
sqlite3_finalize
用於釋放一個預備語句物件(prepared statement)。在使用 sqlite3_prepare_v2
函式準備 SQL 語句後,需要使用 sqlite3_finalize
來釋放相應的語句物件。
該函式的原型為:
int sqlite3_finalize(sqlite3_stmt *pStmt);
sqlite3_stmt *pStmt
: 指向要釋放的語句物件的指標。
該函式返回 SQLITE_OK
表示成功,返回其他錯誤碼錶示失敗。
// 執行SQL語句
bool exec_sql(sqlite3 *db, char *sql)
{
char *error_code = 0;
int ref = sqlite3_exec(db, sql, 0, 0, &error_code);
if (ref == SQLITE_OK)
{
return true;
}
return false;
}
// 插入資料
bool insert_data(sqlite3 *db, char *sql)
{
sqlite3_stmt *stmt = 0;
// 插入前檢查語句合法性, -1自動計算SQL長度
int ref = sqlite3_prepare_v2(db, sql, -1, &stmt, 0);
if (ref == SQLITE_OK)
{
sqlite3_step(stmt); // 執行語句
sqlite3_finalize(stmt); // 清理語句控制程式碼
return true;
}
sqlite3_finalize(stmt);
return false;
}
// 查詢資料集
bool select_data(sqlite3 *db, char *sql)
{
sqlite3_stmt *stmt = 0;
int ref = sqlite3_prepare_v2(db, sql, -1, &stmt, 0);
if (ref == SQLITE_OK)
{
// 每調一次sqlite3_step()函式,stmt就會指向下一條記錄
while (sqlite3_step(stmt) == SQLITE_ROW)
{
// 取出第1列欄位的值
const unsigned char *name = sqlite3_column_text(stmt, 1);
// 取出第2列欄位的值
int age = sqlite3_column_int(stmt, 2);
std::cout << "姓名: " << name << " 年齡: " << age << std::endl;
}
}
else
{
sqlite3_finalize(stmt);
return false;
}
sqlite3_finalize(stmt);
return true;
}
呼叫查詢語句
建立資料庫
首先開啟了名為 "database.db"
的 SQLite 資料庫,並建立了一個名為 "LySharkDB"
的表,該表格包含了id、name、age
和 msg
四個欄位。隨後,透過執行 SQL 語句建立了這個表格。最後,關閉了資料庫連線。這段程式碼主要用於資料庫初始化操作,確保了資料庫中包含了指定的表格結構。
int main(int argc, char *argv[])
{
sqlite3* open_db = open_database("database.db");
if (open_db != false)
{
bool create_table_ref;
std::string sql =
"create table LySharkDB("
"id int auto_increment primary key,"
"name char(30) not null,"
"age int not null,"
"msg text default null"
")";
// 執行建立表操作
char run_sql[1024] = { 0 };
strcpy(run_sql, sql.c_str());
create_table_ref = exec_sql(open_db, run_sql);
}
close_database(open_db);
std::system("pause");
return 0;
}
上述程式碼執行後則可以建立一個資料庫database.db
表名為LySharkDB
讀者可以使用資料庫工具開啟該表,其結構如下所示;
插入資料測試
建立資料庫後,接著就是插入資料測試,插入時可以使用insert_data
,如下程式碼項資料庫中插入5條記錄;
int main(int argc, char *argv[])
{
sqlite3* open_db = open_database("./database.db");
if (open_db != false)
{
bool create_table_ref;
// 執行插入記錄
if (create_table_ref == true)
{
bool insert_ref = 0;
insert_ref = insert_data(open_db, "insert into LySharkDB(id,name,age,msg) values(1,'lyshark',1,'hello lyshark');");
insert_ref = insert_data(open_db, "insert into LySharkDB(id,name,age,msg) values(2,'guest',2,'hello guest');");
insert_ref = insert_data(open_db, "insert into LySharkDB(id,name,age,msg) values(3,'admin',3,'hello admin');");
insert_ref = insert_data(open_db, "insert into LySharkDB(id,name,age,msg) values(4,'wang',4,'hello wang');");
insert_ref = insert_data(open_db, "insert into LySharkDB(id,name,age,msg) values(5,'sqlite',5,'hello sql');");
if (insert_ref == true)
{
std::cout << "插入完成" << std::endl;
}
}
}
close_database(open_db);
std::system("pause");
return 0;
}
插入後,開啟資料庫管理軟體,可看到插入後的記錄;
查詢與刪除資料
而查詢刪除與增加記錄,我們這裡直接使用exec_sql()
函式,透過傳入不同的SQL語句實現。
int main(int argc, char *argv[])
{
sqlite3* open_db = open_database("./database.db");
if (open_db != false)
{
// 刪除記錄
bool delete_ref = exec_sql(open_db, "delete from LySharkDB where id = 5;");
if (delete_ref == true)
{
std::cout << "刪除完成." << std::endl;
}
// 更新記錄
bool update_ref = exec_sql(open_db, "update LySharkDB set name='lyshark' where id = 4;");
if (update_ref == true)
{
std::cout << "更新完成." << std::endl;
}
// 查詢資料
bool select_ref = select_data(open_db, "select * from LySharkDB;");
if (select_ref == true)
{
std::cout << "查詢完畢." << std::endl;
}
}
close_database(open_db);
std::system("pause");
return 0;
}
執行更新後的表記錄如下所示;
查詢區間資料
首先建立一些資料集,這裡透過迴圈生成並插入資料,如下程式碼中新建一個TimeDB
資料表,其中有三個欄位uid,host_time,cpu_value
;
#include <iostream>
#include <string>
#include <map>
#include <vector>
#include <time.h>
#include "sqlite3.h"
#include <boost/lexical_cast.hpp>
#include <boost/format.hpp>
using namespace std;
using namespace boost;
// 獲取本地時間日期
std::string get_local_datetime()
{
char ct[80];
time_t tt;
struct tm *tblock;
tt = time(NULL);
tblock = localtime(&tt);
strftime(ct, sizeof(ct), "%Y-%m-%d %H:%M:%S", tblock);
return ct;
}
// 初始化建立表結構
void Init_Database()
{
sqlite3* open_db = open_database("./database.db");
if (open_db != false)
{
bool create_table_ref;
std::string sql =
"create table TimeDB("
"uid primary key,"
"host_time char(128) not null,"
"cpu_value int not null"
");";
char run_sql[1024] = { 0 };
strcpy(run_sql, sql.c_str());
exec_sql(open_db, run_sql);
}
close_database(open_db);
}
// 批次生成時間字串並插入資料表
void Insert_Test()
{
sqlite3* open_db = open_database("./database.db");
for (int x = 0; x < 1000; x++)
{
// 獲取本地日期時間
std::string local_times = get_local_datetime();
std::string format_string = boost::str(boost::format("insert into TimeDB(uid,host_time,cpu_value) values(%d,'%s',%d);") % x %local_times %x);
std::cout << "執行SQL: " << format_string << std::endl;
char run_sql[1024] = { 0 };
strcpy(run_sql, format_string.c_str());
insert_data(open_db, run_sql);
_sleep(1000);
}
close_database(open_db);
}
int main(int argc, char *argv[])
{
sqlite3* open_db = open_database("./database.db");
Init_Database();
Insert_Test();
std::system("pause");
return 0;
}
如下是五分鐘的模擬資料;
當有了資料則再查詢,程式碼中Select_Time_List
函式演示瞭如何透過時間查詢一個區間的資料,並返回一個容器列表給被呼叫者使用,查詢程式碼如下所示;
#include <iostream>
#include <string>
#include <map>
#include <vector>
#include <time.h>
#include "sqlite3.h"
#include <boost/lexical_cast.hpp>
#include <boost/format.hpp>
using namespace std;
using namespace boost;
// 開啟資料庫並返回控制程式碼
sqlite3* open_database(std::string database_name)
{
int ref = -1;
sqlite3 *db = 0;
ref = sqlite3_open(database_name.c_str(), &db);
if (ref == SQLITE_OK)
return db;
return false;
}
// 關閉資料庫
bool close_database(sqlite3 *db)
{
int ref = sqlite3_close(db);
if (ref == SQLITE_OK)
return true;
return false;
}
// 執行SQL語句
bool exec_sql(sqlite3 *db, char *sql)
{
char *error_code = 0;
int ref = sqlite3_exec(db, sql, 0, 0, &error_code);
if (ref == SQLITE_OK)
{
return true;
}
return false;
}
// 插入資料
bool insert_data(sqlite3 *db, char *sql)
{
sqlite3_stmt *stmt = 0;
// 插入前檢查語句合法性, -1自動計算SQL長度
int ref = sqlite3_prepare_v2(db, sql, -1, &stmt, 0);
if (ref == SQLITE_OK)
{
sqlite3_step(stmt); // 執行語句
sqlite3_finalize(stmt); // 清理語句控制程式碼
return true;
}
sqlite3_finalize(stmt);
return false;
}
// 查詢資料集
bool select_data(sqlite3 *db, char *sql)
{
sqlite3_stmt *stmt = 0;
int ref = sqlite3_prepare_v2(db, sql, -1, &stmt, 0);
if (ref == SQLITE_OK)
{
// 每調一次sqlite3_step()函式,stmt就會指向下一條記錄
while (sqlite3_step(stmt) == SQLITE_ROW)
{
// 取出第1列欄位的值
const unsigned char *name = sqlite3_column_text(stmt, 1);
// 取出第2列欄位的值
int age = sqlite3_column_int(stmt, 2);
std::cout << "姓名: " << name << " 年齡: " << age << std::endl;
}
}
else
{
sqlite3_finalize(stmt);
return false;
}
sqlite3_finalize(stmt);
return true;
}
// 獲取本地時間日期
std::string get_local_datetime()
{
char ct[80];
time_t tt;
struct tm *tblock;
tt = time(NULL);
tblock = localtime(&tt);
strftime(ct, sizeof(ct), "%Y-%m-%d %H:%M:%S", tblock);
return ct;
}
// 初始化建立表結構
void Init_Database()
{
sqlite3* open_db = open_database("./database.db");
if (open_db != false)
{
bool create_table_ref;
std::string sql =
"create table TimeDB("
"uid primary key,"
"host_time char(128) not null,"
"cpu_value int not null"
");";
char run_sql[1024] = { 0 };
strcpy(run_sql, sql.c_str());
exec_sql(open_db, run_sql);
}
close_database(open_db);
}
// 批次生成時間字串並插入資料表
void Insert_Test()
{
sqlite3* open_db = open_database("./database.db");
for (int x = 0; x < 1000; x++)
{
// 獲取本地日期時間
std::string local_times = get_local_datetime();
std::string format_string = boost::str(boost::format("insert into TimeDB(uid,host_time,cpu_value) values(%d,'%s',%d);") % x %local_times %x);
std::cout << "執行SQL: " << format_string << std::endl;
char run_sql[1024] = { 0 };
strcpy(run_sql, format_string.c_str());
insert_data(open_db, run_sql);
_sleep(1000);
}
close_database(open_db);
}
// 查詢時間區間並返回 傳入開始時間與結束時間,過濾出特定的記錄
bool Select_Time_List(sqlite3 *db, std::vector<std::map<std::string, int>> &time_ref, std::string start_time, std::string end_time)
{
sqlite3_stmt *stmt = 0;
std::string format_string = boost::str(boost::format("select * from TimeDB where host_time >= '%s' and host_time <= '%s';") % start_time %end_time);
char run_sql[1024] = { 0 };
strcpy(run_sql, format_string.c_str());
int ref = sqlite3_prepare_v2(db, run_sql, -1, &stmt, 0);
if (ref == SQLITE_OK)
{
while (sqlite3_step(stmt) == SQLITE_ROW)
{
std::map < std::string, int > ptr;
// 取出第一個和第二個欄位
const unsigned char *time_text = sqlite3_column_text(stmt, 1);
const int cpu_value = sqlite3_column_int(stmt, 2);
// 放入一個map容器中
ptr[boost::lexical_cast<std::string>(time_text)] = cpu_value;
time_ref.push_back(ptr);
}
sqlite3_finalize(stmt);
return true;
}
sqlite3_finalize(stmt);
return false;
}
int main(int argc, char *argv[])
{
sqlite3* open_db = open_database("./database.db");
//Init_Database();
//Insert_Test();
// 查詢 2023-11-25 19:52:31 - 2023-11-25 19:53:35 區間內的所有的負載情況
std::vector<std::map<std::string, int>> db_time;
bool is_true = Select_Time_List(open_db, db_time, "2023-11-25 19:52:31", "2023-11-25 19:53:35");
if (is_true == true)
{
for (int x = 0; x < db_time.size(); x++)
{
// 輸出該區間內的資料
std::map < std::string, int>::iterator ptr;
for (ptr = db_time[x].begin(); ptr != db_time[x].end(); ptr++)
{
std::cout << "時間區間: " << ptr->first << " CPU利用率: " << ptr->second << std::endl;
}
}
}
std::system("pause");
return 0;
}
例如程式碼中我們查詢2023-11-25 19:52:31 - 2023-11-25 19:53:35
這個區間內的資料資訊,並返回一個map
容器給被呼叫者,執行效果如下所示;