Menu Docs

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

cursor.allowDiskUse()

Nesta página

  • Definição
  • Comportamento
  • Exemplo

Definição

cursor.allowDiskUse()

Importante

Método mongosh

Este é um método mongosh . Esta não é a documentação de Node.js ou de outros métodos de driver específicos da linguagem de programação.

Na maioria dos casos, métodos mongosh funcionam da mesma forma que os métodos legados do shell mongo . No entanto, alguns métodos legados não estão disponíveis em mongosh.

Para a documentação do shell legado mongo, consulte a documentação para a release correspondente do MongoDB Server:

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

allowDiskUse() permite que o MongoDB use arquivos temporários no disco para armazenar dados que excedam o limite de memória do sistema de megabytes 100 ao processar uma ordenador bloqueante. Se o MongoDB exigir o uso de mais de 100 megabytes de memória do sistema para a operação de ordenador bloqueante, o MongoDB retornará um erro a menos que a query especifique cursor.allowDiskUse().

allowDiskUse() tem o seguinte formato:

db.collection.find(<match>).sort(<sort>).allowDiskUse()

Consulte Uso de classificação e indexação para obter mais informações sobre o ordenador bloqueante.

Comportamento

Suporta somente classificações grandes não indexadas

cursor.allowDiskUse() não tem efeito sobre operações de classificação respondidas usando um índice ou operações de classificação não indexadas ("bloqueio") que exigem menos de 100 megabytes de memória. Para obter uma documentação mais completa sobre o ordenador bloqueante e o uso de índices de classificação, consulte Uso de classificação e índice.

Para verificar se o MongoDB deve executar uma ordenação bloqueante, acrescente cursor.explain() à query e verifique os resultados explicativos. Se o plano de query contiver um estágio SORT, o MongoDB deverá executar uma operação de classificação de bloqueio sujeita ao limite de memória de 100 megabyte.

Exemplo

Considere uma coleção sensors com apenas o índice padrão em _id. A coleção contém documentos semelhantes aos seguintes:

{
  "sensor-name" : "TEMP-21425",
  "sensor-location" : "Unit 12",
  "reading" : {
    "timestamp" : Timestamp(1580247215, 1),
    "value" : 212,
    "unit" : "Fahrenheit"
  }
}

A seguinte operação inclui um cursor.sort() no campo reading.timestamp. A operação também inclui cursor.allowDiskUse() para dar suporte à operação de classificação.

db.sensors.find({"sensor-location" : "Unit 12"}).
  sort({"reading.timestamp" : 1}).
  allowDiskUse()

Como o reading.timestamp não está incluído em um índice, o MongoDB deve executar uma operação de classificação de bloqueio para retornar os resultados na ordem de classificação solicitada. Ao especificar allowDiskUse(), o MongoDB pode processar a operação de classificação mesmo que ela exija mais de 100 megabytes de memória do sistema. Se allowDiskUse() fosse omitido e a operação exigisse mais de 100 megabytes de memória do sistema, o MongoDB retornaria um erro.

← cursor.addOption()
cursor.allowPartialResults() →

Nesta página