MongoDB TTL索引的实例详解

mongodb ttl索引的实例详解

ttl索引是一种特殊类型的单字段索引，主要用于当满足某个特定时间之后自动删除相应的文档。也就是说集合中的文档有一定的有效期，超过有效期的文档就会失效，会被移除。也即是数据会过期。过期的数据无需保留，这种情形适用于如机器生成的事件数据，日志和会话信息等等。本文主要描述ttl索引的使用。

一、ttl索引

创建方法
    db.collection.createindex(keys, options)
    options:
        expireafterseconds 指定多少秒或者包含日期值的数组

创建示例
    db.eventlog.createindex( { "lastmodifieddate": 1 }, { expireafterseconds: 3600 } ) 

何时失效
    在指定的时间达到后失效，也即是索引字段的值加上一个特定的秒数之后
    如果索引字段是一个数组，即索引字段上存在着多个日期值，此时mongodb取最小值加上失效时间(lowest())
    对于非日期字段或不包含日期数组的索引字段，文档不会失效
    对于不包含索引字段的文档，文档不会失效

删除操作
    mongod的一个后台线程会读取索引的值并将失效的文档从集合移除
    当ttl线程被激活后，可以从db.currentop()或者从profile观察到删除操作

何时删除
    当基于后台方式创建索引时，ttl线程能够在索引创建期间开始删除失效文档
    当基于前台方式创建索引时，ttl线程在索引创建完成后开始删除失效文档   
    ttl索引的删除不能完全保证失效期后一定删除，存在一定延迟(取决于mongod的工作负载)
    ttl删除文档后台线程每60s移除失效文档(因此可能存在已过失效期，文档还在的情形)
    在副本集环境中，ttl后台线程仅仅在主副本上工作，辅助副本上由复制操作实现
    在使用ttl索引查询时，与使用非ttl索引一样

一些限制
    不能基于已经存在索引的字段创建ttl索引以及非日期字段创建ttl索引，文档不会失效
    ttl索引不支持基于多个字段的复合索引
    不支持定长集合

二、ttl索引示例

# mongo --shell localhost:27000 ttldata.js 
mongodb shell version: 3.2.11
connecting to: localhost:27000/test

repsettest:primary> addttltestdata() //添加集合数据
create three records in database each with a create time that is 1 minute apart
created three test documents, oldest being 4 mins old
now create a ttl index with expiry of 5 mins on the createdate field as follows
db.ttltest.ensureindex({createdate:1}, {expireafterseconds:300})

repsettest:primary> db.ttltest.find()  //当前向集合里插入了3个文档
{ "_id" : 1, "createdate" : isodate("2017-03-10t03:23:01.169z") }
{ "_id" : 2, "createdate" : isodate("2017-03-10t03:24:01.169z") }
{ "_id" : 3, "createdate" : isodate("2017-03-10t03:25:01.169z") }

//下面为测试集合上的文档添加索引，即5分钟后索引失效
repsettest:primary> db.ttltest.createindex({createdate:1}, {expireafterseconds:300})
{
    "createdcollectionautomatically" : false,
    "numindexesbefore" : 1, // author : leshami
    "numindexesafter" : 2,  // blog  : http://blog.csdn.net/leshami
    "ok" : 1
}

//查找文档
repsettest:primary> db.ttltest.find()
{ "_id" : 1, "createdate" : isodate("2017-03-10t03:23:01.169z") }
{ "_id" : 2, "createdate" : isodate("2017-03-10t03:24:01.169z") }
{ "_id" : 3, "createdate" : isodate("2017-03-10t03:25:01.169z") }

//当指定时间到期后，文档被删除，如下，查询不到任何文档
repsettest:primary> db.ttltest.find()

如有疑问请留言或者到本站社区交流讨论，感谢阅读，希望能帮助到大家，谢谢大家对本站的支持！