Struct opendal::services::Rocksdb

pub struct Rocksdb { /* private fields */ }

Rocksdb service support.

Capabilities

This service can be used to:

• read
• write
• list
• scan
• presign
• blocking

Note

OpenDAL will build rocksdb from source by default.

To link with existing rocksdb lib, please set one of the following:

• ROCKSDB_LIB_DIR to the dir that contains librocksdb.so
• ROCKSDB_STATIC to the dir that contains librocksdb.a

If the version of RocksDB is below 6.0, you may encounter compatibility issues. It is advisable to follow the steps provided in the INSTALL file to build rocksdb, rather than relying on system libraries that may be outdated and incompatible.

Configuration

• root: Set the working directory of OpenDAL
• datadir: Set the path to the rocksdb data directory

You can refer to RocksdbBuilder’s docs for more information

Example

Via Builder

use anyhow::Result;
use opendal::services::Rocksdb;
use opendal::Object;
use opendal::Operator;

#[tokio::main]
async fn main() -> Result<()> {
    let mut builder = Rocksdb::default();
    builder.datadir("/tmp/opendal/rocksdb");

    let op: Operator = Operator::new(builder)?.finish();
    let _: Object = op.object("test_file");
    Ok(())
}

Implementations

impl RocksdbBuilder

pub fn datadir(&mut self, path: &str) -> &mut Self

Set the path to the rocksdb data directory. Will create if not exists.

pub fn root(&mut self, root: &str) -> &mut Self

set the working directory, all operations will be performed under it.

default: “/”

Trait Implementations

impl Builder for RocksdbBuilder

const SCHEME: Scheme = Scheme::Rocksdb

Associated scheme for this builder.

type Accessor = Backend<Adapter>

The accessor that built by this builder.

fn from_map(map: HashMap<String, String>) -> Self

Construct a builder from given map.

fn build(&mut self) -> Result<Self::Accessor>

Consume the accessor builder to build a service.

fn from_iter(iter: impl Iterator<Item = (String, String)>) -> Selfwhere
    Self: Sized,

Construct a builder from given iterator.

fn from_env() -> Selfwhere
    Self: Sized,

Construct a builder from envs.

impl Clone for RocksdbBuilder

fn clone(&self) -> RocksdbBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RocksdbBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RocksdbBuilder

fn default() -> RocksdbBuilder

Returns the “default value” for a type.