通过设置 TTL 从集合中过期数据

在 MongoDB Atlas UI 中过期文档

要在 Atlas UI 中过期数据，请按照以下步骤操作

指定秒数后过期文档

您可以在终端中指定秒数后过期数据。要自索引字段创建以来指定秒数后过期数据，请在一个字段上创建TTL索引，该字段包含BSON日期类型或BSON日期类型对象的数组，并在expireAfterSeconds字段中指定一个正的非零值。文档将在从其索引字段中指定的时间开始计算，经过expireAfterSeconds字段指定的秒数后过期。[1]

TTL索引的expireAfterSeconds值必须在0和2147483647之间（包括）。

例如，以下操作在log_events集合的createdAt字段上创建索引，并将expireAfterSeconds值指定为10，将过期时间设置为自createdAt指定的时间起10秒。

db.log_events.createIndex( { "createdAt": 1 }, { expireAfterSeconds: 10 } )

在向log_events集合添加文档时，将createdAt字段设置为当前时间

db.log_events.insertOne( {
   "createdAt": new Date(),
   "logEvent": 2,
   "logMessage": "Success!"
} )

MongoDB将在文档的createdAt值[1]早于在expireAfterSeconds中指定的秒数时自动删除log_events集合中的文档。

使用筛选条件过期文档

要过期具有特定筛选表达式的文档，可以创建一个既是部分索引又是TTL索引的索引。

创建部分TTL索引

db.foo.createIndex(
   { F: 1 },
   {
      name: "Partial-TTL-Index",
      partialFilterExpression: { D : 1 },
      expireAfterSeconds: 10
   }
)

插入两个文档，其中一个匹配partialFilterExpression的筛选表达式{ D : 1 }

db.foo.insertMany( [
   { "F" : ISODate("2019-03-07T20:59:18.428Z"), "D" : 3},
   { "F" : ISODate("2019-03-07T20:59:18.428Z"), "D" : 1}
] )

等待十秒钟后查询foo集合

db.foo.find({}, {_id: 0, F: 1, D: 1})

匹配{ D : 1 }的partialFilterExpression的文档被删除（过期）。因此，在foo集合中只剩下单个文档。

{ "F" : ISODate("2019-03-07T20:59:18.428Z"), "D" : 3}

在特定时钟时间过期文档

您可以在终端中指定时钟时间来过期数据。要过期特定时钟时间的文档，首先在一个包含BSON日期类型或BSON日期类型对象的数组字段的TTL索引上创建索引，并指定expireAfterSeconds值为0。对于集合中的每个文档，将索引的日期字段设置为对应于文档应该过期的值。如果索引的日期字段包含过去的日期，MongoDB认为该文档已过期。

例如，以下操作在log_events集合的expireAt字段上创建索引，并指定了expireAfterSeconds值为0

db.log_events.createIndex( { "expireAt": 1 }, { expireAfterSeconds: 0 } )

对于每个文档，将expireAt的值设置为对应于文档应该过期的值。例如，以下insertOne()操作添加一个在2013年7月22日 14:00:00过期的文档。

db.log_events.insertOne( {
   "expireAt": new Date('July 22, 2013 14:00:00'),
   "logEvent": 2,
   "logMessage": "Success!"
} )

MongoDB会在文档的expireAt值超过在expireAfterSeconds中指定的秒数时自动删除log_events集合中的文档，即在这种情况下比指定值早0秒。因此，数据在指定的expireAt值时过期。

使用NaN配置的索引

不要在TTL索引配置中将expireAfterSeconds设置为NaN。

在MongoDB 5.0之前，当TTL索引的expireAfterSeconds设置为NaN时，MongoDB会记录一个错误，并且不会删除任何记录。

从MongoDB 5.0.0 - 5.0.13（以及6.0.0 - 6.0.1）开始，NaN被视为0。如果一个TTL索引的expireAfterSeconds设置为NaN，则所有TTL索引的文档会立即过期。

从MongoDB 5.0.14（以及6.0.2）开始，服务器将不会使用将expireAfterSeconds设置为NaN的TTL索引。

然而，仍然有一些情况可能会导致意外行为。文档可能会在以下情况下过期：

• 从MongoDB 5.0.0 - 5.0.13（或6.0.0 - 6.0.1）的早期版本进行初始同步。

• 从早期版本升级到MongoDB 5.0.0 - 5.0.13。

• 从MongoDB 5.0.0 - 5.0.13（或6.0.0 - 6.0.1）的实例中恢复从5.0之前的mongodump集合。

为了避免问题，请删除或更正任何配置错误的TTL索引。

function getNaNIndexes() {
   const nan_index = [];
   const dbs = db.adminCommand({ listDatabases: 1 }).databases;
   dbs.forEach((d) => {
      if (d.name != 'local') {
         const listCollCursor = db
            .getSiblingDB(d.name)
            .runCommand({ listCollections: 1 }).cursor;
         const collDetails = {
            db: listCollCursor.ns.split(".$cmd")[0],
            colls: listCollCursor.firstBatch.map((c) => c.name),
         };
         collDetails.colls.forEach((c) =>
            db
               .getSiblingDB(collDetails.db)
               .getCollection(c)
               .getIndexes()
               .forEach((entry) => {
                  if (Object.is(entry.expireAfterSeconds, NaN)) {
                     nan_index.push({ ns: `${collDetails.db}.${c}`, index: entry });
                  }
               })
         );
      }
   });
   return nan_index;
};
getNaNIndexes();