Struct VectorEngineConfig 

pub struct VectorEngineConfig {
    pub default_dimension: Option<usize>,
    pub sparse_threshold: f32,
    pub parallel_threshold: usize,
    pub default_metric: DistanceMetric,
    pub max_dimension: Option<usize>,
    pub max_keys_per_scan: Option<usize>,
    pub batch_parallel_threshold: usize,
    pub search_timeout: Option<Duration>,
    pub max_index_file_bytes: Option<usize>,
    pub max_index_entries: Option<usize>,
}

Configuration for the Vector Engine.

Fields

default_dimension: Option<usize>

Default dimension for embeddings (validated on first store if set).

sparse_threshold: f32

Threshold for sparse vector detection (fraction of zeros).

parallel_threshold: usize

Batch size threshold for parallel processing.

default_metric: DistanceMetric

Default distance metric for search operations.

max_dimension: Option<usize>

Maximum allowed embedding dimension for memory safety.

max_keys_per_scan: Option<usize>

Maximum keys to return from unbounded scan operations.

batch_parallel_threshold: usize

Threshold for using parallel iteration in batch operations.

search_timeout: Option<Duration>

Search operation timeout. None means no timeout (default).

max_index_file_bytes: Option<usize>

Maximum index file size in bytes (default: 100MB).

max_index_entries: Option<usize>

Maximum entries in a loaded index (default: 1M).

Implementations

impl VectorEngineConfig

pub const fn high_throughput() -> Self

Creates a configuration optimized for high throughput workloads.

Uses a lower parallel threshold (1000) for more aggressive parallelism.

pub const fn low_memory() -> Self

Creates a configuration optimized for low memory environments.

Sets max_dimension to 4096 and max_keys_per_scan to 10,000.

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

Validates the configuration parameters.

Errors

Returns an error if any parameter is out of valid range.

pub const fn with_default_dimension(self, dim: usize) -> Self

Set the default embedding dimension.

pub const fn with_sparse_threshold(self, threshold: f32) -> Self

Set the sparse vector detection threshold (0.0-1.0).

pub const fn with_parallel_threshold(self, threshold: usize) -> Self

Set the parallel processing threshold.

pub const fn with_default_metric(self, metric: DistanceMetric) -> Self

Set the default distance metric.

pub const fn with_max_dimension(self, max: usize) -> Self

Set the maximum allowed embedding dimension.

pub const fn with_max_keys_per_scan(self, max: usize) -> Self

Set the maximum keys per scan operation.

pub const fn with_batch_parallel_threshold(self, threshold: usize) -> Self

Set the batch parallel processing threshold.

pub const fn with_search_timeout(self, timeout: Duration) -> Self

Set the search operation timeout.

pub const fn with_max_index_file_bytes(self, max_bytes: usize) -> Self

Set the maximum index file size in bytes.

pub const fn with_max_index_entries(self, max_entries: usize) -> Self

Set the maximum number of entries in a loaded index.

Trait Implementations

impl Clone for VectorEngineConfig

fn clone(&self) -> VectorEngineConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VectorEngineConfig

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

Formats the value using the given formatter.

impl Default for VectorEngineConfig

fn default() -> Self

Returns the “default value” for a type.