Comece com o PyMongo

Instalar dependências

Verifique se você tem as seguintes dependências instaladas em seu ambiente de desenvolvimento:

• Python3 versão 3.8 ou posterior

• pip

• dnspython

Criar uma diretoria de projeto

Em sua shell, execute o seguinte comando para criar um diretório chamado pymongo-quickstart para este projeto:

mkdir pymongo-quickstart

Selecione a aba correspondente ao seu sistema operacional e execute os seguintes comandos para criar um arquivo de aplicação quickstart.py no diretório pymongo-quickstart :

cd pymongo-quickstart
touch quickstart.py

cd pymongo-quickstart
type nul > quickstart.py

Instalar o PyMongo

Selecione a guia correspondente ao seu sistema operacional e execute os seguintes comandos para criar e ativar um ambiente virtual no qual instalar o driver:

python3 -m venv venv
source venv/bin/activate

python3 -m venv venv
. venv\Scripts\activate

Com o ambiente virtual ativado, execute o seguinte comando para instalar a versão atual do PyMongo:

python3 -m pip install pymongo

Crie uma MongoDB deployment gratuita no Atlas

Complete o guia Iniciar com Atlas para configurar uma nova conta Atlas e carregar dados de amostra em uma nova implantação MongoDB de camada gratuita.

Salve suas credenciais

Depois de criar o usuário do banco de dados, salve o nome de usuário e a senha desse usuário em um local seguro para uso em uma próxima etapa.

Encontre sua string de conexão do MongoDB Atlas

Para recuperar a string de conexão da implantação criada na etapa anterior, faça login na sua conta do Atlas e navegue até a seção Database e clique no botão Connect para a nova implantação.

Vá para a seção Connect your application e selecione "Python" no menu de seleção Driver e a versão que melhor corresponde à versão instalada no menu de seleção Version .

Selecione o mecanismo de autenticação Password (SCRAM).

Desmarque a opção Include full driver code example para visualizar a string de conexão.

Copie a string de conexão

Clique no botão à direita da string de conexão para copiá-la para a área de transferência, como mostrado na seguinte captura de tela:

Atualizar os espaços reservados

Cole esta connection string em um arquivo no editor de texto de sua preferência e substitua os placeholders <username> e <password> pelo seu nome de usuário e senha de utilizador de banco de dados.

Salve este arquivo em um local seguro para uso na próxima etapa.

Crie seu aplicação PyMongo

Copie e cole o seguinte código no arquivo quickstart.py em seu aplicação. Selecione a aba Synchronous ou Asynchronous para ver o código correspondente:

from pymongo import MongoClient
uri = "<connection string URI>"
client = MongoClient(uri)
try:
    database = client.get_database("sample_mflix")
    movies = database.get_collection("movies")
    # Query for a movie that has the title 'Back to the Future'
    query = { "title": "Back to the Future" }
    movie = movies.find_one(query)
    print(movie)
    client.close()
except Exception as e:
    raise Exception("Unable to find the document due to the following error: ", e)

import asyncio
from pymongo import AsyncMongoClient
async def main():
    uri = "<connection string URI>"
    client = AsyncMongoClient(uri)
    try:
        database = client.get_database("sample_mflix")
        movies = database.get_collection("movies")
        # Query for a movie that has the title 'Back to the Future'
        query = { "title": "Back to the Future" }
        movie = await movies.find_one(query)
        print(movie)
        await client.close()
    except Exception as e:
        raise Exception("Unable to find the document due to the following error: ", e)
# Run the async function
asyncio.run(main())

Atribuir a connection string

Substitua o placeholder <connection string URI> pela string de conexão que você copiou da etapa Criar uma connection string deste guia.

Execute seu aplicativo

Em sua shell, execute o seguinte comando para iniciar este aplicativo:

python3 quickstart.py

A saída inclui detalhes do documento de filme recuperado:

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}