Menu Docs
Página inicial do Docs
/
MongoDB Compass
/

Iniciar Compass a partir da linha de comando

Nesta página

  • Local Executável do Compass
  • Especificação de conexão de linha de comando
  • Especificação de Conexão do Arquivo de Configuração
  • Saiba mais

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.

Existem duas formas de iniciar o Compass a partir da linha de comando:

  • Especifique uma connection string na linha de comando

  • Especificar detalhes da conexão em um arquivo

Se a cadeia de conexão contiver informações confidenciais, considere usando um arquivo de configuração para evitar expor essas informações em a linha de comando.

O nome e a localização do executável Compass variam de acordo com o sistema operacional.

Sistema operacional
Nome executável
Localização
Linux
mongodb-compass
O instalador o instala no diretório /usr/bin.
Windows
MongoDBCompass.exe
O instalador o instala em uma pasta que você escolhe durante o processo de instalação.
macOS
MongoDB Compass

O instalador o instala na pasta Aplicativos:

/Applications/MongoDB\ Compass.app/Contents/MacOS/MongoDB\ Compass

A invocação da linha de comando para o Compass tem dois componentes, o caminho para o executável do Compass e uma cadeia de conexão. Opcionalmente, você pode fornecer o nome de usuário e senha na linha de comando ou no arquivo de configuração. O formato é:

<path/to/compass/executable>
<connection string>
--username <username> --password <password>

Observação

Se os argumentos de nome de usuário e senha não forem fornecidos, o Compass utilizará as credenciais na cadeia de conexão.

O exemplo a seguir usa uma string de conexão básica para um cluster de treinamento da Universidade MongoDB. Modifique os detalhes da conexão para se conectar à instalação do MongoDB:

mongodb-compass mongodb+srv://cluster0.xxxxxx.mongodb.net/library

Este exemplo usa os parâmetros username e password para autenticar o Compass para o sistema MongoDB fornecida na connection string:

mongodb-compass mongodb+srv://cluster0.xxxxxx.mongodb.net/library
--username user1 --password password1

A invocação da linha de comando para o Compass pode especificar um arquivo de configuração.

O formato é:

<path/to/compass/executable> \
--file=<filename> \
[--passphrase=<passphrase>] \
[<connection id>]

Os componentes da invocação de comando são:

  • O caminho para o executável do Compass

  • Um arquivo de configuração de conexão

  • Uma frase secreta opcional para o arquivo de configuração da conexão

  • Um ID de conexão opcional

Para criar o arquivo de configuração da conexão, siga as etapas para exportar os detalhes da conexão de sua instância do Compass. O processo de exportação cria um arquivo que inclui todas as suas conexões favoritas.

Importante

Se você exportar as conexões salvas sem usar uma frase secreta, o arquivo de configuração conterá a versão em texto simples do seu nome de usuário e senha. Use uma senha para criptografar a senha.

Para abrir o Compass e conectar-se à sua instância MongoDB, use uma linha de comando como:

mongodb-compass --file=learningConnectionFile \
--passphrase=superSecret

Se você tiver vários favoritos, inclua a ID de conexão do arquivo de configuração para especificar qual conexão usar:

mongodb-compass --file=multipleConnectionFile \
--passphrase=superSecret \
27ba0eda-c27e-46f5-a74a-2c041b1b58c4

Voltar

Barra lateral de conexões