rust wrapper for libmdbx
```
use anyhow::Result; use lazystatic::lazystatic; use mdbx::{db, env::Env, Db};
lazystatic! { pub static ref MDBX: Env = { let mut dir = std::env::currentexe().unwrap(); dir.pop(); dir.push("test"); println!("mdbx file path {}", dir.display()); dir.try_into().unwrap() }; }
Db!(MDBX, UserName);
// mdbx db flag list link // MDBXDUPSORT 为一个键可以对应多个值 Db!(MDBX, Tag, db::Flag::MDBXDUPSORT);
fn main() -> Result<()> { unsafe { println!( "mdbx version https://github.com/erthink/libmdbx/releases/tag/v{}.{}.{}", mdbx::mdbxversion.major, mdbx::mdbxversion.minor, mdbx::mdbxversion.release ); } let t = std::thread::spawn(|| { let tx = &MDBX.w()?; let username = UserName & tx; username.set(&[3], &[4])?; print!("thread {:?}", username.get(&[2])?); Ok::<(), anyhow::Error>(()) });
{ let tx = &MDBX.w()?; let username = UserName & tx; username.set(&[2], &[5])?; println!("main get {:?}", username.get(&[2])?); (username - [2])?; println!("main get after del {:?}", user_name.get(&[2])?);
let tag = Tag & tx;
// 一个键可以对应多个值
tag.set(&[1], &[1])?;
tag.set(&[1], &[2])?;
tag.set(&[1], &[3])?;
tag.set(&[1], &[4])?;
dbg!(tag.get(&[1])?);
// del需要传入val，只删除精确匹配到的
dbg!(tag.del(&[1], &[2])?);
dbg!(tag.get(&[1])?);
// 删除这个key所有的val
(tag - [1])?;
dbg!(tag.get(&[1])?);
}
t.join().unwrap()?;
Ok(()) } ```
output as below
mdbx file path /root/git/mdbx/target/debug/examples/test
mdbx version https://github.com/erthink/libmdbx/releases/tag/v0.11.1
main get Some([5])
main get after del None
thread None
因为mdbx-rs(mdbx-sys)不支持windows，于是我自己动手封装一个支持windows版本。
mdbx是基于lmdb魔改的数据库 ，作者是俄罗斯人Леонид Юрьев (Leonid Yuriev)。
lmdb是一个超级快的嵌入式键值数据库，性能测试对比如下图。
全文搜索引擎MeiliSearch就是基于lmdb开发的。
mdbx在嵌入式性能测试基准ioarena中lmdb还要快30% 。
mdbx改进了不少lmdb的缺点。
Erigon（下一代以太坊客户端）最近从 LMDB 切换到了 MDBX。
他们列举了从 LMDB 过渡到 MDBX 的好处：
Erigon started off with the BoltDB database backend, then adding the support for BadgerDB, and then eventually migrating exclusively to LMDB. At some point we have encountered stability issues that were caused by our usage of LMDB that was not envisaged by the creators. We have since then been looking at a well-supported derivative of LMDB, called MDBX, and hoping to use their stability improvement, and potentially working more together in the future. The integration of MDBX is done, now it is time for more testing and documentation.
Erigon 从 BoltDB 数据库后端开始，然后添加对 BadgerDB 的支持，最终专门迁移到 LMDB。在某种程度上，我们遇到了稳定性问题，这是由于我们使用了创建者没有预料到的 LMDB 而引起的。从那时起，我们一直在研究一种受到良好支持的 LMDB 衍生物，称为 MDBX，并希望利用它们对稳定性的改善，并可能在未来进行更多的合作。MDBX 的集成已经完成，现在是进行更多测试和文档化的时候了。
Benefits of transitioning from LMDB to MDBX:
从 LMDB 过渡到 MDBX 的好处:
1. Database file growth "geometry" works properly. This is important especially on Windows. In LMDB, one has to specify the memory map size once in advance (currently we use 2Tb by default), and if the database file grows over that limit, one has to restart the process. On Windows, setting memory map size to 2Tb makes database file 2Tb large on the onset, which is not very convenient. With MDBX, memory map size is increased in 2Gb increments. This means occasional remapping, but results in a better user experience.
数据库文件增长“几何”工程正常。这一点非常重要，尤其是在 Windows 上。在 LMDB 中，必须提前一次指定内存映射大小(目前我们默认使用2tb) ，如果数据库文件超过这个限制，则必须重新启动进程。在 Windows 上，将内存映射大小设置为2tb 会使数据库文件在开始时就变大，这并不十分方便。使用 MDBX，内存映射大小以2gb 的增量增加。这意味着偶尔的重新映射，但是会带来更好的用户体验。2. MDBX has more strict checks on concurrent use of the transaction handles, as well as overlap read and write transaction within the same thread of execution. This allowed us to find some non-obvious bugs and make behaviour more predictable.
MDBX 对事务句柄的并发使用有更严格的检查，以及在同一执行线程中重叠读写事务。这使我们能够发现一些不明显的错误，并使行为更可预测。
Over the period of more than 5 years (since it split from LMDB), MDBX accumulated a lot of safety fixes and heisenbug fixes that are still present in LMDB to the best of our knowledge. Some of them we have discovered during our testing, and MDBX maintainer took them seriously and worked on the fixes promptly.
在超过5年的时间里(从 LMDB 中分离出来以后) ，MDBX 积累了大量的安全修复和 heisenberg bug 修复，据我们所知，这些修复仍然存在于 LMDB 中。我们在测试期间发现了其中的一些问题，MDBX 维护人员认真对待了这些问题，并及时修复了这些问题。
3. When it comes to databases that constantly modify data, they generate quite a lot of reclaimable space (also known as "freelist" in LMDB terminology). We had to patch LMDB to fix most serious drawbacks when working with reclaimable space (analysis here: https://github.com/ledgerwatch/erigon/wiki/LMDB-freelist-illustrated-guide). MDBX takes special care of efficient handling of reclaimable space and so far no patches were required.
当涉及到不断修改数据的数据库时，它们会产生大量可回收空间(在 LMDB 术语中也称为“自由职业者”)。当使用可回收空间时，我们不得不修补 LMDB 来修复最严重的缺陷(这里分析: https://github.com/ledgerwatch/erigon/wiki/LMDB-freelist-illustrated-guide 空间)。MDBX 特别注意有效处理可回收空间，迄今为止没有补丁需要。
4. According to our tests, MDBX performs slightly better on our workloads.
根据我们的测试，MDBX 在我们的工作负载上表现稍好一些。
5. MDBX exposes more internal telemetry - more metrics of what happening inside DB. And we have them in Grafana - to make better decisions on app design. For example, after complete transition to MDBX (removing LMDB support) we will implement "commit half-full transactions" strategy to avoid spill/unspill disk touches. This will simplify our code further without affecting performance.
MDBX 公开了更多的内部遥测数据——关于 DB 内部发生的情况的更多指标。而且我们在 Grafana 也有这样的机构——它们可以在应用程序设计上做出更好的决策。例如，在完全转换到 MDBX (删除 LMDB 支持)之后，我们将实现“提交半满事务”策略，以避免溢出/未溢出磁盘。这将进一步简化我们的代码，而不会影响性能。
6. MDBX has support for "Exclusive open" mode - we using it for DB migrations, to prevent any other reader from accessing the database while DB migration is in progress.
MDBX 支持“ Exclusive open”模式——我们使用它进行 DB 迁移，以防止任何其他读取器在 DB 迁移过程中访问数据库。
本项目隶属于人民网络(rmw.link) 代码计划。
