Motor (Driver assíncrono)

Introdução

Boas-vindas ao site de documentação do Motor, o driver oficial do MongoDB para aplicativos Python assíncronos. Faça o download usando pip ou configure um projeto executável seguindo nossos tutoriais.

• Tutorial sobre como usar o Motor com Tornado

• Tutorial sobre como usar o Motor com asyncio

• Documentação do Motor

• Registro de alterações

• código fonte

Siga os links abaixo para ler blog posts que descrevem casos de uso específicos para o driver Motor:

• Do PyMongo para o Motor

• Refatoração de corrotinas do Tornado

• Todos os artigos do Motor no blog de A. Jesse Jiryu David

Instalação

Você deve instalar o módulo driver Motor para disponibilizá-lo para seu aplicativo Python. Recomendamos usar pip para instalar o Motor.

O comando a seguir demonstra como você pode instalar a versão mais recente do módulo usando a linha de comando:

$ python -m pip install motor

Para obter mais informações sobre os requisitos e outros métodos de instalação, consulte a Instalação do Motor documentação.

Ligar ao MongoDB Atlas

Você pode usar o seguinte trecho de conexão para testar sua conexão com sua implantação do MongoDB no Atlas usando a estrutura assíncrona asyncio:

import asyncio
from motor.motor_asyncio import AsyncIOMotorClient
from pymongo.server_api import ServerApi
async def ping_server():
  # Replace the placeholder with your Atlas connection string
  uri = "<connection string>"
  # Set the Stable API version when creating a new client
  client = AsyncIOMotorClient(uri, server_api=ServerApi('1'))
  # Send a ping to confirm a successful connection
  try:
      await client.admin.command('ping')
      print("Pinged your deployment. You successfully connected to MongoDB!")
  except Exception as e:
      print(e)
      
asyncio.run(ping_server())

Este trecho de conexão usa a funcionalidade API estável, que você pode habilitar ao usar o driver Motor v. 2.5 e mais recente para se conectar ao servidor MongoDB v. 5.0 e mais recente. Ao usar esse recurso, você pode atualizar seu driver ou servidor sem se preocupar com problemas de compatibilidade com versões anteriores de qualquer comando coberto pela API estável.

Para saber mais sobre o recurso de API estável, consulte API estável no manual do servidor.

Conecte-se ao Atlas MongoDB sem a API estável

Se estiver usando uma versão do MongoDB ou do driver não compatível com a funcionalidade Stable API, você pode usar o seguinte trecho de código para testar sua conexão com o MongoDB deployment no Atlas:

import asyncio
from motor.motor_asyncio import AsyncIOMotorClient
async def ping_server():
  # Replace the placeholder with your Atlas connection string
  uri = "<connection string>"
  # Create a new client and connect to the server
  client = AsyncIOMotorClient(uri)
  # Send a ping to confirm a successful connection
  try:
      await client.admin.command('ping')
      print("Pinged your deployment. You successfully connected to MongoDB!")
  except Exception as e:
      print(e)
      
asyncio.run(ping_server())

Se você estiver utilizando a biblioteca assíncrona do tornado, você poderá utilizar o seguinte código para conectar ao seu MongoDB deployment:

import tornado
import motor
async def ping_server():
    # Replace the placeholder with your Atlas connection string
    uri = "<connection string>"
    # Set a 5-second connection timeout when creating a new client
    client = motor.motor_tornado.MotorClient(uri, serverSelectionTimeoutMS=5000)
    # Send a ping to confirm a successful connection
    try:
      await client.admin.command('ping')
      print("Pinged your deployment. You successfully connected to MongoDB!")
    except Exception as e:
      print(e)
tornado.ioloop.IOLoop.current().run_sync(ping_server)

Conecte-se a um servidor MongoDB em sua máquina local

Se você precisar executar um servidor MongoDB em seu computador local para fins de desenvolvimento, em vez de usar um cluster do Atlas, será necessário concluir o seguinte:

1. Baixe a versão Comunidade ou Enterprise do MongoDB Server.

2. Instale e configure o servidor MongoDB.

3. Inicie o servidor.

Depois de iniciar com êxito o servidor MongoDB, especifique a connection string no código de conexão do driver.

Se o servidor MongoDB estiver sendo executado localmente, você poderá usar a connection string "mongodb://localhost:<port>", em que <port> é o número da porta que você configurou no servidor para escutar as conexões de entrada.

Se você precisar especificar um nome de host ou endereço IP diferente, consulte a entrada do Manual do servidor sobre cadeias de conexão.

Para testar se você pode se conectar ao seu servidor, substitua a connection string no exemplo de código Connect to MongoDB Atlas e execute-a.

Compatibilidade