Página inicial do Docs → Desenvolver aplicações → Drivers Python → PyMongo
Retrieve Data
Nesta página
Visão geral
Neste guia, você pode aprender como usar o PyMongo, o driver Python síncrono do MongoDB, para recuperar dados de uma coleção do MongoDB usando operações de leitura. Você pode chamar o método find() ou find_one() para recuperar documentos que correspondam a um conjunto de critérios.
Dados de amostra
Os exemplos neste guia usam a collection sample_restaurants.restaurants dos conjuntos de dados de amostra do Atlas. Para saber como criar um MongoDB Atlas cluster gratuito e carregar os conjuntos de dados de amostra, consulte Introdução ao PyMongo.
Encontrar documentos
O PyMongo inclui dois métodos para recuperar documentos de uma collection: find_one() e find(). Esses métodos usam um filtro de query e retornam um ou mais documentos correspondentes. Um filtro de query é um objeto que especifica os documentos que você deseja recuperar em sua query.
Para saber mais sobre filtros de queries, consulte Especificar uma query.
Encontrar um documento
Para localizar um único documento em uma coleção, chame o método find_one() e passe um filtro de query que especifique os critérios do documento que você deseja localizar. Se mais de um documento corresponder ao filtro de query, esse método retornará o primeiro documento correspondente dos resultados recuperados como um dicionário Python. Se nenhum documento corresponder ao filtro de query, o método retornará None.
Dica
O método find_one() é útil quando você sabe que há apenas um documento correspondente ou só está interessado na primeira correspondência.
O exemplo a seguir usa o método find_one() para localizar o primeiro documento em que o campo "cuisine" tem o valor "Bakery":
restaurant = sample_restaurants.restaurants.find_one({"cuisine": "Bakery"})
Dica
Ordem de classificação
O método find_one() retorna o primeiro documento em ordem natural no disco se nenhum critério de classificação for especificado.
Para saber mais sobre classificação, consulte o guia de classificação .
Localizar vários documentos
Para encontrar vários documentos em uma coleção, passe um filtro de queries para o método find() que especifica os critérios dos documentos que você deseja recuperar.
O exemplo seguinte utiliza o método find() para localizar todos os documentos onde o campo "cuisine" tem o valor "Spanish":
cursor = sample_restaurants.restaurants.find({"cuisine": "Spanish"})
Você pode utilizar um cursor para iterar nos documentos retornados pelo método find(). Um cursor é um mecanismo que permite que um aplicativo itere sobre os resultados do banco de dados enquanto mantém apenas um subconjunto deles na memória em determinado momento. Os cursores são úteis quando o método find() retorna uma grande quantidade de documentos.
Você pode iterar sobre os documentos em um cursor usando um loop for-in , como mostrado no exemplo a seguir:
cursor = sample_restaurants.restaurants.find({"cuisine": "Spanish"}) for restaurant in cursor: ...
Observação
Localizar todos os documentos
Para encontrar todos os documentos em uma coleção, passe um filtro vazio para o método find() :
all_restaurants = sample_restaurants.restaurants.find({})
Modificar comportamento de localização
Você pode modificar o comportamento dos métodos find() e find_one() passando argumentos nomeados para eles. A tabela a seguir descreve os argumentos comumente usados:
Argument | Descrição |
|---|---|
batch_size | Limits the number of documents to hold in a cursor at a given time. |
collation | An instance of the Collation class that sets the collation options. |
comment | A string to attach to the query. This can help you trace and interpret the
operation in the server logs and in profile data. To learn more about query comments,
see the $comment page. |
hint | The index to use for the query. |
max_time_ms | The maximum execution time on the server for this operation. If this time is
exceeded, PyMongo aborts the operation and raises an ExecutionTimeout. |
O exemplo a seguir usa o método find() para localizar todos os documentos onde o campo "cuisine" tem o valor "Italian" e define um tempo máximo de execução de 10 segundos (10,000 milissegundos):
cursor = sample_restaurants.restaurants.find({"cuisine": "Italian"}, max_time_ms=10000)
Para obter uma lista completa dos argumentos disponíveis, consulte a documentação da API para o find() method.
Informações adicionais
Para saber mais sobre filtros de queries, consulte Especificar uma query.
Para obter exemplos de código executáveis de recuperação de documentos com o PyMongo, consulte Ler dados do MongoDB.
Documentação da API
Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API: