Menu Docs
Página inicial do Docs
/
Idiomas
/
Python
/
PyMongo
/
Conecte

Criar um MongoClient

Nesta página

  • Visão geral
  • URI de conexão
  • Cliente Mongo
  • Documentação da API

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 mais informações sobre a opção de conexão do authSource , consulteMecanismos de Autenticaçãodo .

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:

Voltar

Conecte

Próximo

Escolha um destino de conexão