Página inicial do Docs → Visualizar & analisar dados → MongoDB Compass
Conecte-se ao MongoDB
Nesta página
Esta página descreve como usar o MongoDB Compass para se conectar a um host MongoDB. Você pode se conectar a um host de cluster standalone, de conjunto de réplica ou fragmentado.
Observação
MongoDB Atlas
Se você precisar criar um host MongoDB, considere utilizar o MongoDB Atlas. O Atlas é um banco de dados como serviço hospedado na nuvem que não requer instalação, oferece uma camada gratuita para começar e fornece um URI copiável para conectar facilmente o Compass ao seu sistema.
Se você precisar instalar o Compass, consulte Baixar e instalar o Compass para obter instruções.
Considerações
Ao conectar o Compass a um conjunto de réplicas, não é recomendável conectar-se diretamente a um membro individual do conjunto de réplicas. Se o nó ao qual você está conectado mudar de um nó primário para um secundário ou vice-versa como resultado de uma eleição, o Compass poderá fechar a conexão à força ou exibir dados obsoletos.
Para conectar a um conjunto de réplicas, utilize o conjunto de réplica SRV record ou Replica Set Name ao preencher suas informações de conexão.
A partir do MongoDB Compass 1.19, o Compass exibe uma mensagem de aviso quando conectado a instâncias não genuínas do MongoDB, pois essas instâncias podem se comportar de forma diferente das instâncias oficiais do MongoDB; por exemplo, funcionalidades ausentes ou incompletas, comportamentos diferentes das funcionalidades etc.
Conecte
Quando você abre o Compass, uma caixa de diálogo de conexão inicial aparece:
Você pode conectar seus sistemas por:
Fornecendo sua connection string.
Especificando Advanced Connection Options. As opções avançadas de conexão permitem que você especifique as opções de autenticação, TLS/SSL e conexão SSH. Para saber mais, consulte Opções avançadas de conexão.
Colar Connection string
Quando você fornece uma string de conexão, o Compass suporta a maioria das opções de string de conexão suportadas pelo MongoDB.
Por padrão, o valor padrão do socketTimeoutMS do Compass é 60000 ou 60 segundos. Se você estiver enfrentando timeouts frequentes no Compass, considere a possibilidade de definir essa opção com um valor mais alto na cadeia de conexão.
Para obter uma lista completa das opções de connection string compatíveis com o Compass, consulte o Compass Connection README no GitHub.
Cole sua connection string.
Se você tiver a cadeia de conexão para sua implementação disponível, você poderá colar a cadeia diretamente na caixa de diálogo. Você pode usar o formato de cadeia de conexão padrão ou o formato de conexão DNS Seedlist.
Para obter a cadeia de conexão para um cluster Atlas:
Navegue até a visualização do Atlas Clusters .
Clique em Connect para o cluster desejado.
Clique em Connect with MongoDB Compass.
Copie a connection string fornecida.
Para saber como formatar a string de conexão para uma implantação que não está hospedada no Atlas, consulte Formato de URI da string de conexão.
Conecte.
Clique no botão Connect para navegar até a página inicial do Compass.
Importante
Acesso obrigatório
Depois de se conectar ao MongoDB deployment, você pode precisar de roles de usuário específicos para acessar várias funcionalidades do Compass. Para obter mais informações sobre os roles necessários para as funcionalidades do Compass, consulte Acesso necessário.
Opções avançadas de conexão
As Opções Avançadas de Conexão fornecem formas adicionais de conectar sistemas do Compass.
- Aba conexão geral
- Saiba como selecionar um esquema de string de conexão para seu sistema.
- Aba conexão de autenticação
- Saiba como conectar implantações que exigem autenticação.
- Aba conexão TLS/SSL
- Saiba como conectar implantações usando TLS/SSL.
- Aba conexão de túnel Proxy/ SSH
- Saiba como conectar implantações usando um túnel SSH.
- Aba conexão de criptografia em execução
- Saiba como conectar sistemas usando criptografia em execução.
- Aba conexão avançada
- Saiba mais sobre opções avançadas de conexão adicionais para suas implementações.
Dica
Veja também:
Para saber como desconectar seu sistema, consulte Desconectar do MongoDB