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.
A partir da versão 1.39.2, O MongoDB Compass não suporta mais a migração de arquivos de conexão legados anteriores à versão 1.31.0. As conexões legadas referem-se a um formato interno de opções de conexão do Compass que é armazenado em disco e não é mais suportado após a versão 1.39.0.
Se você tiver conexões legadas salvas em seus favoritos, exporte as conexões na versão 1.39.0 para convertê-los no novo formato antes de atualizar para a versão 1.39.2 ou posterior.
Conecte
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.
Aviso
Se você clicar no formulário de conexão do MongoDB Compass para editar sua cadeia de conexão, o Compass mostra credenciais em texto sem formatação por padrão.
Para editar suas credenciais de connection string sem expor sua senha, utilize a aba Advanced Connection Options > Authentication no formulário de conexão do Compass.
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-se ao seu cluster.
Clique em Connect ou Save & Connect para navegar até a Página Inicial do Compass.
O botão Save & Connect solicita que você salve a cadeia de conexão como uma Conexão favorita e, depois, navega até a página inicial.
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.
Conectar ao Compass a partir da Linha de Comando
Você pode iniciar uma sessão do Compass na linha de comando.
Em ambientes empresariais, um início com scripts pode facilitar a distribuição do Compass. Por exemplo, para limitar o acesso a sistemas confidenciais, você pode configurar um início de linha de comando para que o Compass possa executar em um jump host.
Para obter detalhes, consulte Iniciar Compass a partir da Linha de Comando.
Opções avançadas de conexão
As opções avançadas de conexão fornecem maneiras adicionais de conectar o Compass ao MongoDB. As opções avançadas de conexão permitem que você especifique a autenticação, TLS/SSL e SSH para se conectar com segurança ao seu sistema.
Para obter detalhes, consulte Opções avançadas de conexão.
Dica
Veja também:
Para saber como desconectar seu sistema, consulte Desconectar do MongoDB