Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

cursor.isExhausted() (método mongosh)

cursor.isExhausted()

Importante

Método mongosh

This page documents a mongosh method. This is not the documentation for a language-specific driver, such as Node.js.

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

Retorna:

Boolean

cursor.isExhausted() returns false if documents remain in the current document batch read by the cursor. Otherwise, returns true.

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

  • MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

Observação

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

  • MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

  • MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Você pode usar isExhausted() com um cursor persistente. Um cursor persistente permanece aberto mesmo que nenhum documento permaneça no lote atual. Outros cursores são fechados automaticamente quando nenhum documento permanece.

Você não pode usar o isExhausted() com fluxos de alteração . Em vez disso, para examinar se:

Para exemplos de change stream, consulte Exemplo de Assista e Exemplo de Imagens de change stream.

Esta seção contém exemplos que usam um cursor para ler documento de uma collection com leituras de temperatura de um sensor meteorológico. Você verá exemplos de isExhausted().

1

Executar:

db.sensor.insertMany( [
{ _id: 0, temperature: 12 },
{ _id: 1, temperature: 23 }
] )
2

Crie um cursor chamado sensorCursor que leia os documento da collection sensor :

var sensorCursor = db.sensor.find()
3

Executar:

sensorCursor.count()

A saída é 2 porque há dois documento na collection.

4

Executar:

sensorCursor.next()

Saída:

{ _id: 0, temperature: 12 }
5

Executar:

sensorCursor.isExhausted()

A saída é false porque há um documento restante em sensorCursor .

6

Executar:

sensorCursor.next()

Saída:

{ _id: 1, temperature: 23 }
7

Executar:

sensorCursor.next()

Não há mais documentos e o exemplo retorna null.

8

Executar:

sensorCursor.isExhausted()

Não há mais documentos e isExhausted() retorna true.