设置时间序列集合 (TTL) 的自动删除
创建时间序列集合时,可以使用 expireAfterSeconds
参数设置自动删除超过指定秒数的文档:
db.createCollection( "weather24h", { timeseries: { timeField: "timestamp", metaField: "metadata", granularity: "hours" }, expireAfterSeconds: 86400 } )
过期阈值为 timeField
字段值加上指定的秒数。考虑 weather24h
集合中的以下文档:
{ "metadata": {"sensorId": 5578, "type": "temperature"}, "timestamp": ISODate("2021-05-18T10:00:00.000Z"), "temp": 12 }
此文档将于 "2021-05-19T10:00:00.000Z"
在数据库中过期。一旦存储桶中的所有文档都过期,删除过期存储桶的后台任务就会在下次运行期间删除该存储桶。更多信息请参阅删除操作的时间。
对集合启用自动删除
要启用自动删除现有时间序列集合的文档,请发出以下 collMod
命令:
db.runCommand({ collMod: "weather24h", expireAfterSeconds: 604801 })
更改 expireAfterSeconds
参数
要更改 expireAfterSeconds
参数值,请发出以下 collMod
命令:
db.runCommand({ collMod: "weather24h", expireAfterSeconds: 604801 })
检索当前值 expireAfterSeconds
要检索 expireAfterSeconds
的当前值,请使用 listCollections
命令:
db.runCommand( { listCollections: 1 } )
结果文档包含时间序列集合的文档,其中包含 options.expireAfterSeconds
字段。
{ cursor: { id: <number>, ns: 'test.$cmd.listCollections', firstBatch: [ { name: <string>, type: 'timeseries', options: { expireAfterSeconds: <number>, timeseries: { ... } }, ... }, ... ] } }
禁用自动删除
要禁用自动删除,请使用 collMod
命令将 expireAfterSeconds
设置为 off
:
db.runCommand({ collMod: "weather24h", expireAfterSeconds: "off" })
行为
删除操作的时机
MongoDB 不保证过期数据会在过期后立即删除。一旦存储桶中的所有文档都过期,删除过期存储桶的后台任务就会在下次运行期间删除该存储桶。允许单个存储桶覆盖的最大时间跨度由时间序列集合的 granularity
控制:
granularity | 覆盖的时间跨度 |
---|---|
| 一小时 |
| 24 小时 |
| 30天 |
删除过期存储桶的后台任务每 60 秒运行一次。因此,在文档到期、存储桶中所有其他文档到期和后台任务运行之间的这段时间内,文档可能会保留在集合中。
由于删除操作的持续时间取决于 mongod 实例的工作负载,因此过期数据可能会在后台任务运行之间的 60 秒以后持续一段时间。