Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

cursor.maxAwaitTimeMS()

Nesta página

Definição

Exemplo

Definição

cursor.maxAwaitTimeMS(<time limit>)

Importante

Método mongosh

Esta página documenta um método mongosh . Esta não é a documentação para um driver específico de idioma, como Node.js.

Para drivers de API do MongoDB, consulte a documentação do driver MongoDB específica do idioma.

Especifica o tempo máximo para o servidor esperar por novos documentos que correspondam a uma query de cursor persistente em uma collection limitada. Para obter mais informações sobre a iteração de um cursor retornado por uma query, consulte: Iterar um cursor em mongosh.

O método maxAwaitTimeMS() tem a seguinte forma de protótipo:

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

O método maxAwaitTimeMS() tem o seguinte parâmetro:

Parâmetro	Tipo	Descrição
`milliseconds`	inteiro	Especifica um tempo máximo de espera para novos documentos.

Importante

Este método, maxAwaitTimeMS(), define um limite para o tempo que um cursor tailable espera pela próxima resposta. maxTimeMS() define um limite no tempo total de processamento.

Exemplo

Query a collection limitada sales para encontrar os totais de vendas semanais do agente Mary Key:

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

A linha destacada cria um cursor tailable na coleção sales . O maxAwaitTimeMS() define um tempo máximo de espera de um segundo para a próxima atualização do cursor.

← cursor.max()

cursor.maxTimeMS() →