Struct ValueLog 

pub struct ValueLog { /* private fields */ }

Value log for storing large values

Implementations

impl ValueLog

pub fn new(vlog_dir: impl AsRef<Path>) -> Result<Self>

Create a new value log with default configuration

pub fn with_config(config: ValueLogConfig) -> Result<Self>

Create a new value log with custom configuration

pub fn should_separate(&self, value: &CipherBlob) -> bool

Check if a value should be stored in vLog

pub fn append(&self, key: Key, value: CipherBlob) -> Result<ValuePointer>

Append a value to the vLog and return a pointer

pub fn read(&self, pointer: &ValuePointer) -> Result<CipherBlob>

Read a value from the vLog using a pointer

pub fn flush(&self) -> Result<()>

Flush buffered writes

pub fn current_file_id(&self) -> u64

Get current file ID

pub fn config(&self) -> &ValueLogConfig

Get configuration

pub fn garbage_collect<F>(&self, file_id: u64, is_live_fn: F) -> Result<GcStats>

where F: Fn(&Key) -> bool,

Perform garbage collection on a vLog file

Scans the file and rewrites live values to a new file, discarding dead values. This is typically called when a file has too much garbage.

is_live_fn: Function that checks if a key is still live in the LSM-Tree

pub fn calculate_garbage_ratio<F>( &self, file_id: u64, is_live_fn: F, ) -> Result<f64>

where F: Fn(&Key) -> bool,

Calculate garbage ratio for a vLog file

Returns the ratio of dead values to total values. This can be used to determine if GC is needed.