cursor.maxTimeMS() (método mongosh)

Modificaciones al tiempo de espera por inactividad maxTimeMS

Los controladores de MongoDB y mongosh asocian todas las operaciones con una sesión de servidor, con la excepción de las operaciones de escritura no confirmadas. Para las operaciones que no están explícitamente asociadas con una sesión (es decir, usando Mongo.startSession()), los controladores 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 caducada y puede cerrarla en cualquier momento. Al cerrar la sesión, el servidor MongoDB también finaliza las operaciones en curso y los cursores abiertos asociados a ella. Esto incluye los cursores configurados con noCursorTimeout() o con un maxTimeMS() superior a 30 minutos.

Por ejemplo, consideremos una operación find() con maxTimeMS() configurado para un tiempo de espera de 31 minutos. El servidor devuelve un cursor junto con un lote de documentos definido por cursor.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 caducada y se cierra. Cuando el servidor cierra la sesión, también elimina el cursor,a pesar de que este esté configurado con maxTimeMS() 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étodo db.collection.find() está asociado a una sesión explícita. El cursor está configurado con cursor.maxTimeMS() para permanecer abierto durante al menos 31 minutos. El bucle while incluye un bloque que utiliza refreshSessions para actualizar la sesión cada 5 minutos. Dado que la sesión nunca superará el tiempo de espera de inactividad de 30 minutos, el cursor puede permanecer abierto hasta el maxTimeMS() configurado.

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

Tiempo de espera por defecto para todas las operaciones

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