Expand description
Rust wrapper for RocksDB.
§Examples
use rust_rocksdb::{DB, Options};
// NB: db is automatically closed at end of lifetime
let tempdir = tempfile::Builder::new()
.prefix("_path_for_rocksdb_storage")
.tempdir()
.expect("Failed to create temporary path for the _path_for_rocksdb_storage");
let path = tempdir.path();
{
let db = DB::open_default(path).unwrap();
db.put(b"my key", b"my value").unwrap();
match db.get(b"my key") {
Ok(Some(value)) => println!("retrieved value {}", String::from_utf8(value).unwrap()),
Ok(None) => println!("value not found"),
Err(e) => println!("operational problem encountered: {}", e),
}
db.delete(b"my key").unwrap();
}
let _ = DB::destroy(&Options::default(), path);
Opening a database and a single column family with custom options:
use rust_rocksdb::{DB, ColumnFamilyDescriptor, Options};
let tempdir = tempfile::Builder::new()
.prefix("_path_for_rocksdb_storage_with_cfs")
.tempdir()
.expect("Failed to create temporary path for the _path_for_rocksdb_storage_with_cfs.");
let path = tempdir.path();
let mut cf_opts = Options::default();
cf_opts.set_max_write_buffer_number(16);
let cf = ColumnFamilyDescriptor::new("cf1", cf_opts);
let mut db_opts = Options::default();
db_opts.create_missing_column_families(true);
db_opts.create_if_missing(true);
{
let db = DB::open_cf_descriptors(&db_opts, path, vec![cf]).unwrap();
}
let _ = DB::destroy(&db_opts, path);
Re-exports§
pub use crate::compaction_filter::Decision as CompactionDecision;
pub use crate::merge_operator::MergeOperands;
pub use crate::perf::PerfContext;
pub use crate::perf::PerfMetric;
pub use crate::perf::PerfStatsLevel;
Modules§
- Implementation of bindings to RocksDB Checkpoint1 API
- rustic merge operator
- Properties
Structs§
- For configuring block-based file storage.
- A specialized opaque type used to represent a column family by the
MultiThreaded
mode. Clone (and Copy) is derived to behave like&ColumnFamily
(this is used for single-threaded mode).Clone
/Copy
is safe because this lifetime is bound to DB like iterators/snapshots. On top of it, this is as cheap and small as&ColumnFamily
because this only has a single pointer-wide field. - An opaque type used to represent a column family. Returned from some functions, and used in others
- A descriptor for a RocksDB column family.
- Configuration of cuckoo-based storage.
- A helper type to implement some common methods for
DBWithThreadMode
andOptimisticTransactionDB
. - An iterator over a database or column family, with specifiable ranges and direction.
- Represents a path where sst files can be put into
- Wrapper around RocksDB PinnableSlice struct.
- An iterator over a database or column family, with specifiable ranges and direction.
- Iterates the batches of writes since a given sequence number.
- An Env is an interface used by the rocksdb implementation to access operating system functionality like the filesystem etc. Callers may wish to provide a custom Env object when opening a database to get fine gain control; e.g., to rate limit file system operations.
- A simple wrapper round a string, used for errors reported from ffi calls.
- Optionally wait for the memtable flush to be performed.
- For configuring external files ingestion.
- The metadata that describes a SST file
- Actual marker type for the marker trait
ThreadMode
, which holds a collection of column families wrapped in a RwLock to be mutated concurrently. The other mode isSingleThreaded
. - Database-wide options around performance and behavior.
- Used with DBOptions::set_plain_table_factory. See official wiki for more information.
- Representation of a range of keys starting with given prefix.
- Actual marker type for the marker trait
ThreadMode
, which holds a collection of column families without synchronization primitive, providing no overhead for the single-threaded column family alternations. The other mode isMultiThreaded
. - A
SliceTransform
is a generic pluggable way of transforming one string to another. Its primary use-case is in configuring rocksdb to store prefix blooms by setting prefix_extractor in ColumnFamilyOptions. - A consistent view of the database at the point of creation.
- SstFileWriter is used to create sst files that can be added to database later All keys in files generated by SstFileWriter will have sequence number = 0.
- RocksDB Transaction.
- RocksDB TransactionDB.
- An atomic batch of write operations.
- Optionally disable WAL or sync for this write.
Enums§
- Used by BlockBasedOptions::set_index_type.
- Used by BlockBasedOptions::set_checksum_type.
- Used by BlockBasedOptions::set_data_block_index_type.
- RocksDB error kind.
- Used in
PlainTableFactoryOptions
. - Defines the underlying memtable implementation. See official wiki for more information.
Constants§
- The name of the default column family.
Traits§
- Utility trait to accept both supported references to
ColumnFamily
(&ColumnFamily
andBoundColumnFamily
) - Value which can be converted into a C string.
- Minimal set of DB-related methods, intended to be generic over
DBWithThreadMode<T>
. Mainly used internally - A range which can be set as iterate bounds on
crate::ReadOptions
. - Marker trait to specify single or multi threaded column family alternations for
DBWithThreadMode<T>
- Receives the puts and deletes of a write batch.
Type Aliases§
- Handy type alias to hide actual type difference to reference
ColumnFamily
depending on themulti-threaded-cf
crate feature. - A type alias to DB instance type with the single-threaded column family creations/deletions
- A type alias to keep compatibility. See
DBIteratorWithThreadMode
for details - A type alias to keep compatibility. See
DBRawIteratorWithThreadMode
for details - A type alias to RocksDB database.
- A type alias to RocksDB Optimistic Transaction DB.
- A type alias to keep compatibility. See
SnapshotWithThreadMode
for details - A type alias to keep compatibility. See
WriteBatchWithTransaction
for details