定义
cursor.noCursorTimeout()重要
mongosh 方法
本页介绍了
mongosh方法。这不是特定于语言的驾驶员（例如 Node.js）的文档。如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。
指示服务器避免在一段时间不活动后自动关闭游标。
noCursorTimeout()方法具有以下原型形式：db.collection.find(<query>).noCursorTimeout()
兼容性
此方法可用于以下环境中托管的部署：
- MongoDB Atlas ：用于在云中部署MongoDB 的完全托管服务
MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本
行为
会话空闲超时重写 noCursorTimeout
MongoDB驱动程序和 mongosh 将所有操作与服务器会话关联，但未确认的写入操作除外。对于未显式与会话关联的操作（即使用 Mongo.startSession() ）， MongoDB驱动程序和 mongosh 会创建一个隐式会话并将其与操作关联。
如果会话空闲时间超过 30 分钟， MongoDB 服务器会将该会话标记为已过期，并可能随时将其关闭。当MongoDB服务器关闭会话时，它还会终止任何正在进行的操作并打开与会话关联的游标。这包括配置有 noCursorTimeout() 或大于 30 分钟的 maxTimeMS() 的游标。
考虑一个使用 cursor.noCursorTimeout() 发出 db.collection.find() 的应用程序。服务器返回一个游标以及批处理由 find() 的 cursor.batchSize() 定义的文档。每次应用程序从服务器请求批处理新文档时，会话都会刷新。但是，如果应用程序进程当前批处理文档的时间超过 30 分钟，则会话将被标记为已过期并关闭。当服务器关闭会话时，尽管游标配置为noCursorTimeout()，但它也会终止游标。当应用程序请求下批处理文档时，服务器会返回错误。
刷新游标 refreshSessions
对于返回游标的操作，如果游标的空闲时间可能超过 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.noCursorTimeout()，以防止服务器在空闲时关闭游标。 while 循环包含一个区块，该区块使用 refreshSessions 每 5 分钟刷新一次会话。由于会话永远不会超过 30 分钟的空闲超时，因此游标可以无限期地保持打开状态。