RustRocks

另一个用于 Rust 的 RocksDB 绑定。 文档

让 RocksDB 真正变得强大！

• 静态链接到 RocksDB 6.7.3 (git 子模块)
• 动态链接已测试
  • macOS homebrew
  • Windows 10, VS 2019 与 vcpkg
  • ArchLinux x86_64 和 aarch64(ODroid-C2)
  • Ubuntu 18.04 (rocksdb5.8 分支)，x86_64 和 aarch64(RPi 3)
  • Ubuntu 20.04 (rocksdb5.17 分支)

安装

动态链接 RocksDB

[dependencies]
rocks = "0.1"

静态链接到 RocksDB（默认启用 snappy）

[dependencies.rocks]
version = "0.1"
default-features = false
features = ["static-link"]

所有静态特性

[dependencies.rocks]
version = "0.1"
default-features = false
features = ["full"]

如何编译

请参考 Travic-CI, AppVeyor 和 Github Actions 配置文件。

静态链接

$ git submodule update --init --recursive
$ cargo test --features static-link -- --test-threads 1
(This will build with snappy as the only compression supported)

$ cargo test --features full -- --test-threads 1
(This will build with all compression supported)

动态链接

对于 macOS（通过 brew 安装 RocksDB）

$ brew install rocksdb
$ cargo test -- --nocapture --test-threads 1

对于 Linux

(install rocksdb via package manager or make & install)
$ sudo apt install lld
(NOTE: gcc-ld can't handle circular references while linking.)
(for more, refer the last section of README)
$ RUSTFLAGS="-C link-arg=-fuse-ld=lld" cargo test -- --test-threads 1

如果 rocksdb 安装在非默认目录，请使用环境变量

LD_LIBRARY_PATH=/usr/local/libLIBRARY_PATH=/usr/local/libCXXFLAGS=-I/usr/local/include

Ubuntu LTS

RocksDB 经常更改其 API，因此 rust-rocks 使用不同的分支来支持 Ubuntu LTS。

> sudo apt install librocksdb-dev libsnappy-dev

您还需要 lld 来自官方源或 http://apt.llvm.org/。

分支

• rocksdb5.8 (18.04 LTS)
• rocksdb5.17 (20.04 LTS)

Windows

您需要 VS 2017 或 VS 2019，并通过 vcpkg 安装 RocksDB。

常见问题解答

• 与 C++ RocksDB 相比，哪些功能受支持/缺失？
• 为什么还需要另一个 Rust 的 RocksDB 绑定？

请随意打开 新问题。

列出当前支持的压缩类型

$ cargo run --example it-works
RocksDB: 6.7.3
Compression Supported:
  - NoCompression
  - SnappyCompression
  - ZlibCompression
  - BZip2Compression
  - LZ4Compression
  - LZ4HCCompression
  - ZSTD
  - ZSTDNotFinalCompression

开发

Bindgen

$ cd rocks-sys
$ PATH="/usr/local/opt/llvm/bin:$PATH" make
(this will regenerate the bindgen c.rs)

已知错误

Linux 下的链接错误

• rust-rocks 将 rust 函数导出为 c++，因此在链接时存在循环引用
• gcc 要求按照它们相互依赖的顺序放置对象文件和库
• Rust 不会将用户 crates 包装在 --start-group 和 --end-group 中
• 循环引用将被视为错误。
• 可以使用 lld 作为链接器，并通过以下命令修复：RUSTFLAGS="-C link-arg=-fuse-ld=lld"
• 可以通过手动组织链接参数来修复。
  • librocks，然后是 librocks_sys，然后再是 librocks

轻微的内存泄漏。

• 原始指针是动态创建的，应该通过 lazy_static 实现，并封装在特质对象中。
  • ColumnFamilyOptions::comparator： const Comparator*
  • ColumnFamilyOptions::compaction_filter： const CompactionFilter*

迭代器生命周期泄漏。

参考： https://github.com/bh1xuw/rust-rocks/issues/15

• 在进行 for 遍历时：这是可以的。
• 在收集以供后续使用时：克隆键和值。