cursor.maxAwaitTimeMS() (método mongosh)

Definición

cursor.maxAwaitTimeMS(<time limit>)

Importante

Método mongosh

Esta página documenta un método.mongosh Esta no es la documentación de un controlador específico de un lenguaje, como Node.js.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Especifica el tiempo máximo que el servidor debe esperar nuevos documentos que coincidan con una query de cursor con seguimiento en una colección con tamaño fijo. Para obtener más información sobre cómo iterar un cursor devuelto por una query, consulta: Itera un cursor en mongosh.

El método tiene la siguiente forma de maxAwaitTimeMS() prototipo:

db.collection.find(
   { <query> },
   { <projection> }
).tailable( { awaitData: true } ).maxAwaitTimeMS( <milliseconds> )

El método tiene el siguiente maxAwaitTimeMS() parámetro:

Parameter	Tipo	Descripción
`milliseconds`	entero	Especifica un tiempo máximo de espera para los nuevos documentos.

Importante

Este método,, establece unmaxAwaitTimeMS() límite sobre cuánto tiempo espera un cursor rastreable la siguiente respuesta. maxTimeMS() establece un límite sobre el tiempo total de procesamiento.

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

Nota

Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre la compatibilidad de Atlas con todos los comandos, consulte Comandos no compatibles.

MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Ejemplo

Query la limitada sales colección para encontrar los totales semanales de ventas del agente Mary Kay:

db.sales.find(
   { agent: "Mary Kay" },
   { _id: 0, agent: 1, weeklyTotal: 1  }
).tailable( { awaitData: true } ).maxAwaitTimeMS( 1000 )

La línea resaltada crea un cursor rastreable en la sales colección. El establece un tiempo máximo de espera de un segundo para la siguiente actualización del maxAwaitTimeMS() cursor.

Volver

cursor.max

cursor.maxTimeMS