cursor.maxTimeMS() (método mongosh)

Modificaciones al tiempo de espera por inactividad maxTimeMS

Los controladores de MongoDB y asocian todas las mongosh 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), los controladores de MongoDB Mongo.startSession() 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 superior maxTimeMS() a 30 minutos.

Por ejemplo, consideremos una find() operación con configurado para un tiempo maxTimeMS() de 31 espera de minutos. El servidor devuelve un cursor junto con un lote de documentos definido por de. 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 cursor.batchSize() find()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 mayor maxTimeMS() 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 utilizarefreshSessionspara 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 elmaxTimeMS() configurado.

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

Tiempo de espera por defecto 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 una maxTimeMS() opción, ese valor anula el defaultMaxTimeMS valor.