Mudar do PyMongo para o PyMongo Async
Importante
O driver PyMongo Async é experimental e não deve ser usado em ambientes de produção. Classes, métodos e comportamentos descritos neste guia podem mudar antes da versão completa. Se você encontrar algum problema com o PyMongo Async, saiba como denunciá-lo na página de ajuda.
Visão geral
O driver PyMongo Async é uma unificação do PyMongo e da biblioteca Motor. Neste guia, você pode identificar as alterações que deve fazer para alternar do PyMongo para o PyMongo Async.
Mudar do PyMongo
O driver PyMongo Async se comporta de forma semelhante ao PyMongo, mas todos os métodos que executam operações de rede são corrotinas e devem ser aguardadas. Para alternar do PyMongo para o PyMongo Async, você deve atualizar seu código das seguintes maneiras:
Substitua todos os usos de
MongoClient
porAsyncMongoClient
.Adicione a palavra-chave
await
a todas as chamadas de método assíncrono.Se você chamar um método assíncrono dentro de uma função, marque a função como
async
.
As seções a seguir descrevem como implementar a API assíncrona.
Métodos assíncronos
As tabelas a seguir listam os métodos assíncronos disponíveis no driver PyMongo Async. Para chamar esses métodos, você deve await
e chamá-los dentro de uma função async
.
Métodos do cliente
Método | Exemplo | |||
---|---|---|---|---|
|
| |||
|
| |||
|
| |||
|
| |||
|
| |||
|
|
Métodos do banco de dados
Método | Exemplo | ||
---|---|---|---|
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
|
Métodos de collection
Método | Exemplo | ||
---|---|---|---|
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
| ||
|
|
Informações adicionais
Para saber mais sobre Python assíncrono, consulte a documentação do Python Asyncio.