cursor.maxTimeMS（）

会话空闲超时覆盖maxTimeMS¶

从MongoDB 3.6开始，MongoDB驱动程序和mongo 外壳程序将所有操作与服务器会话相关联，但未确认的写操作除外。对于未与会话明确关联的操作（即使用Mongo.startSession()），MongoDB驱动程序和mongo外壳程序会创建一个隐式会话并将其与该操作相关联。

如果会话空闲时间超过30分钟，则MongoDB服务器会将会话标记为已过期，并可以随时关闭它。当MongoDB服务器关闭会话时，它还会终止所有正在进行的操作并打开与该会话关联的游标。这包括配置了30分钟noCursorTimeout或maxTimeMS30分钟以上的光标。

例如，考虑配置为31分钟的超时的find()操作maxTimeMS。该服务器有一批由定义的文件一起返回游标cursor.batchSize()的find()。每次应用程序从服务器请求新一批文档时，会话都会刷新。但是，如果应用程序花费超过30分钟的时间来处理当前批次的文档，则该会话将被标记为已过期并关闭。当服务器关闭会话时，即使将光标配置为 maxTimeMS超过30分钟，服务器也会杀死该光标。当应用程序请求下一批文档时，服务器将返回错误。

对于返回游标的操作，如果游标可能闲置了30分钟以上，请在显式会话中使用发出操作，Session.startSession()并使用refreshSessions命令定期刷新该会话。例如：

var session = db.getMongo().startSession()
var sessionId = session.getSessionId().id

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驱动程序，请参考驱动程序文档中有关创建会话的说明和语法。