MongoDB TTL索引的使用
- 2020 年 3 月 17 日
- 筆記
目錄
一、TTL索引介紹
TTL全稱是(Time To Live),TTL索引能對一個單列配置過期屬性來
實現對文檔的自動過期刪除,我們可以在對欄位創建索引時添加expireAfterSeconds選項將索引轉換為TTL索引,該欄位需要是date類型,在以下幾種場景下即使索引設置了expireAfterSeconds屬性也不會生效
- 如果該欄位不是date類型,則文檔不會過期
- 如果文檔沒包含索引的這個欄位,則文檔不會過期
二、TTL索引運行邏輯
- MongoDB會開啟一個後台執行緒讀取該TTL索引的值來判斷文檔是否過期,但不會保證已過期的數據會立馬被刪除,因後台執行緒
每60秒觸發一次刪除任務,且如果刪除的數據量較大,會存在上一次的刪除未完成,而下一次的任務已經開啟的情況,導致過期的數據也會出現超過了數據保留時間60秒以上的現象。- 對於副本集而言,
TTL索引的後台進程只會在primary節點開啟,在從節點會始終處於空閑狀態,從節點的數據刪除是由主庫刪除後產生的oplog來做同步。- TTL索引除了有expireAfterSeconds屬性外,
和普通索引一樣。
三、TTL索引的限制
- 只支援對
單個欄位創建TTL索引,複合索引不支援expireAfterSeconds選項 _id列不支援TTL索引固定集合(capped collection)不支援TTL索引- 不支援用createIndex() 修改expireAfterSeconds屬性,但可以
用collMod命令修改,或者重建索引,但重建對於大集合成本較高,建議用collMod方式 - 一個列只能創建普通索引或TTL索引,
不能同時對一個列創建這2種類型索引(實際TTL索引本身就是普通索引,只是多了一個過期屬性) - 如果一個
列已經存在索引,則需要先將該索引drop後才能重建為TTL索引,不能直接轉換
四、TTL索引的使用場景
1. 指定具體的過期時間屬性
該場景是在創建索引時明確指定一個expireAfterSeconds時間作為文檔的過期時間
// 對log_events集合的createdAt欄位創建TTL索引且設置expireAfterSeconds過期時間為3600秒(1小時) onepiece:PRIMARY> db.log_events.createIndex( { "createdAt": 1 }, { expireAfterSeconds: 3600 } ) // 對文檔插入數據,包含createdAt欄位,則該文檔會在1小時候欄位刪除 onepiece:PRIMARY> db.log_events.insert( { "createdAt": new Date(), "logEvent": 2, "logMessage": "Success!" } ) 2. 插入一個具體的過期時間
該場景是在創建索引時將expireAfterSeconds設置為0,在這種情況下由插入到欄位的數據來控制文檔何時過期,這種場景更加精細化,可靈活的控制文檔的過期時間及控制在業務低峰期觸發文檔過期
// 對log_events集合的expireAt創建TTL索引,並設置expireAfterSeconds屬性為0 onepiece:PRIMARY> db.log_events.createIndex( { "expireAt": 1 }, { expireAfterSeconds: 0 } ) // 對文檔插入數據,包含expireAt欄位,該文檔過期時間就是expireAt欄位記錄的時間 onepiece:PRIMARY> db.log_events.insert( { "expireAt": new Date('Jan 16, 2020 14:00:00'), "logEvent": 2, "logMessage": "Success!" } ) 3. TTL屬性的修改(collMod)
對於TTL索引的expireAfterSeconds的屬性,可以用collMod方式進行修改
// 創建TTL索引設置1小時過期屬性 onepiece:PRIMARY> db.log_events.createIndex( { "createdAt": 1 }, { expireAfterSeconds: 3600 } ) { "createdCollectionAutomatically" : true, "numIndexesBefore" : 1, "numIndexesAfter" : 2, "ok" : 1 } // 查看索引定義 onepiece:PRIMARY> db.log_events.getIndexes() [ { "v" : 2, "key" : { "_id" : 1 }, "name" : "_id_", "ns" : "test.log_events" }, { "v" : 2, "key" : { "createdAt" : 1 }, "name" : "createdAt_1", "ns" : "test.log_events", "expireAfterSeconds" : 3600 } ] // 修改索引定義,將一小時文檔過期改為60秒 onepiece:PRIMARY> db.runCommand( { collMod: "log_events", index: { keyPattern: { createdAt: 1 }, expireAfterSeconds: 60 } }) // 返回值: { "expireAfterSeconds_old" : 3600, "expireAfterSeconds_new" : 60, "ok" : 1 } 五、Date類型
Date()method which returns the current date as a string.new Date()constructor which returns a Date object using the ISODate() wrapper.ISODate()constructor which returns a Date object using the ISODate() wrapper.
onepiece:PRIMARY> Date() Thu Jan 16 2020 14:48:40 GMT+0800 (CST) onepiece:PRIMARY> new Date() ISODate("2020-01-16T06:48:48.655Z") onepiece:PRIMARY> ISODate() ISODate("2020-01-16T06:48:53.673Z") 