cursor.maxAwaitTimeMS() (método mongosh)

Definición

cursor.maxAwaitTimeMS(<time limit>)

Importante

Método mongosh

Esta página documenta a mongosh Método. Esta no es la documentación de un controlador específico del 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 esperará para recibir nuevos documentos que coincidan con un cursor con seguimiento query en una colección con tamaño fijo. Para obtener más información sobre cómo recorrer un cursor devuelto por una query, consulta: Recorrer 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 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, maxAwaitTimeMS(), establece un límite temporal sobre cuánto tiempo un cursor con seguimiento espera por 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

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 con seguimiento en la colección sales. El maxAwaitTimeMS() establece un tiempo máximo de espera de un segundo para la siguiente actualización del cursor.

Volver

cursor.max

cursor.maxTimeMS