Struct CollectionConfig 

pub struct CollectionConfig {

    pub name: String,
    pub dimension: usize,
    pub metric: DistanceMetric,
    pub point_count: usize,
    pub schema_version: u32,
    pub storage_mode: StorageMode,
    pub metadata_only: bool,
    pub graph_schema: Option<GraphSchema>,
    pub embedding_dimension: Option<usize>,
    pub pq_rescore_oversampling: Option<u32>,
    pub hnsw_params: Option<HnswParams>,
    pub deferred_indexing: Option<DeferredIndexerConfig>,
    pub async_index_builder: Option<AsyncIndexBuilderConfig>,
}

Metadata for a collection.

Fields

name: String

Name of the collection.

dimension: usize

Vector dimension (0 for metadata-only or graph-without-embeddings collections).

metric: DistanceMetric

Distance metric.

point_count: usize

Number of points in the collection.

schema_version: u32

On-disk schema version for forward-compatibility detection.

When a newer VelesDB version writes a config.json with a higher schema version, older versions will refuse to open the collection rather than silently corrupting data.

Backward compatible: old config.json files without this field deserialize to 1 (the initial version).

storage_mode: StorageMode

Storage mode for vectors (Full, SQ8, Binary).

metadata_only: bool

Whether this is a metadata-only collection.

graph_schema: Option<GraphSchema>

Graph schema — Some iff this is a graph collection. Persisted to config.json; None for vector and metadata collections.

embedding_dimension: Option<usize>

Embedding dimension for graph node vectors (None = no embeddings). Only meaningful when graph_schema is Some.

pq_rescore_oversampling: Option<u32>

PQ rescore oversampling factor. Some(4) by default.

The search pipeline fetches max(k * factor, k + 32) candidates from HNSW and rescores them with full-precision ADC.

• None: disables rescore entirely (expert-only; risks silent recall collapse).
• Some(0): treated as disabled (equivalent to None) — the oversampling factor of 0 produces a candidates count of 0, which falls back to raw HNSW results.
• Some(n) where n > 0: enables rescore with n-fold oversampling.

hnsw_params: Option<HnswParams>

Custom HNSW index parameters (M, ef_construction, etc.).

When Some, these parameters are used to rebuild the HNSW index on collection reopen if hnsw.bin does not yet exist (empty collection). When None, the default HnswParams::auto(dimension) is used.

Backward compatible: old config.json files without this field deserialize to None.

deferred_indexing: Option<DeferredIndexerConfig>

Deferred indexing configuration (US-366).

When Some and enabled, inserts are buffered in memory and batch-merged into the HNSW index when the buffer reaches merge_threshold. This decouples write latency from index cost.

Backward compatible: old config.json files without this field deserialize to None (disabled).

async_index_builder: Option<AsyncIndexBuilderConfig>

Async index builder configuration (Issue #488 — Bulk Insert V2).

When Some, enables the AsyncIndexBuilder for deferred HNSW insertion during bulk import. Buffered vectors are flushed to the HNSW index via HnswIndex::insert_batch_parallel.

Backward compatible: old config.json files without this field deserialize to None (disabled).

Trait Implementations

impl Clone for CollectionConfig

fn clone(&self) -> CollectionConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CollectionConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CollectionConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CollectionConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.