时间序列集合限制
在此页面上
时间序列集合的行为通常与常规集合相同,但有一些限制。
不支持的功能
MongoDB不支持时间序列集合的以下功能:
聚合 $merge
不能使用$merge
聚合阶段将其他集合中的数据添加到时间序列集合中。使用$out
聚合阶段将文档写入时间序列集合。
您可以使用$merge
将数据从一个时间序列集合移动到另一个集合。
distinct 命令
由于时间序列集合的独特数据结构, MongoDB无法为非重复值有效地对其进行索引。避免对时间序列集合使用distinct
命令或db.collection.distinct()
辅助方法。相反,请使用$group
聚合按不同值对文档进行群组。
示例,要查询文档上的不同meta.type
值,其中meta.project = 10
,而不是:
db.foo.distinct("meta.type", {"meta.project": 10})
使用:
db.foo.createIndex({"meta.project":1, "meta.type":1}) db.foo.aggregate([{$match: {"meta.project": 10}}, {$group: {_id: "$meta.type"}}])
其工作原理如下:
地理空间查询
时间序列集合仅支持 聚合阶段,用于对针对2 dsphere$geoNear
索引的查询中的$near
地理空间数据 进行排序。不能对时间序列集合使用 和$nearSphere
操作符
文档大小
时间序列集合中文档的最大大小为 4 MB。
扩展日期范围
如果时间序列集合包含时间戳在 1970-01-01T00:00:00.000Z
之前或 2038-01-19T03:14:07.000Z
之后为 timeField
的文档,则 TTL“生存时间”功能不会从集合中删除任何文档。
有关 TTL 删除的详细信息,请参阅通过设置 TTL 使集合中的数据过期。
如果您的时间序列集合包含timeField
时间戳早于1970-01-01T00:00:00.000Z
或晚于2038-01-19T03:14:07.000Z
的文档,请在timeField
上创建索引以优化查询。
更新
更新命令必须满足以下要求:
您只能匹配
metaField
字段值。您只能修改
metaField
字段值。您的更新文档只能包含更新操作符表达式。
您的更新命令不得限制要更新的文档数量。设置
multi: true
或使用updateMany()
方法。更新命令不得设置 upsert: true。
要自动删除旧数据,请设置自动删除 (TTL)。
时间序列二级索引
MongoDB部分支持时间序列集合上的以下索引:
MongoDB不支持时间序列集合上的以下索引类型:
如果 时间序列集合 上有 二级索引 ,并且需要降级特征兼容性版本 (fCV),则必须先删除与降级 fCV 不兼容的所有二级索引。有关更多信息,请参阅setFeatureCompatibilityVersion
。
固定大小集合
不能将时间序列集合创建为固定大小集合。
修改集合类型
只有在创建集合时才能设置集合类型:
您无法将现有集合转换为时间序列集合。
不能将时间序列集合转换为其他集合类型。
要将数据从现有集合移动到时间序列集合,请将数据迁移到时间序列集合。
修改timeField
和metaField
您只能在创建集合时设置集合的 timeField
和 metaField
参数。您无法在后续修改这些参数。
粒度
存储桶大小
对于粒度参数的任何配置,存储桶的最大大小为 1000 个测量值或 125KB 数据,以较小者为准。MongoDB 还可以对具有许多唯一值的高关联基数数据强制实施较低的最大大小,以便存储桶的工作集适合 WiredTiger 缓存。
修改分桶参数
设立集合的granularity
或自定义分桶参数bucketMaxSpanSeconds
和bucketRoundingSeconds
后,您可以增加但不能减少存储桶涵盖的时间跨度。使用collMod
命令修改参数。示例:
db.runCommand({ collMod: "timeseries", timeseries: { bucketMaxSpanSeconds: 3600, bucketRoundingSeconds: 3600 } })
注意
bucketMaxSpanSeconds
和 bucketRoundingSeconds
必须相等。如果修改一个参数,则还须将另一个参数设为同一值。
分片
时间序列集合受到多项分片限制。
分片管理命令
您无法在分片的时间序列集合上运行分片管理命令。
分片密钥字段
对时间序列集合进行分片时,您只能为分片键指定以下字段:
使用
metaField
子字段
metaField
使用
timeField
您可以在分片键中指定这些字段的组合。不允许在分片键模式中使用任何其他字段,包括 _id
。
在您指定分片键时:
提示
避免仅指定 timeField
作为分片键。由于 timeField
是单调增加的,因此,可能导致所有写入都出现在集群中的单个数据段上。理想情况下,数据均匀分布在数据段之间。
要了解如何最好地选择分片键,请参阅:
从MongoDB 8.0开始,不推荐使用timeField
作为时间序列集合中的分分片键。
重新分片
您无法对分片的时间序列集合进行重新分片。但是,您可以优化其分片键。
事务
无法在事务中写入时间序列集合。
注意
MongoDB支持从事务中的时间序列集合读取。
视图
时间序列集合是可写的非物化视图。视图限制将应用于时间序列集合。
您无法从时间序列存储桶集合命名空间(即前缀为
system.buckets
的集合)创建视图。
快照隔离
只有在读取操作中未并发对集合进行删除或重命名操作的情况下,对具有读关注 "snapshot"
的时间序列集合进行的读取操作才能保证快照隔离。在同一命名空间上以不同的粒度设置重新创建时间序列集合不会产生完全的快照隔离。