cursor.maxTimeMS() (método mongosh)

Modificaciones al tiempo de espera por inactividad maxTimeMS

Los drivers de MongoDB y mongosh asocian todas las operaciones con una sesión de servidor, con la excepción de las operaciones de escritura no reconocidas. Para las operaciones no asociadas explícitamente a una sesión (es decir, mediante Mongo.startSession()), los drivers de MongoDB y mongosh crean una sesión implícita y la asocian con la operación.

Si una sesión permanece inactiva durante más de 30 minutos, el servidor MongoDB la marca como expirada y puede cerrarla en cualquier momento. Al cerrar la sesión, también elimina cualquier operación en curso y los cursores abiertos asociados a ella. Esto incluye los cursores configurados con noCursorTimeout() o un superior maxTimeMS() a 30 minutos.

Por ejemplo, considere una operaciónfind()con elmaxTimeMS()configurado para un tiempo de espera de 31 minutos. El servidor devuelve un cursor junto con un lote de documentos definido por elcursor.batchSize()defind(). La sesión se actualiza cada vez que la aplicación solicita un nuevo lote de documentos al servidor. Sin embargo, si la aplicación tarda más de 30 minutos en procesar el lote actual de documentos, la sesión se marca como expirada y se cierra. Al cerrar la sesión, el servidor también elimina el cursor, a pesar de que este esté configurado conmaxTimeMS()mayor que 30 minutos. Cuando la aplicación solicita el siguiente lote de documentos, el servidor devuelve un error.

Para las operaciones que devuelven un cursor, si el cursor puede estar inactivo durante más de 30 minutos, emite la operación dentro de una sesión explícita utilizando Mongo.startSession() y actualiza periódicamente la sesión utilizando el comando refreshSessions. Por ejemplo:

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
}

En la operación de ejemplo, el métododb.collection.find()está asociado a una sesión explícita. El cursor está configurado concursor.maxTimeMS()para mantenerlo abierto durante al menos 31 minutos. El bucle while incluye un bloque que usarefreshSessionspara refrescar la sesión cada 5 minutos. Dado que la sesión nunca superará el tiempo de inactividad de 30 minutos, el cursor puede permanecer abierto hasta el valor configurado demaxTimeMS().

Para los controladores de MongoDB, consulta la documentación del controlador para obtener instrucciones y la sintaxis para crear sesiones.

Tiempo de espera predeterminado para todas las operaciones

A partir de MongoDB,8.0 puede usar el defaultMaxTimeMS parámetro de clúster para especificar un límite de tiempo predeterminado para que se completen las operaciones de lectura individuales. Si una consulta especifica la maxTimeMS() opción, ese valor anula el defaultMaxTimeMS valor.