Struct DatabaseConfig 

pub struct DatabaseConfig {
    pub group_commit: bool,
    pub memtable_size_limit: usize,
    pub wal_enabled: bool,
    pub sync_mode: SyncMode,
    pub read_only: bool,
    pub enable_ordered_index: bool,
    pub group_commit_config: GroupCommitSettings,
    pub default_index_policy: IndexPolicy,
}

Database configuration

Fields

group_commit: bool

Enable group commit for better write throughput

memtable_size_limit: usize

Maximum memory for memtables before flush (bytes)

wal_enabled: bool

Enable WAL for durability

sync_mode: SyncMode

Sync mode: fsync after every commit vs periodic

read_only: bool

Read-only mode

enable_ordered_index: bool

👎Deprecated since 0.2.0:

Use default_index_policy field instead. This field will be removed in v0.3.0. Set IndexPolicy::ScanOptimized for ordered index, WriteOptimized to disable.

Enable ordered index for O(log N) prefix scans

Deprecation Notice

DEPRECATED since 0.2.0: Use default_index_policy instead for per-table control. This field will be removed in v0.3.0.

Migration Guide

Replace:

DatabaseConfig { enable_ordered_index: true, .. }  // Old API
DatabaseConfig { enable_ordered_index: false, .. } // Old API

With:

DatabaseConfig { default_index_policy: IndexPolicy::ScanOptimized, .. }  // Ordered index enabled
DatabaseConfig { default_index_policy: IndexPolicy::WriteOptimized, .. } // Ordered index disabled

Behavior

When false, saves ~134 ns/op on writes (20% speedup) but scan_prefix becomes O(N) instead of O(log N + K).

Set to false for write-heavy workloads without range scans.

Set to false for write-heavy workloads without range scans.

group_commit_config: GroupCommitSettings

Group commit configuration

default_index_policy: IndexPolicy

Default index policy for tables not explicitly configured

This replaces the global enable_ordered_index toggle with fine-grained per-table control. Use index_registry to configure individual tables.

Policy	Insert Cost	Scan Cost	Use Case
WriteOptimized	O(1)	O(N)	High-write, rare scan
Balanced	O(1) amort	O(output+logK)	Mixed OLTP
ScanOptimized	O(log N)	O(logN + K)	Analytics, range query
AppendOnly	O(1)	O(N)	Time-series logs

Implementations

impl DatabaseConfig

pub fn throughput_optimized() -> Self

Create config optimized for throughput (Fast Mode)

• Disables ordered index (saves ~134 ns/op)
• Uses high-throughput group commit settings
• Suitable for append-only workloads

pub fn latency_optimized() -> Self

Create config optimized for latency

• Keeps ordered index for fast range scans
• Uses low-latency group commit settings
• Suitable for OLTP workloads

pub fn sqlite_compatible() -> Self

Create config matching SQLite defaults

pub fn effective_ordered_index(&self) -> bool

Get effective ordered index setting, derived from default_index_policy.

This is the shim method for the deprecated enable_ordered_index field. It returns true if the policy requires an ordered index (ScanOptimized), and false otherwise (WriteOptimized, Balanced, AppendOnly).

Policy Mapping

IndexPolicy	Returns
ScanOptimized	true
Balanced	false
WriteOptimized	false
AppendOnly	false

Note: Balanced uses lazy compaction rather than a live ordered index, so it returns false for the low-level memtable config but still supports efficient range scans via sorted runs.

Trait Implementations

impl Clone for DatabaseConfig

fn clone(&self) -> DatabaseConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DatabaseConfig

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

Formats the value using the given formatter.

impl Default for DatabaseConfig

fn default() -> Self

Returns the “default value” for a type.