rosedb v2 版本发布!

RoseDB V2 重构的第一个版本发布了!

RoseDB 是一个基于 Bitcask 存储模型,轻量、快速、可靠的 KV 存储引擎。Bitcask 存储模型的设计主要受到日志结构化的文件系统和日志文件合并的启发。

感兴趣可参考 Bitcask 论文:https://riak.com/assets/bitcask-intro.pdf

RoseDB 存储数据的文件使用预写日志(Write Ahead Log)进行了重新设计,这些日志文件是具有 block 缓存的只追加写入(append-only)文件。

wal: https://github.com/rosedblabs/wal

我将原来 rosedb 中的 Redis 数据结构和协议拆分了出去,后面会单独形成一个项目,方便接入不同的存储引擎,比如 rosedb、badger、pebble、levledb 等等。

所以 rosedb 只专注于单机存储引擎的功能,目前处于积极维护状态,欢迎大家 issue 或者贡献,点点 star ⭐️。

项目地址:https://github.com/rosedblabs/rosedb

以下是 RoseDB 的一些简单介绍和使用示例:

主要特点

优势

读写低延迟

这是由于 Bitcask 存储模型文件的追加写入特性,充分利用顺序 IO 的优势。高吞吐量,即使数据完全无序

写入 RoseDB 的数据不需要在磁盘上排序,Bitcask 的日志结构文件设计在写入过程中减少了磁盘磁头的移动。

能够处理大于内存的数据集,性能稳定

RoseDB 的数据访问涉及对内存中的索引数据结构进行直接查找,这使得即使数据集非常大,查找数据也非常高效。

一次磁盘 IO 可以获取任意键值对

RoseDB 的内存索引数据结构直接指向数据所在的磁盘位置,不需要多次磁盘寻址来读取一个值,有时甚至不需要寻址,这归功于操作系统的文件系统缓存以及 WAL 的 block 缓存。

性能快速稳定

RoseDB 写入操作最多需要一次对当前打开文件的尾部的寻址,然后进行追加写入,写入后会更新内存。这个流程不会受到数据库数据量大小的影响,因此性能稳定。

崩溃恢复快速

使用 RoseDB 的崩溃恢复很容易也很快,因为 RoseDB 文件是只追加写入一次的。恢复操作需要检查记录并验证CRC数据,以确保数据一致。

备份简单

在大多数系统中,备份可能非常复杂。RoseDB 通过其只追加写入一次的磁盘格式简化了此过程。任何按磁盘块顺序存档或复制文件的工具都将正确备份或复制 RoseDB 数据库。

批处理操作可以保证原子性、一致性和持久性

RoseDB 支持批处理操作,这些操作是原子、一致和持久的。批处理中的新写入操作在提交之前被缓存在内存中。如果批处理成功提交,批处理中的所有写入操作将持久保存到磁盘。如果批处理失败,批处理中的所有写入操作将被丢弃。即一个批处理操作中的所有写入操作要么全部成功,要么全部失败。

缺点

所有的 key 必须在内存中维护

RoseDB 始终将所有 key 保留在内存中,这意味着您的系统必须具有足够的内存来容纳所有的 key。

快速上手

基本操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
package main

import "github.com/rosedblabs/rosedb/v2"

func main() {
 // 指定选项
 options := rosedb.DefaultOptions
 options.DirPath = "/tmp/rosedb_basic"

 // 打开数据库
 db, err := rosedb.Open(options)
 if err != nil {
  panic(err)
 }
 defer func() {
  _ = db.Close()
 }()

 // 设置键值对
 err = db.Put([]byte("name"), []byte("rosedb"))
 if err != nil {
  panic(err)
 }

 // 获取键值对
 val, err := db.Get([]byte("name"))
 if err != nil {
  panic(err)
 }
 println(string(val))

 // 删除键值对
 err = db.Delete([]byte("name"))
 if err != nil {
  panic(err)
 }
}

批处理操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
// 创建批处理
 batch := db.NewBatch(rosedb.DefaultBatchOptions)

 // 设置键值对
 _ = batch.Put([]byte("name"), []byte("rosedb"))

 // 获取键值对
 val, _ := batch.Get([]byte("name"))
 println(string(val))

 // 删除键值对
 _ = batch.Delete([]byte("name"))

 // 提交批处理
 _ = batch.Commit()

完整代码可查看 examples 示例代码。