Configuration Reference

DataVo configuration starts with DataVoConfig. Most applications only need to choose a storage mode, a path for persisted data, and a durability setting.

For tests and examples, use in-memory storage. It keeps the database inside the process and disappears when the context is disposed.

using DataVo.Core;
using DataVo.Core.StorageEngine.Config;

using var db = new DataVoContext(new DataVoConfig
{
    StorageMode = StorageMode.InMemory
});

For simple persistence, use disk mode and choose a storage path. WAL is enabled by default for disk mode unless explicitly overridden.

using var db = new DataVoContext(new DataVoConfig
{
    StorageMode = StorageMode.Disk,
    DiskStoragePath = "./datavo_data",
    WalEnabled = true
});

If a disk-mode workload needs stronger flush behavior, enable synchronous disk writes. This is slower, but it is the safer choice when the application cannot tolerate buffered writes being lost on a power failure.

using var db = new DataVoContext(new DataVoConfig
{
    StorageMode = StorageMode.Disk,
    DiskStoragePath = "./datavo_data",
    WalEnabled = true,
    SyncDiskWrites = true
});

For higher-throughput persisted workloads, use LSM mode. Strict fsync is the conservative durability default and the right starting point for important data.

using var db = new DataVoContext(new DataVoConfig
{
    StorageMode = StorageMode.Lsm,
    DiskStoragePath = "./datavo_lsm_data",
    LsmStrictFsync = true
});

Relaxed LSM mode is a performance setting, not the same durability contract. Use it for caches, rebuildable data, or benchmark ceilings.

using var db = new DataVoContext(new DataVoConfig
{
    StorageMode = StorageMode.Lsm,
    DiskStoragePath = "./datavo_lsm_cache",
    LsmStrictFsync = false
});

Lock acquisition has a timeout. The default is 30 seconds. Use a shorter timeout in tests when you want lock contention to fail quickly.

using var db = new DataVoContext(new DataVoConfig
{
    StorageMode = StorageMode.InMemory,
    LockAcquireTimeoutMs = 5000
});

Planner and vector knobs are available for advanced experiments. Most users should keep the defaults until they are investigating a specific query shape.

using var db = new DataVoContext(new DataVoConfig
{
    StorageMode = StorageMode.Lsm,
    DiskStoragePath = "./datavo_lsm_data",
    EnableVectorPredicateFastPath = true,
    VectorPredicateFastPathMinRows = 128,
    VectorPredicateFastPathCandidateMultiplier = 3
});

Volcano execution settings exist but should be treated as advanced planner controls in v0.1. Leave EnableVolcanoExecution off unless you are deliberately testing planner behavior.

using var db = new DataVoContext(new DataVoConfig
{
    StorageMode = StorageMode.InMemory,
    EnableVolcanoExecution = false,
    EnableVolcanoSpillGuardrails = true
});

Configuration Support

Supported settings: StorageMode.InMemory, StorageMode.Disk, and StorageMode.Lsm; DiskStoragePath; WalEnabled (on by default for disk mode); SyncDiskWrites; LsmStrictFsync; LockAcquireTimeoutMs (default 30000 ms, with -1 waiting indefinitely); and vector predicate fast-path knobs. Volcano planner knobs exist for limited planner experiments but are planned, not the default public execution path.