Página inicial do Docs → Desenvolver aplicações → Drivers Python → PyMongo
Criar um MongoClient
Visão geral
Para se conectar a um MongoDB deployment, você precisa de duas coisas:
Um URI de conexão, também conhecido como connection string, que informa ao PyMongo a qual deployment do MongoDB se conectar.
Um objeto MongoClient , que cria a conexão com a implantação do MongoDB e permite que você execute operações nele.
Você também pode usar qualquer um desses componentes para personalizar a maneira como o PyMongo se comporta enquanto estiver conectado ao MongoDB.
Este guia mostra como criar uma connection string e utilizar um objeto MongoClient para conectar ao MongoDB.
URI de conexão
Uma connection string padrão inclui os seguintes componentes:
Componente | Descrição |
|---|---|
mongodb:// | Obrigatório. Um prefixo que identifica isso como uma string no formato de conexão padrão. |
username:password | Opcional. Credenciais de autenticação. Se você incluir estes, o cliente autenticará o usuário no banco de banco de dados especificado no authSource. Para obter mais informações sobre a opção de conexão authSource , consulte Mecanismos de autenticação. |
host[:port] | Obrigatório. O host e o número da porta opcional em que o MongoDB está sendo executado. Se você não incluir o número da porta, o driver usará a porta padrão, 27017. |
/defaultauthdb | Opcional. O authentication database de autenticação a ser usado se a connection string incluir as credenciais de autenticação username:password@ , mas não a opção authSource . Se você não incluir este componente, o cliente autenticará o usuário no banco de dados do admin . |
?<options> | Opcional. Uma string de consulta que especifica opções específicas de conexão como <name>=<value> pares. Consulte Especificar opções de conexão para obter uma descrição completa dessas opções. |
Para obter mais informações sobre a criação de uma connection string, consulte connection strings na documentação do MongoDB Server .
Cliente Mongo
Para criar uma conexão com o MongoDB, passe um URI de conexão como uma string para o construtor MongoClient . No exemplo a seguir, o driver usa um URI de conexão de exemplo para se conectar a uma instância MongoDB na porta 27017 de localhost:
from pymongo import MongoClient uri = "mongodb://localhost:27017/" client = MongoClient(uri)
Dica
Reutilizando seu cliente
Como cada objeto MongoClient representa um pool de conexões com o banco de dados, a maioria dos aplicativos exige somente uma única instância de MongoClient, mesmo em várias solicitações. No entanto, se você bifurcar um processo, o processo filho precisará de seu próprio objeto MongoClient . Para saber mais, consulte a página de dúvidas frequentes .
Documentação da API
Para saber mais sobre como criar um objeto MongoClient no PyMongo, consulte a seguinte documentação da API: