Erros de conexão do Compass
Nesta página
As seções desta página listam erros comuns vistos ao se conectar ao MongoDB Compass e fornecem possíveis soluções.
O MongoDB Não Está Sendo Executado no Host e na Porta Fornecidos
Sua conexão falhou quando o Compass tentou se conectar ao seu banco de dados no host e porta especificados.
Prováveis Causas
Esse erro geralmente ocorre quando:
Você não fornece nenhum nome de host ou um nome de host inválido para o diálogo de conexão do Compass.
O servidor de destino rejeita uma conexão em uma porta incorreta.
Seu cluster ou servidor MongoDB foi desligado ou o nome de host do servidor foi alterado.
Você tem um firewall bloqueando ativamente conexões de/para sua rede local.
Soluções
A solução para esse problema pode depender de como seu ambiente MongoDB está configurado. Selecione a aba apropriada para seu ambiente MongoDB para visualizar possíveis soluções:
Experimente essas soluções se você tiver um servidor, conjunto de réplicas ou cluster MongoDB auto-hospedado.
Verifique se sua instância do MongoDB está em execução
O Compass deve se conectar a uma instância MongoDB em execução. Certifique-se de ter instalado o MongoDB e ter um processo mongod em execução. Você também deve verificar se a porta em que sua instância do MongoDB está sendo executada corresponde à porta fornecida na caixa de diálogo de conexão do Compass.
Configuração de arquivo de configuração necessária: bindIp
Se você instalou recentemente o servidor de banco de dados MongoDB e não consegue estabelecer uma conexão inicial com esse servidor, verifique se especificou uma configuração net.bindIp válida no arquivo de configuração do servidor.
Nome de host e porta
Se seu servidor auto-hospedado estiver escutando em uma rede externa via net.bindIp, verifique se você especificou Hostname e Port corretamente na caixa de diálogo de conexão do Compass.
Servidor MongoDB movido ou desligado
É possível que seu cluster MongoDB ou servidor MongoDB tenha sido desligado ou seu nome de host tenha sido alterado. Entre em contato com o administrador do banco de dados para obter atualizações sobre o status do seu banco de dados.
Firewall
Se você acredita que seu firewall pode estar bloqueando ativamente as conexões com as portas em que seus bancos de dados estão operando, tente se conectar de um local diferente, como uma rede doméstica ou de café com internet. Você também pode acessar http://portquiz.net/ para testar sua conexão com portas diferentes.
Se estiver se conectando a um cluster do Atlas, primeiro siga o procedimento descrito na página Conectar via Compass na documentação do Atlas. As etapas nessa página ajudarão a garantir que suas configurações de conexão estejam otimizadas para o Atlas.
Servidor MongoDB movido ou desligado
É possível que seu cluster MongoDB ou servidor MongoDB tenha sido desligado ou seu nome de host tenha sido alterado. Entre em contato com o administrador do banco de dados para obter atualizações sobre o status do seu banco de dados.
Firewall
Se você acredita que seu firewall pode estar bloqueando ativamente conexões com seu banco de dados, tente se conectar de um local diferente, como uma rede doméstica ou de um café com acesso à internet.
Os clusters do Atlas operam na porta 27017. Você deve ser capaz de acessar esta porta para acessar seu cluster. Para verificar se sua rede local bloqueia conexões para a porta 27017, visite http://portquiz.net:27017/.
A lista de permissões de IP do Atlas não inclui seu endereço
O Atlas só permite conexões a um cluster a partir de endereços listados na lista de IPs permitidos do projeto. Certifique-se de que você permitiu o seu endereço IP para que possa se conectar ao seu cluster.
Botão Inserir documento desativado e Não é possível modificar documentos
Ao usar o Compass, você pode estar em um estado em que não pode escrever nenhuma operação de gravação e só pode ler dados.
Possíveis Observações
Quando você está neste estado:
Os botões Create Collection e Insert Document estão desativados.
Você não pode modificar nenhum dos seus documentos.
Provável Causa
Há duas causas prováveis para esse comportamento:
Você está conectado a um membro secundário do seu cluster, que não suporta operações de gravação.
Você está utilizando a edição Compass Readonly, que não suporta operações de gravação.
Soluções
Verifique a Configuração de Read Preference
Na caixa de diálogo de conexão do Compass, defina seu Read Preference como Primary. Isso garantirá que você se conecte ao membro principal do cluster, que é compatível com operações de gravação.
Verifique Nome do Conjunto de Réplicas
Verifique se o Replica Set Name está correto. O Compass só consegue identificar o primary corretamente se o nome do conjunto de réplicas for preciso.
Se o seu cluster estiver hospedado no Atlas, você poderá obter o nome do conjunto de réplica correto utilizando o seguinte procedimento:
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.
Abra o MongoDB Compass.
Clique em Yes para preencher automaticamente as configurações de conexão.
Verifique Sua Edição Compass
Você não pode realizar operações de gravação na edição Compass Readonly. Você pode conferir sua edição Compass abrindo o menu suspenso de nível superior do Compass e selecionando About MongoDB Compass.
Para realizar operações de gravação, você deve baixar uma edição diferente do MongoDB Compass. Para obter mais informações sobre as diferenças entre as edições do Compass, consulte Recursos das Edições do Compass.
Conexão com Shard de Cluster Fechado
Esse erro significa que a conexão com o cluster do MongoDB foi fechada antes da conclusão da configuração inicial.
Possíveis Observações
Você pode ver um erro no MongoDB Compass semelhante ao seguinte:
connection 3 to cluster0-shard-00-00-a1b2c.mongodb.net:27017 closed
Provável Causa
A origem mais comum deste erro é uma entrada de lista branca de IP do Atlas ausente para o endereço IP público onde o Compass está em execução.
várias plataformas
Garanta que o endereço IP público onde o Compass está em execução esteja incluído na lista de permissões de IP do seu projeto Atlas.
Para configurar sua lista de permissões do Atlas:
Utilize o menu suspenso Context no canto superior esquerdo do Atlas para selecionar seu projeto Atlas desejado.
Clique na aba Security.
Clique na opção de menu IP Whitelist.
Se o seu endereço IP não estiver na lista de permissões, clique em Add IP Address.
Clique em Add Current IP Address.
Clique em Confirm.
O Atlas reconhece quais entradas na lista de permissões incluem seu endereço IP atual e anexa esses endereços com (includes your current IP address).
Dica
Veja também:
Para mais informações sobre configurar entradas de lista de permissões, consulte Configurar Entradas de Lista de Permissões na documentação do Atlas.
Não Primário ou Secundário Não é Gravável
Esta mensagem de erro indica que você conectou a um dos membros secundários de um conjunto de réplicas sem fornecer o nome correto do conjunto de réplicas e exigindo uma conexão com um primário em seu Read Preference.
Soluções
Verificar Nome do Conjunto de Réplica do Atlas
Você deve garantir que está fornecendo o nome correto do conjunto de réplicas na caixa de diálogo de conexão do Compass.
Se o seu cluster estiver hospedado no Atlas, você poderá obter o nome do conjunto de réplica correto utilizando o seguinte procedimento:
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.
Abra o MongoDB Compass.
Clique em Yes para preencher automaticamente as configurações de conexão.
Permitir que o Compass se conecte ao secundário
Outra abordagem para resolver esse erro é permitir que o Compass se conecte a um nó do cluster secundário. Altere o Read Preference para Primary Preferred ou Secondary Preferred nas configurações de conexão. Isso deve permitir que você ignore esse erro e se conecte.
Observação
Quando você se conecta a um nó do cluster secundário, não é possível criar ou modificar documentos, índices ou bancos de dados. Use esta solução apenas quando não precisar realizar nenhuma operação de gravação.
Dica
Veja também:
Para obter mais informações sobre preferência de leitura, consulte preferência de leitura no manual do MongoDB.
Falha ao autenticar
Quando você tenta se conectar ao seu cluster usando o Compass, você pode encontrar uma mensagem de erro informando Authentication Failed.
Prováveis Causas
Essa mensagem de erro geralmente é o resultado de uma das cinco condições:
Seu Password está ausente após o preenchimento automático dos detalhes da conexão a partir de uma cadeia de conexão copiada. O Compass exige que você insira manualmente sua senha na caixa de diálogo de conexão como precaução de segurança.
Seus Username e/ou Password estão incorretos.
Você não configurou nenhum usuário MongoDB para seu cluster do Atlas.
Você não selecionou o método Authentication correto.
Você não especificou o Authentication Database correto. Esta configuração corresponde à opção de string de conexão authSource.
Observação
Para clusters do Atlas, o Authentication Database geralmente é
admin.
Soluções
Certifique-se de que forneceu os Username e Password corretos.
Verifique se o usuário MongoDB que você está autenticando existe.
Verifique seu Authentication Database e o mecanismo de autenticação.
Verifique se o mecanismo de autenticação selecionado é suportado pelo banco de dados MongoDB.
Verifique os registros do Compass
Os registros do Compass podem fornecer informações adicionais sobre erros de conexão. Você pode encontrar mensagens de erro mais detalhadas para ajudar a diagnosticar o problema. Para obter mais informações, consulte Recuperar Registros do Compass.