设置时间序列数据的粒度
注意
必须运行 MongoDB 5.0.1 或更高版本，才能在创建时间序列集合后更改集合的粒度。请参阅 MongoDB 5.0 已知问题。
创建时间序列集合时，请将粒度设置为与 metaField字段具有相同唯一值的连续传入测量值之间的时间跨度最接近的值：
db.createCollection( "weather24h", { timeseries: { timeField: "timestamp", metaField: "metadata", granularity: "minutes" }, expireAfterSeconds: 86400 } )
准确设置granularity参数可优化time-series collection中数据的内部存储方式，从而提高性能。
要准确设置参数，请选择最接近唯一数据源摄取速率的granularity值，该速率由metaField字段的值指定。
例如，如果您的metaField数据标识天气传感器，并且您每 5 分钟从每个传感器获取一次数据，则应选择"minutes" 。 即使您有数千个传感器，并且来自不同传感器的数据仅相隔几秒钟， granularity仍应基于由其元数据唯一标识的一个传感器的摄取率。
在下表中，您可以看到为每个granularity值一起存储的数据的最大时间跨度：
granularity | 覆盖的时间跨度 |
|---|---|
"seconds" （默认） | 一小时 |
"minutes" | 24 小时 |
"hours" | 30天 |
granularity检索时间序列集合的
要检索 granularity 的当前值，请使用 listCollections 命令：
db.runCommand( { listCollections: 1 } )
结果文档包含时间序列集合的文档，其中包含 options.timeseries.granularity 字段。
{ cursor: { id: <number>, ns: 'test.$cmd.listCollections', firstBatch: [ { name: <string>, type: 'timeseries', options: { expireAfterSeconds: <number>, timeseries: { timeField: <string>, metaField: <string>, granularity: <string>, bucketMaxSpanSeconds: <number> } }, ... }, ... ] } }
更改时间序列集合的 <a class=\" \" href=\" \" title=\" \"><svg xmlns=\" \" width=\" \" height=\" \" fill=\" \" viewbox=\" \" class=\" \" role=\" \" aria-label=\" \"><path fill=\" \" d=\" \"> <path fill=\" \" d=\" \">granularity
要更改 granularity 参数值，请发出以下 collMod 命令：
db.runCommand({ collMod: "weather24h", timeseries: { granularity: "hours" } })
设置granularity后，一次只能增加一个级别。 从"seconds"到"minutes"或从"minutes"到"hours" 。 不允许进行其他更改。 如果需要将granularity从"seconds"更改为"hours" ，请先将granularity增加到"minutes" ，然后再增加到"hours" 。