cursor.maxTimeMS()

会话空闲超时重写 maxTimeMS

MongoDB 驱动程序和mongosh将所有操作与服务器会话关联，但未确认的写入操作除外。对于未显式与会话关联的操作（即使用Mongo.startSession() ），MongoDB 驱动程序和mongosh创建隐式会话并将其与操作关联。

如果会话空闲时间超过30分钟，MongoDB Server 会将该会话标记为已过期，并可能随时将其关闭。当 MongoDB 服务器关闭会话时，它还会终止任何正在进行的操作并打开与会话关联的游标。这包括配置有noCursorTimeout()或大于30分钟的maxTimeMS()的游标。

例如，考虑一个find() maxTimeMS()31操作，其中 配置为cursor.batchSize() 分钟的超时。服务器返回一个游标以及一批由 的find() 定义的文档。每次应用程序从服务器请求一批新文档时，会话都会刷新。但是，如果应用程序处理当前批次文档的时间超过30 分钟，则会话将被标记为已过期并关闭。当服务器关闭会话时，它也会终止游标， 尽管 maxTimeMS()将游标配置为大于30 分钟的 。当应用程序请求下一批文档时，服务器会返回错误。

对于返回游标的操作，如果游标的空闲时间可能超过 30 分钟，则使用 Mongo.startSession() 在显式会话中发出操作，并使用 refreshSessions 命令定期刷新会话。例如：

var session = db.getMongo().startSession()
var sessionId = session
sessionId  // show the sessionId
var cursor = session.getDatabase("examples").getCollection("data").find().noCursorTimeout()
var refreshTimestamp = new Date() // take note of time at operation start
while (cursor.hasNext()) {
  // Check if more than 5 minutes have passed since the last refresh
  if ( (new Date()-refreshTimestamp)/1000 > 300 ) {
    print("refreshing session")
    db.adminCommand({"refreshSessions" : [sessionId]})
    refreshTimestamp = new Date()
  }
  // process cursor normally
}

在示例操作中， db.collection.find()方法与显式会话关联。为游标配置了cursor.maxTimeMS() ，以使游标保持打开状态至少31分钟。 while循环包含一个区块，该区块使用refreshSessions每5分钟刷新一次会话。由于会话永远不会超过30分钟的空闲超时，因此游标可以在配置的maxTimeMS()之前保持打开状态。

对于 MongoDB 驱动程序，请参阅驱动程序文档以获取创建会话的说明和语法。