单片机 sqlite3

### 单片机上使用SQLite3数据库

对于单片机而言，由于其硬件资源有限，直接在其上运行完整的SQLite3可能不太现实。然而，在一些具备一定处理能力和内存空间的微控制器平台上（如ESP32, STM32等），确实可以考虑集成简化版的SQLite3来实现简单的数据持久化需求。

#### 安装与配置

要在支持的操作系统环境下安装SQLite3库，可参照官方文档说明进行编译构建适合目标平台架构版本的静态链接库[^4]。对于裸机环境，则需自行移植适配底层接口以满足SQLite的要求。

#### 创建并打开数据库连接

当SQLite被成功部署到单片机环境中之后，就可以通过C/C++ API来进行基本操作了：

#include <sqlite3.h>
// 初始化数据库对象指针
sqlite3 *db;
int rc;

rc = sqlite3_open("example.db", &db); // 打开名为 example.db 的数据库文件
if (rc != SQLITE_OK){
    fprintf(stderr,"Can't open database: %s\n", sqlite3_errmsg(db));
}
else{
    printf("Opened database successfully\n");
}

sqlite3_close(db);

这段代码展示了如何创建一个新的或打开已有的`.db`类型的SQLite数据库文件[^1]。

#### 插入数据示例

下面是一个向表中插入新纪录的例子：

char* sql = "INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) VALUES (1,'Paul', 32, 'California', 20000.00 );";

/* Execute SQL statement */
rc = sqlite3_exec(db, sql, callback, 0, &zErrMsg);

if(rc != SQLITE_OK ){
    fprintf(stderr, "SQL error: %s\n", zErrMsg);
    sqlite3_free(zErrMsg);
}else{
    fprintf(stdout, "Records created successfully\n");
}

此部分假设已经存在一个叫做COMPANY的数据表结构，并尝试往里面添加一条员工信息记录[^3]。

#### 查询数据实例

查询特定条件下的所有匹配项并将结果显示出来：

const char* data = "Callback function called";
rc = sqlite3_exec(db, "SELECT id, name FROM company;", callback, (void*)data, &zErrMsg);
if( rc != SQLITE_OK ) {
   fprintf(stderr, "SQL error: %s\n", zErrMsg);
   sqlite3_free(zErrMsg);
} else {
   fprintf(stdout, "Operation done successfully\n");
}

这里定义了一个回调函数用于处理每一行的结果集[^5]。