通过设置 TTL 使集合中的数据过期

使 MongoDB Atlas 用户界面中的文档过期

要使 Atlas 用户界面中的数据过期，请按照以下步骤操作：

在指定的秒数后使文档过期

您可以在终端中设置数据过期时间为指定秒数。若要在索引字段设置数据过期时间为指定秒数后，请在保存 BSON 日期类型值的字段，或 BSON 日期类型对象数组上创建 TTL 索引，并在 expireAfterSeconds 字段中指定一个非零的正值。当 expireAfterSeconds 字段中的秒数超过文档索引字段中指定的时间时，文档将过期失效。[1]

TTL 索引 expireAfterSeconds 值必须介于 0 和 2147483647（包含两者）之间。

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

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

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

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

当文档的 createdAt 值 [1] 早于 expireAfterSeconds 中指定的秒数时，MongoDB 将自动从 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 字段上创建索引并指定 0 的 expireAfterSeconds 值：

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

对于每个文档，将 expireAt 的值设置为与文档应过期的时间相对应。例如，下面的insertOne()操作添加了一个在July 22, 2013 14:00:00过期的文档。

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

当文档的 expireAt 值早于 expireAfterSeconds 中指定的秒数（在本例中为早于 0 秒）时，MongoDB 将自动从 log_events 集合中删除文档。 因此，数据在指定的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。如果通过将 expireAfterSeconds 设为 NaN 来配置某一 TTL 索引，则使用 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 时。

• 从前5.0 将mongodump导入 MongoDB 5.0.0 - 5 。 0 。 13 （或6 . 0 . 0 - 6 。 0 。 1 ） 实例。

为了避免出现问题，请删除或更正任何配置错误的 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();