Shuge Unlimited

Oct 16, 2026 · Databases

Why Milvus 3.0 Can't Find Just-Inserted Data: The Hidden 5-Second Consistency Window

This article explains why newly inserted vectors in Milvus 3.0 may not be immediately searchable, revealing that the default Bounded consistency level sets a 5-second grace period (GracefulTime) during which recent writes fall outside the query's guaranteed timestamp (GuaranteeTs). It details the underlying mechanisms — TSO timestamps, timetick propagation, query node water-level waiting, and the four consistency levels — and provides a troubleshooting decision tree to distinguish expected behavior from actual failures.