FlashDB beta 测试版目前已发布数月,在这段时间里, 陆陆续续收到大家的很多意见反馈,有些甚至也已经用在项目上了 。
结合大家的反馈,相关的问题均已修正,并对文档、测试等方面做了挺多完善。
今天正式版终于可以与大家见面了,一起来看下正式版的大致更新内容:
新增在线文档中心
内容丰富,分为:入门、示例及开发三大部分,上手方便,详见: http://armink.gitee.io/flashdb/#/zh-cn/
新增自动化测试
新增基于 Travis CI 的自动化构建检查及自动化测试,保证每次代码提交不仅编译通过,功能也都经过 qemu 模拟器环境下的测试验证。qemu 模拟器下的自动化测试部分日志大致如下,完整日志请查看:https://travis-ci.com/github/armink/FlashDB
新增 KV 迭代器的 API
方便实现对 KVDB 中的全部 KV 进行遍历,感谢网友 eggcar 的贡献。
迭代器示例文档: http://armink.gitee.io/flashdb/#/zh-cn/sample-kvdb-traversal
新增 contorl 控制函数
通过 fdb_kvdb_control
及 fdb_tsdb_control
的控制函数,用户可以实现一些对于数据库的控制管理功能。比如:设置 加锁和解锁 函数、设置 扇区大小 等
对于 TSDB 的 control 函数,用户还可以
-
设置让数据库不启动处理滚动写入模式,这样如果数据库满,最旧的数据也不会删除,但无法插入新的数据
-
获取上次的使用的时间戳,这样即便系统中没有 RTC ,也可以使用软件模拟时间戳功能,适用于一些对于 实时时间不敏感的场景。点击查看更多介绍 。
其他
-
完善打印日志
-
修正一些潜在 bug
FlashDB 简介
FlashDB 是一款超轻量级的嵌入式数据库,专注于提供嵌入式产品的数据存储方案。与传统的基于文件系统的数据库不同,FlashDB 结合了 Flash 的特性,具有较强的性能及可靠性。并在保证极低的资源占用前提下,尽可能延长 Flash 使用寿命。 FlashDB 提供两种数据库模式: 键值数据库 和 时序数据库。
主要特性
-
资源占用极低,内存占用几乎为 0 ;
-
支持 多分区,多实例 。数据量大时,可细化分区,降低检索时间;
-
支持 磨损平衡 ,延长 Flash 寿命;
-
支持 掉电保护 功能,可靠性高;
-
支持 字符串及 blob 两种 KV 类型,方便用户操作;
-
支持 KV 增量升级 ,产品固件升级后, KVDB 内容也支持自动升级;
-
支持 修改每条 TSDB 记录的状态,方便用户进行管理;
FlashDB 是一款超轻量级的嵌入式数据库,专注于提供嵌入式产品的数据存储方案。与传统的基于文件系统的数据库不同,FlashDB 结合了 Flash 的特性,具有较强的性能及可靠性。并在保证极低的资源占用前提下,尽可能延长 Flash 使用寿命。
FlashDB 提供两种数据库模式:
键值数据库 :是一种非关系数据库,它将数据存储为键值(Key-Value)对集合,其中键作为唯一标识符。KVDB 操作简洁,可扩展性强。
时序数据库 :时间序列数据库 (Time Series Database , 简称 TSDB),它将数据按照 时间顺序存储 。TSDB 数据具有时间戳,数据存储量大,插入及查询性能高。
使用场景
如今,物联网产品种类越来越多,运行时产生的数据种类及总量及也在不断变大。FlashDB 提供了多样化的数据存储方案,不仅资源占用小,并且存储容量大,非常适合用于物联网产品。下面是主要应用场景:
键值数据库 :
产品参数存储
用户配置信息存储
小文件管理
时序数据库 :
存储动态产生的结构化数据:如 温湿度传感器采集的环境监测信息,智能手环实时记录的人体健康信息等
记录运行日志:存储产品历史的运行日志,异常告警的记录等
主要特性
资源占用极低,内存占用几乎为 0 ;
支持 多分区,多实例 。数据量大时,可细化分区,降低检索时间;
支持 磨损平衡 ,延长 Flash 寿命;
支持 掉电保护 功能,可靠性高;
支持 字符串及 blob 两种 KV 类型,方便用户操作;
支持 KV 增量升级 ,产品固件升级后, KVDB 内容也支持自动升级;
支持 修改每条 TSDB 记录的状态,方便用户进行管理;
性能及资源占用
TSDB 性能测试1 (nor flash W25Q64)
msh />tsl bench Append 1250 TSL in 5 seconds, average: 250.00 tsl/S, 4.00 ms/per Query total spent 2218 (ms) for 1251 TSL, min 1, max 2, average: 1.77 ms/per
插入平均:4 ms,查询平均:1.8 ms
TSDB 性能测试2 (stm32f2 onchip flash)
msh />tsl bench Append 13421 TSL in 5 seconds, average: 2684.20 tsl/S, 0.37 ms/per Query total spent 1475 (ms) for 13422 TSL, min 0, max 1, average: 0.11 ms/per
插入平均:0.37 ms,查询平均:0.12 ms
资源占用 (stm32f4 IAR8.20)
Module ro code ro data rw data ------ ------- ------- ------- fdb.o 276 232 1 fdb_kvdb.o 4 584 356 1 fdb_tsdb.o 1 160 236 fdb_utils.o 418 1 024
上面是 IAR 的 map 文件信息,可见 FlashDB 的资源占用非常低
如何使用
FlashDB 提供了全面的文档说明,详见:http://armink.gitee.io/flashdb/#/zh-cn/