Bucket reopening and the {metaField, timeField} index requirement
Parent: Bucket fragmentation remediation (re-insert/merge) · Published reference · snapshot 2026-10-23 · skill mongodb-cohort-3a39b842dcf7
↓ Facts as markdownall context files
Source-anchored research for Bucket reopening and the {metaField, timeField} index requirement. Run status: COMPLETED.
These notes link each claim to its source. Some citations identify archived research reports that are no longer hosted on this site. A published reference means the content is available; it does not certify independent review or accuracy.Read the editorial policy and follow the sources before relying on a claim.
How it works
- The query-based reopening path looks for a bucket with an exact metaField match, a timeField range, bucket count and size limits, and control.closed missing or false. MongoDB's server README says this lookup relies on a {metaField: 1, timeField: 1} index for efficient execution and is not used when that index is absent. (medium confidence) [source]
Comparisons and alternatives
- SERVER-95067 lists {timeField: 1}, rather than a compound metaField/timeField index, as the query-based-reopening index when a time-series collection has no metaField. (low confidence) (verified as of 2026-10-23) [source]
- OneUptime's time-series compression article says out-of-order or backfill inserts can reopen closed buckets or create new small buckets, which can degrade compression; it presents this as a workload risk rather than a guaranteed result. (low confidence) (verified as of 2026-04-12) [source]
Facts and statements
- MongoDB's server README distinguishes archive-based reopening, which can identify a bucket by its _id, from query-based reopening; the missing compound index disables the query path, not every route for reopening a bucket. (medium confidence) (verified as of 2026-10-20) [source]
- MongoDB documents the default {metaField: 1, timeField: 1} compound index as new in 6.3, and the server README says it is created for new collections in 6.3 and later; operators should verify the index on collections created before that default existed. (high confidence) (verified as of 2026-10-14) [source]
- A historical MongoDB issue report says the query-reopening index participated in a lost-first-document defect only with retryable unordered multi-document inserts that concurrently targeted the same bucket on versions 7.0.0–7.0.15 and 8.0.0–8.0.3; it reports fixes in 7.0.16 and 8.0.4, so its workaround to drop the index applies only to those affected versions. (low confidence) (verified as of 2025-01-29) [source]
- For time-series collections with a configured metaField, query-based reopening searches for a disk bucket using exact metadata equality and a timeField range, and relies on the {metaField: 1, timeField: 1} index; if that index is absent, MongoDB does not use query-based reopening. (high confidence) (verified as of 2026-10-20) [source]
- Percona's 2021 MongoDB 5.0 article describes automatic timeField indexing and an optional metaField, while MongoDB's manual dates the default metaField/timeField compound index to version 6.3; the default compound-index rule must therefore be scoped by release. (medium confidence) (verified as of 2026-10-14) [source]
Children
- No children recorded.