Struct Config 

pub struct Config {

    pub graph_model: GraphModel,
    pub path: Option<PathBuf>,
    pub memory_limit: Option<usize>,
    pub spill_path: Option<PathBuf>,
    pub threads: usize,
    pub wal_enabled: bool,
    pub wal_flush_interval_ms: u64,
    pub backward_edges: bool,
    pub query_logging: bool,
    pub adaptive: AdaptiveConfig,
    pub factorized_execution: bool,
    pub wal_durability: DurabilityMode,
    pub storage_format: StorageFormat,
    pub schema_constraints: bool,
    pub query_timeout: Option<Duration>,
    pub gc_interval: usize,
}

Database configuration.

Fields

graph_model: GraphModel

Graph data model (LPG or RDF). Immutable after database creation.

path: Option<PathBuf>

Path to the database directory (None for in-memory only).

memory_limit: Option<usize>

Memory limit in bytes (None for unlimited).

spill_path: Option<PathBuf>

Path for spilling data to disk under memory pressure.

threads: usize

Number of worker threads for query execution.

wal_enabled: bool

Whether to enable WAL for durability.

wal_flush_interval_ms: u64

WAL flush interval in milliseconds.

backward_edges: bool

Whether to maintain backward edges.

query_logging: bool

Whether to enable query logging.

adaptive: AdaptiveConfig

Adaptive execution configuration.

factorized_execution: bool

Whether to use factorized execution for multi-hop queries.

When enabled, consecutive MATCH expansions are executed using factorized representation which avoids Cartesian product materialization. This provides 5-100x speedup for multi-hop queries with high fan-out.

Enabled by default.

wal_durability: DurabilityMode

WAL durability mode. Only used when wal_enabled is true.

storage_format: StorageFormat

Storage format for persistent databases.

Auto (default) detects the format from the path: .grafeo extension uses single-file format, directories use the legacy WAL directory.

schema_constraints: bool

Whether to enable catalog schema constraint enforcement.

When true, the catalog enforces label, edge type, and property constraints (e.g. required properties, uniqueness). The server sets this for JSON Schema databases and populates constraints after creation.

query_timeout: Option<Duration>

Maximum time a single query may run before being cancelled.

When set, the executor checks the deadline between operator batches and returns QueryError::timeout() if the wall-clock limit is exceeded. None means no timeout (queries may run indefinitely).

gc_interval: usize

Run MVCC version garbage collection every N commits.

Old versions that are no longer visible to any active transaction are pruned to reclaim memory. Set to 0 to disable automatic GC.

Implementations

impl Config

pub fn in_memory() -> Self

Creates a new configuration for an in-memory database.

pub fn persistent(path: impl Into<PathBuf>) -> Self

Creates a new configuration for a persistent database.

pub fn with_memory_limit(self, limit: usize) -> Self

Sets the memory limit.

pub fn with_threads(self, threads: usize) -> Self

Sets the number of worker threads.

pub fn without_backward_edges(self) -> Self

Disables backward edges.

pub fn with_query_logging(self) -> Self

Enables query logging.

pub fn with_memory_fraction(self, fraction: f64) -> Self

Sets the memory budget as a fraction of system RAM.

pub fn with_spill_path(self, path: impl Into<PathBuf>) -> Self

Sets the spill directory for out-of-core processing.

pub fn with_adaptive(self, adaptive: AdaptiveConfig) -> Self

Sets the adaptive execution configuration.

pub fn without_adaptive(self) -> Self

Disables adaptive execution.

pub fn without_factorized_execution(self) -> Self

Disables factorized execution for multi-hop queries.

This reverts to the traditional flat execution model where each expansion creates a full Cartesian product. Only use this if you encounter issues with factorized execution.

pub fn with_graph_model(self, model: GraphModel) -> Self

Sets the graph data model.

pub fn with_wal_durability(self, mode: DurabilityMode) -> Self

Sets the WAL durability mode.

pub fn with_storage_format(self, format: StorageFormat) -> Self

Sets the storage format for persistent databases.

pub fn with_schema_constraints(self) -> Self

Enables catalog schema constraint enforcement.

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

Sets the maximum time a query may run before being cancelled.

pub fn with_gc_interval(self, interval: usize) -> Self

Sets the MVCC garbage collection interval (every N commits).

Set to 0 to disable automatic GC.

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

Validates the configuration, returning an error for invalid combinations.

Called automatically by GrafeoDB::with_config().

Errors

Returns ConfigError if any setting is invalid.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.