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.
Para navegar até a Página inicial do Compass, clique em Save, Connect ou Save & Connect.
O botão Save salva sua conexão e fecha o modal sem se conectar ao seu cluster ainda.
O botão Connect permite que você se conecte ao seu cluster sem salvar a string de conexão ou as credenciais.
O botão padrão Save & Connect salva suas informações e conecta você ao seu cluster.
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 sobre como especificar opções de conexão usando o Compass, 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 se conectar ao Compass usando a linha de comando, você pode incluir suas opções de conexão diretamente na string de conexão ou como argumentos de linha de comando.
Para especificar opções de conexão na sua string de conexão, utilize o seguinte formato:
mongodb-compass 'mongodb://username:password@hostname:port/database?ssl=true&replicaSet=myReplicaSet'
Para obter mais opções de string de conexão, consulte Opções de string de conexão.
Para especificar opções de conexão como argumentos de linha de comando, utilize o seguinte formato:
<path/to/compass/executable> <connection string> --username <username> --password <password>
Para obter mais opções de conexão de argumento de linha de comando, consulte Iniciar o Compass a partir da linha de comando.
Dica
Para saber como desconectar seu sistema, consulte Desconectar do MongoDB
Exemplos de connection string
Os exemplos a seguir destacam algumas opções avançadas de string de conexão. Para obter informações sobre todas as opções de string de conexão , consulte Opções de string de conexão.
Opções de TLS
A seguinte string de conexão habilita o TLS usando a opção de URI tls. tlsCertificateKeyFile especifica o caminho para o certificado do cliente e a chave privada. Especificar o tlsCertificateKeyFile na sua string de conexão é opcional, a menos que o servidor exija certificados de cliente ou se você estiver usando autenticação X.509.
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db0.example.com/?directConnection=true&tls=true&tlsCAFile=path/to/rootCA.crt&tlsCertificateKeyFile=path/to/server_certificate.pem
Para habilitar o SSL, utilize a opção equivalente ssl=true em vez de tls=true.
Autenticação X.509
O exemplo a seguir demonstra como especificar a autenticação X.509 na sua cadeia de conexão usando a opção authMechanism de cadeia de conexão:
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db1.example.com/?authMechanism=MONGODB-X509&tls=true&tlsCertificateKeyFile=/path/to/client_certificate.pem
LDAP
O exemplo a seguir especifica a autenticação LDAP. Ele configura authMechanism para plain para especificar o uso do mecanismo de autenticação LDAP e configura authSource para $external para indicar que o banco de dados de autenticação é $external.
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db2.example.com/?authMechanism=PLAIN&authSource=$external
Kerberos
O exemplo a seguir especifica a autenticação Kerberos. Ele configura authMechanism para GSSAPI a fim de usar o mecanismo de autenticação Kerberos e configura authSource para $external para indicar que o banco de dados de autenticação é $external.
mongodb://myDatabaseUser@db3.example.com/?authMechanism=GSSAPI&authSource=$external
Preferências de leitura/gravar
Para habilitar as preferências de leitura/gravação na sua string de conexão, você pode usar a opção readPreference para preferência de leitura e a opção w para preocupação de gravação.
A string de conexão a seguir define as preferências de leitura e gravação. readPreference=secondary especifica que as operações de leitura devem ser direcionadas aos membros secundários do conjunto de réplicas e w=majority assegura que as operações de gravar sejam confirmadas pela maioria dos membros do conjunto de réplicas.
mongodb://myDatabaseUser:D1fficultP%40ssw0rd@db4.example.com/database?readPreference=secondary&w=majority
Nós de analítica
Para especificar um tipo de nó analytics na sua string de conexão:
Configure seu
readPreferenceparasecondarypara indicar que as operações de leitura devem ser direcionadas aos nós secundários.Defina
readPreferenceTagsparanodeType:ANALYTICSpara garantir que as operações de leitura sejam direcionadas especificamente para os nós de analítica.
A string de conexão a seguir demonstra como especificar um tipo de nó analytics em sua string de conexão:
mongodb+srv://myDatabaseUser:D1fficultP%40ssw0rd@db5.example.com/myDatabase?readPreference=secondary&readPreferenceTags=nodeType:ANALYTICS
Para obter mais informações sobre como usar nós de análise para isolar cargas de trabalho, consulte Query usando tags predefinidas do conjunto de réplicas.