Iniciar Compass a partir da linha de comando
Nesta página
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:
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.
Local Executável do Compass
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: |
Especificação de conexão de linha de comando
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.
Connection String Básica
O exemplo a seguir usa uma connection string 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
Parâmetros de nome de usuário e senha
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
Especificação de Conexão do Arquivo de Configuração
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