cursor.maxAwaitTimeMS() (método mongosh)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

cursor.maxAwaitTimeMS(<time limit>)

Importante

Método mongosh

Esta página documenta un método mongosh. Esta no es la documentación para un driver específico de 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 por nuevos documentos que coincidan con un Consulta de cursor adaptable en una colección limitada. Para más información sobre la iteración de un cursor devuelto por una consulta, consulte: Iterar un cursor mongosh en.

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

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

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

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

Importante

Este método,, establece unmaxAwaitTimeMS() límite en el tiempo que un cursor adaptable espera la siguiente respuesta. maxTimeMS() establece un límite en 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 el soporte de Atlas para 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

Consulta la sales colección limitada para encontrar los totales de ventas semanales 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 adaptable en la sales colección. El establece un tiempo de espera máximo de un segundo para la siguiente actualización del maxAwaitTimeMS() cursor.

Volver

cursor.max

cursor.maxTimeMS