Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cberner/redb
An embedded key-value database in pure Rust
https://github.com/cberner/redb
rust
Last synced: 21 days ago
JSON representation
An embedded key-value database in pure Rust
- Host: GitHub
- URL: https://github.com/cberner/redb
- Owner: cberner
- License: apache-2.0
- Created: 2018-09-23T18:30:14.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-13T23:42:38.000Z (7 months ago)
- Last Synced: 2024-04-14T13:11:51.169Z (7 months ago)
- Topics: rust
- Language: Rust
- Homepage: https://www.redb.org
- Size: 1.84 MB
- Stars: 2,874
- Watchers: 24
- Forks: 124
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-rust - Redb - An embedded key-value database. It provides a similar interface to other embedded key-value stores such as rocksdb and lmdb.  (Libraries / Database)
- awesome-rust - Redb - An embedded key-value database. It provides a similar interface to other embedded key-value stores such as rocksdb and lmdb.  (Libraries / Database)
- my-awesome - cberner/redb - 10 star:3.2k fork:0.1k An embedded key-value database in pure Rust (Rust)
- awesome-rust-list - redb - value database in pure Rust. [www.redb.org](https://www.redb.org/) (Database)
- awesome-rust-list - redb - value database in pure Rust. [www.redb.org](https://www.redb.org/) (Database)
- fucking-awesome-rust - Redb - An embedded key-value database. It provides a similar interface to other embedded key-value stores such as rocksdb and lmdb.  (Libraries / Database)
- fucking-awesome-rust - Redb - An embedded key-value database. It provides a similar interface to other embedded key-value stores such as rocksdb and lmdb.  (Libraries / Database)
README
# redb
[](https://crates.io/crates/redb)
[](https://docs.rs/redb)
[](https://crates.io/crates/redb)
[](https://deps.rs/repo/github/cberner/redb)
A simple, portable, high-performance, ACID, embedded key-value store.
redb is written in pure Rust and is loosely inspired by [lmdb](http://www.lmdb.tech/doc/). Data is stored in a collection
of copy-on-write B-trees. For more details, see the [design doc](docs/design.md)
```rust
use redb::{Database, Error, ReadableTable, TableDefinition};
const TABLE: TableDefinition<&str, u64> = TableDefinition::new("my_data");
fn main() -> Result<(), Error> {
let db = Database::create("my_db.redb")?;
let write_txn = db.begin_write()?;
{
let mut table = write_txn.open_table(TABLE)?;
table.insert("my_key", &123)?;
}
write_txn.commit()?;
let read_txn = db.begin_read()?;
let table = read_txn.open_table(TABLE)?;
assert_eq!(table.get("my_key")?.unwrap().value(), 123);
Ok(())
}
```
## Status
redb is undergoing active development, and should be considered beta quality. The file format is stable,
but redb has not been widely deployed in production systems (at least to my knowledge).
## Features
* Zero-copy, thread-safe, `BTreeMap` based API
* Fully ACID-compliant transactions
* MVCC support for concurrent readers & writer, without blocking
* Crash-safe by default
* Savepoints and rollbacks
## Development
To run all the tests and benchmarks a few extra dependencies are required:
* `cargo install cargo-deny --locked`
* `cargo install cargo-fuzz --locked`
* `apt install libclang-dev`
## Benchmarks
redb has similar performance to other top embedded key-value stores such as lmdb and rocksdb
| | redb | lmdb | rocksdb | sled | sanakirja |
|---------------------------|------------|------------|-------------|--------|-----------|
| bulk load | 2792ms | **1115ms** | 5610ms | 5005ms | 1161ms |
| individual writes | **462ms** | 1119ms | 1097ms | 957ms | 662ms |
| batch writes | 2568ms | 2247ms | **1344ms** | 1622ms | 2713ms |
| random reads | 988ms | **558ms** | 3469ms | 1509ms | 678ms |
| random reads | 962ms | **556ms** | 3377ms | 1425ms | 671ms |
| random range reads | 2534ms | **985ms** | 6058ms | 4670ms | 1089ms |
| random range reads | 2493ms | **998ms** | 5801ms | 4665ms | 1119ms |
| random reads (4 threads) | 344ms | **141ms** | 1247ms | 424ms | 266ms |
| random reads (8 threads) | 192ms | **72ms** | 673ms | 230ms | 620ms |
| random reads (16 threads) | 131ms | **47ms** | 476ms | 148ms | 3500ms |
| random reads (32 threads) | 118ms | **44ms** | 412ms | 129ms | 4313ms |
| removals | 2184ms | **784ms** | 2451ms | 2047ms | 1344ms |
Source code for benchmark [here](./benches/lmdb_benchmark.rs). Results collected on a Ryzen 5900X with Samsung 980 PRO NVMe.
## License
Licensed under either of
* [Apache License, Version 2.0](LICENSE-APACHE)
* [MIT License](LICENSE-MIT)
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally
submitted for inclusion in the work by you, as defined in the Apache-2.0
license, shall be dual licensed as above, without any additional terms or
conditions.