如何在MongoDB中为.NET DateTimeOffset字段创建合适索引

你使用C# MongoDB驱动的Document模式序列化DateTimeOffset类型，对应的模型定义如下：

public class Foo {
    [BsonElement("time")]
    public DateTimeOffset Time { get; set; }
}

该模式下DateTimeOffset会被序列化为嵌套文档，包含三个核心字段：

• DateTime：BSON DateTime类型，存储UTC标准时间，精度为毫秒级
• Ticks：长整型，存储DateTimeOffset的完整计时周期数，精度为100纳秒
• Offset：BSON TimeSpan类型，存储时区偏移量

索引方案选择 #

1. 绝大多数业务场景：选择{"time.DateTime": 1} #

如果你的查询、排序仅需要按UTC时间维度处理，不需要精确匹配完整的DateTimeOffset实例（即不需要偏移量完全一致），也不需要毫秒以下的时间精度，选这个方案即可：

• 索引体积最小，查询性能最高
• 可以完美支持基于时间的范围查询、排序需求

2. 高精度/完全匹配场景：选择{"time.DateTime": 1, "time.Ticks": 1} #

如果你的业务需要满足以下任意一种需求，建议使用该复合索引：

• 需要精确匹配完整的DateTimeOffset值（要求时间、偏移量完全一致）
• 需要毫秒以下级别的高精度时间排序
• 需要避免DateTime字段毫秒精度截断带来的查询误差

3. 不推荐方案：{"time": 1} #

该索引是对整个time嵌套文档创建索引，只有当查询条件传入完整的嵌套文档结构时才会命中，日常查询time.DateTime、按时间排序的场景完全无法使用该索引，不建议选择。

额外说明 #

如果你的查询逻辑中经常需要搭配时区偏移量筛选，可以根据实际查询模式，把time.Offset加入复合索引来进一步优化查询性能。

内容的提问来源于stack exchange，提问作者jack