Conecte-se ao MongoDB
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 à sua implantação.
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 membro ao qual você está conectado mudar de um membro 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 herdadas salvas em seus favoritos, exporte as conexões na versão 1.39.0 convertê-las no novo formato antes de atualizar para a versão 1.39.2 ou posterior.
Conecte
Se o nome da sua conexão já estiver no Connections Sidebar da janela do Compass, clique no nome da conexão para se conectar.
Caso contrário, você pode conectar suas implantações 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.
Observação
A partir da versão 1.44.0, você pode se conectar a várias instâncias do MongoDB de uma só vez por meio do Compass.
Forneça sua string de conexão.
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 socketTimeoutMS padrão 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 string de conexão.
Para obter uma lista completa das opções de string de conexão compatíveis com o Compass, consulte o Compass Connection README no GitHub.
Abra o New Connection modal.
No painel inferior do Connections Sidebar, clique em Add New Connection para abrir o modal New Connection.
Se você já tiver conexões listadas no Connections Sidebar, clique no ícone na parte superior direita da barra lateral para abrir o modal New Connection.
Cole sua connection string.
Se você tiver a string de conexão para sua implantação disponível, você poderá colar a string diretamente na caixa de diálogo. Você pode usar o formato de string de conexão padrão ou o formato de conexão da lista de sementes do DNS.
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 Save ou Save & Connect para navegar até a Página Inicial do Compass.
Importante
Acesso necessário
Depois de se conectar à implantação MongoDB, você pode precisar de funções de usuário específicas para acessar várias funcionalidades do Compass. Para obter mais informações sobre as funções necessárias para os recursos do Compass, consulte Acesso necessário.
Use 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.
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.