SQLite for RT-Thread

简介

SQLite 是一个小型，快速，独立的高可靠性全功能 SQL 数据库引擎。SQLite 是全世界部署最广泛的 SQL 数据库引擎。它内置在几乎所有的移动电话、大多数计算机以及部分嵌入式设备中，并被捆绑在人们每天使用的无数其他应用程序中。

文件说明

获取

在ENV中配置如下

RT-Thread online packages  ---> 
    system packages  ---> 
        --- SQLite: a self-contained, high-reliability, embedded, full-featured, public-domain, SQL database engine.
        (1024) SQL statements max length
        [*]   Enable example

配置项说明：

依赖

• RT-Thread 3.X+
• DFS组件

dbhelp接口说明

dbhelp是对sqlite3操作接口的封装，目的是使用户更加简单地操作sqlite。

数据库文件完整路径

数据库文件的默认存放完整路径是"/rt.db"，用户可根据实际需求在dbhelper.h中修改。

#define DB_NAME "/rt.db"

初始化

dbhelp初始化，其中包含了sqlite的初始化及互斥量创建。用户无需再对数据库及锁初始化。

int db_helper_init(void);

数据库创建

int db_create_database(const char *sqlstr);

const char *sql = "CREATE TABLE student(id INTEGER PRIMARY KEY AUTOINCREMENT,name varchar(32) NOT NULL,score INT NOT NULL);";
return db_create_database(sql);

可进行数据绑定的非查询操作

用于非查询的操作，可通过回调进行数据绑定，db_nonquery_operator中开启了事务功能，支持操作失败后回滚。

int db_nonquery_operator(const char *sqlstr, int (*bind)(sqlite3_stmt *, int index, void *arg), void *param);

普通SQL语句在执行时是需要解析、编译、执行的，而sqlite3_stmt结构是已经通过sqlite3_prepare函数对sql语句解析和编译了的，而在SQL语句中在要绑定数据的位置放置?作为占位符，即可通过数据绑定接口sqlite3_bind_(此处为通配符，取值为int，double，text等，详情请见sqlite文档)。这种在批量操作时，由于绕开了解释编译的过程，直接在sqlite3_stmt的基础上对绑定值进行修改，因而会使整体操作效率势大大提升。具体应用请见student_dao.c

带可变参数的非查询操作

int db_nonquery_by_varpara(const char *sql, const char *fmt, ...);

int student_del(int id)
{
    return db_nonquery_by_varpara("delete from student where id=?;", "%d", id);
}

SQL语句"delete from student where id=?;"中，“?”为占位符，id将会按照%d的格式被绑定到通过对前述SQL语句解释编译后的sqlite3_stmt中。

开启事务的非查询操作

db_nonquery_transaction开启了事务功能，支持操作失败后回滚。

int db_nonquery_transaction(int (*exec_sqls)(sqlite3 *db, void *arg), void *arg);

exec_sqls：

带变参的查询操作

用户可通过sql语句及变参进行查询操作

int db_query_by_varpara(const char *sql, int (*create)(sqlite3_stmt *stmt, void *arg), void *arg, const char *fmt, ...);

create回调：

用户可通过调用在通过调用db_stmt_get_int，db_stmt_get_text等接口配合sqlite3_step获取查询结果，回调接收不定数量的条目时请注意内存用量，或在查询前先通过db_query_count_result确定条符合条件的条目数量。

获取符合条件的结果数量

调用此接口返回结果条目数量，注意，如的SQL语句应为SELECT COUNT为前缀的查询数量的语句。接口中只会获取第一行第一列。

int db_query_count_result(const char *sql);

nums = db_query_count_result("select count(*) from sqlite_master where type = 'table';");

在查询结果中获取blob型数据

在查询时获取blob类型数据，blob类型在SQLite 中指二进制大对象，完全根据其输入值存储。

int db_stmt_get_blob(sqlite3_stmt *stmt, int index, unsigned char *out)

在查询结果中获取text型数据

在查询时获取文本类型数据，text类型值是一个文本字符串。

int db_stmt_get_text(sqlite3_stmt *stmt, int index, char *out)

在查询结果中获取int型数据

在查询时获取整型数据

int db_stmt_get_int(sqlite3_stmt *stmt, int index);

在查询结果中获取double型数据

在查询时获取双精度数据

double db_stmt_get_double(sqlite3_stmt *stmt, int index)

通过表面查询表是否存在

可通过输入表名称来确定该表是否存在。

int db_table_is_exist(const char *tbl_name)

设置数据库文件名

该文件名应为绝对路径，请使用.db作为扩展名。在对单数据库的使用场景中可用来设置数据库名称。多线程多数据库请使用int db_connect(char *name)和int db_connect(char *name)。

int db_set_name(char *name)

读取当前数据库文件名

const char *db_get_name(void)

连接数据库

该文件名应为绝对路径，请使用.db作为扩展名，该方法将会设置要打开的数据库文件名并加锁，操作完毕后请调用 int db_disconnect(char *name) 解锁，以便以其他线程操作。适用于多线程操作多数据库场景。如果是多线程，单数据库场景请使用 int db_set_name(char *name) 来修改数据库名称或直接操作数据库（即使用默认数据库名称）。

int db_connect(char *name)

断开数据库连接

断开数据库连接，数据库名称将恢复为默认，并释放互斥量。

int db_connect(char *name)

DAO层实例

这是一个学生成绩录入查询的DAO(Data Access Object)层示例，可在menuconfig中配置使能。通过此例程可更加详细的了解dbhelper的使用方法。例程配置使能后，可通过命令行实现对student表的操作，具体命令如下：

说明：以下命令中被[]包裹的为必填参数，<>包裹的为非必填参数

stu add <num>

增加<num>个学生信息。学生名称和成绩为一定范围内的生成的随机值。如果仅输入stu add则默认插入一条学生信息。

stu del

删除主键为<id>的学生成绩信息，如果仅输入stu del则删除全部学生信息。例如：

stu del 1

删除主键为1的学生成绩信息。

stu update [id] [name] [score]

将主键为[id]的学生的姓名及分数分别修改为[name]和[score]。例如：

stu update 1 lizhen9880 100

表示将主键为1的条目中学生姓名修改为lizhen9880，分数修改为100。

stu <id>

根据id查询学生成绩并打印，id为该表自增主键，具备唯一性。根据主键查询速度是非常快的。 仅输入 stu 会查询出所有学生名称成绩并打印,例：

stu 3

将查询出主键为3的学生成绩信息并打印。

stu score [ls] [hs] <-d|-a>

查询并打印分数在[ls]到[hs]之间的学生成绩单。
[ls]: 最低分
[hs]: 最高分
<-d|-a>: -d 降序；-a 升序；默认升序 例如：

stu score 60 100 -d

按照降序打印出成绩及格学生的成绩单。

stu score 60 100

按照升序打印出成绩及格学生的成绩单。

注意事项

• SQLite资源占用：RAM:250KB+,ROM:310KB+，所以需要有较充足的硬件资源。
• 根据应用场景创建合理的表结构，会提高操作效率。
• 根据应用场合理使用SQL语句，如查询条件，插入方式等。
• 如涉及到多表操作或联表查询，最好使用PowerDesigner等工具合理设计表。

相关链接

Env工具获取：https://www.rt-thread.org/page/download.html

Env工具使用：https://www.rt-thread.org/document/site/zh/5chapters/01-chapter_env_manual/#env

SQLite官方文档：https://www.sqlite.org/docs.html

Q&F

联系人： RT-Thread官方 | lizhen9880
邮箱：package_team@rt-thread.com | lizhen9880@126.com