SegmentIndex Architecture

This section describes the top-level index orchestration layer: how operations are routed, cached, and executed across segments.

Segment internals are intentionally centralized in Segment Architecture to avoid duplication.

Topics

• Read Path — request routing and lookup flow.
• Write Path — buffering, flush, compaction, and split orchestration.
• Range-Partitioned Ingest — proposed partition-oriented write architecture with bounded mutable/immutable layers.
• Range-Partitioned Ingest Implementation Notes — current runtime contract, drain semantics, and config migration notes.
• Caching Strategy — index-level cache roles and sizing.
• Cache LRU — bounded LRU behavior and trade-offs.
• Performance Model & Sizing — throughput/latency model and tuning knobs.
• Metrics Snapshot — stable index telemetry contract.
• Segment Index Concurrency — index thread-safety and lifecycle behavior, including OPENING, READY, CLOSING, CLOSED, and ERROR.