Module index_compactor 

Index Compactor

HNSW indexes accumulate deleted vectors over time that waste memory and degrade query performance. This module identifies fragmented indexes and coordinates rebuilds based on configurable compaction policies.

Overview

• CompactionPolicy — configures when compaction should be triggered
• IndexFragmentStats — captures fragmentation metrics for a single index
• IndexCompactor — analyzes indexes and produces CompactionPlans
• CompactionPlan — describes the planned compaction and its expected impact
• CompactorStats — atomic counters tracking compactor activity

Structs

CompactionPlan

A concrete recommendation to compact an index, including estimated impact.

CompactionPolicy

Configures the triggers that cause IndexCompactor to recommend a compaction.

CompactorStats

Thread-safe counters tracking compactor activity.

CompactorStatsSnapshot

A snapshot of CompactorStats counters taken at a point in time.

IndexCompactor

Analyses HNSW index fragmentation and recommends compaction plans.

IndexFragmentStats

Statistics describing the fragmentation state of a single HNSW index.

Enums

CompactionPriority

How urgently a compaction should be scheduled.

CompactionReason

The primary reason a compaction was recommended.