Localizar vários documentos
Você pode fazer query em vários documentos em uma coleção com collection.find(). O método find() utiliza um documento de query fornecido por você para corresponder ao subconjunto de documentos da coleção que correspondem à query. Se você não fornecer um documento de query (ou se fornecer um documento vazio), o MongoDB retornará todos os documentos na coleção. Para obter mais informações sobre query do MongoDB, consulte nossa documentação sobre documentos de query.
Você também pode definir opções de consulta adicionais, como sort e projection para configurar o conjunto de resultados. Você pode especificar estes no parâmetro de opções na sua chamada de método find() em objetos sort e projection. Consulte collection.find() para obter mais informações sobre os parâmetros que você pode passar para o método.
O find() método retorna um FindCursor que gerencia os resultados da sua query. Você pode iterar pelos documentos correspondentes usando um dos seguintes métodos de cursor:
next()toArray()forEach()
Se nenhum documento corresponder à query, find() retornará um cursor vazio.
Compatibilidade
Você pode utilizar o driver Node.js para conectar e utilizar o método find() para implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
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
Para saber mais sobre como localizar documentos na IU do Atlas para implantações hospedadas no MongoDB Atlas, consulte Criar, Visualizar, Atualizar e Excluir Documentos.
Exemplo
O trecho a seguir encontra documentos da coleção movies. Ele usa os seguintes parâmetros:
Um documento de query que configura a query para retornar apenas filmes com um tempo de execução de menos de 15 minutos.
Uma classificação que organiza os documentos devolvidos em ordem crescente por título (ordem alfabética em que "A" vem antes de "Z" e "1" antes de "9").
Uma projeção que exclui explicitamente o campo
_iddos documentos retornados e inclui explicitamente somente o objetotitleeimdb(e seus campos embutidos).
Observação
Você pode utilizar este exemplo para se conectar a uma instância do MongoDB e interagir com um banco de dados que contém dados de amostra. Para saber mais sobre como se conectar à sua instância do MongoDB e carregar um conjunto de dados de amostra, consulte o Guia de exemplos de uso.
Se você executar o exemplo anterior, verá a seguinte saída:
{ title: '10 Minutes', imdb: { rating: 7.9, votes: 743, id: 339976 } } { title: '3x3', imdb: { rating: 6.9, votes: 206, id: 1654725 } } { title: '7:35 in the Morning', imdb: { rating: 7.3, votes: 1555, id: 406501 } } { title: '8', imdb: { rating: 7.8, votes: 883, id: 1592502 } } ...
As opções sort e projection também podem ser especificadas como métodos (sort() e project(), respectivamente) encadeados ao método find(). Os dois comandos a seguir são equivalentes:
collection.find({ runtime: { $lt: 15 } }, { sort: { title: 1 }, projection: { _id: 0, title: 1, imdb: 1 }}); collection.find({ runtime: { $lt: 15 } }).sort({ title: 1}).project({ _id: 0, title: 1, imdb: 1 });