Visão geral
Nesta página, você pode ver exemplos de código copiáveis que mostram métodos comuns que você pode usar para encontrar documentos com o PyMongo.
Dica
Para saber mais sobre qualquer um dos métodos mostrados nesta página, consulte o link fornecido em cada seção.
Para usar um exemplo desta página, copie o exemplo de código no aplicativo de amostra ou em seu próprio aplicativo. Certifique-se de substituir todos os espaços reservados nos exemplos de código, como <connection string URI>, pelos valores relevantes para sua implantação do MongoDB.
Aplicativo de amostra
Você pode usar o seguinte aplicativo de exemplo para testar os exemplos de código nesta página. Para usar o aplicativo de amostra, execute as seguintes etapas:
Verifique se o PyMongo está instalado.
Copie o seguinte código e cole-o em um novo arquivo
.py.Copie um exemplo de código desta página e cole-o nas linhas especificadas no arquivo.
Selecione a aba Synchronous ou Asynchronous para ver o código correspondente:
import pymongofrom pymongo import MongoClient
try: uri = "<connection string URI>" client = MongoClient(uri)
database = client["<database name>"] collection = database["<collection name>"]
# start example code here
# end example code here
client.close()
except Exception as e: raise Exception( "The following error occurred: ", e)import asyncioimport pymongofrom pymongo import AsyncMongoClient
async def main(): try: uri = "<connection string URI>" client = AsyncMongoClient(uri)
database = client["<database name>"] collection = database["<collection name>"]
# start example code here
# end example code here
await client.close()
except Exception as e: raise Exception( "The following error occurred: ", e)
asyncio.run(main())encontrar um
results = collection.find_one({ "<field name>" : "<value>" })
print(results)results = await collection.find_one({ "<field name>" : "<value>" })
print(results)Para saber mais sobre o método find_one() , consulte Encontrar um documento no guia Recuperar dados.
Encontrar vários
results = collection.find({ "<field name>" : "<value>" })
for document in results: print(document)results = collection.find({ "<field name>" : "<value>" })
async for document in results: print(document)Para saber mais sobre o método find() , consulte Encontrar vários documentos no guia Recuperar dados.
Contagem de documentos em uma coleção
count = collection.count_documents({})
print(count)count = await collection.count_documents({})
print(count)Para saber mais sobre o método count_documents() , consulte o guia Recuperar uma contagem precisa .
Contagem de documentos retornados de uma query
count = collection.count_documents({ "<field name>": "<value>" })
print(count)count = await collection.count_documents({ "<field name>": "<value>" })
print(count)Para saber mais sobre o método count_documents() , consulte o guia Recuperar uma contagem precisa .
Contagem estimada de documentos
count = collection.estimated_document_count()
print(count)count = await collection.estimated_document_count()
print(count)Para saber mais sobre o método estimated_document_count() , consulte o guia Recuperar uma contagem estimada .
Retrieve Distinct Values
results = collection.distinct("<field name>")
for document in results: print(document)results = await collection.distinct("<field name>")
for document in results: print(document)Para saber mais sobre o método distinct() , consulte o guia Retrieve Distinct Field Values (Recuperar valores de campos distintos).
Monitorar alterações de dados
with collection.watch() as stream: for change in stream: print(change)async with await collection.watch() as stream: async for change in stream: print(change)Para saber mais sobre o método watch(), consulte o guia Monitorar dados com change streams.