# MongoDB Compass: Tutorial de instalação e uso O MongoDB Compass facilita o uso do MongoDB, justamente por ser sua interface gráfica de usuário. Aprenda como instalar o software e fazer uso dos recursos oferecidos. ## Use o MongoDB Compass para gerenciar bancos de dados O [MongoDB](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/o-que-e-mongodb/) é uma das soluções [NoSQL](https://www.ionos.com/digitalguide/hosting/technical-matters/nosql/ "NoSQL") mais populares e bem-sucedidas do mundo. O foco principal desse [sistema de gerenciamento de banco de dados (DBMS)](https://www.ionos.com/digitalguide/hosting/technical-matters/database-management-systems-dbms/ "DBMS: Sistemas de gerenciamento de bancos de dados") está no armazenamento e na gestão de grandes conjuntos de dados, que podem ser processados em vários formatos e agrupados como documentos BSON, em coleções. Embora a solução se esforce para ser o mais intuitiva possível, trabalhar com linhas de comando exige algum conhecimento prévio e altos níveis de precisão. Com o MongoDB Compass, as coisas mudam de figura. Essa **interface gráfica** permite que usuários visualizem, editem e analisem dados com mais facilidade. Aprenda como instalar o MongoDB Compass no seu sistema operacional e conheça suas principais funcionalidades, que certamente simplificarão o seu dia a dia. ## Funcionalidades do MongoDB Compass O MongoDB Compass é capaz de realizar tudo o que pode ser feito no *shell*. No entanto, graças à sua interface de usuário, diferentes tarefas podem ser executadas de forma mais simples. Pelo MongoDB Compass, você consegue acessar documentos individuais, coleções e até a estrutura dos seus bancos de dados. Entre outras atividades, você pode executar as seguintes, ao fazer uso da interface gráfica: - Criar novos bancos de dados, coleções e documentos. - Visualizar dados armazenados no(s) banco(s) de dados. - Inserir, editar e excluir documentos. - Analisar profunda e abrangentemente o sistema de banco de dados criado. - Verificar continuamente o desempenho do sistema. - Monitorar e ajustar dados de acordo com os princípios do formato JSON. Para facilitar ainda mais, o MongoDB Compass pode ser usado gratuitamente. ## Pré-requisitos de instalação do MongoDB Compass Antes de começar com a instalação do MongoDB Compass, você deve optar por uma das versões da ferramenta: - **MongoDB Compass** é a versão completa. - **MongoDB Compass Read-Only** não oferece opções para editar ou excluir documentos. - **MongoDB Compass Isolated** funciona de forma isolada, sem se conectar à rede. Todas as três versões estão disponíveis para download no [site oficial do MongoDB](https://www.mongodb.com/try/download/compass "Try MongoDB tools free — mongodb.com"). O MongoDB Compass é compatível com os principais [sistemas operacionais](https://www.ionos.com/digitalguide/server/know-how/what-is-an-operating-system/ "O que é um sistema operacional"). Assim, é possível obter a [interface gráfica do usuário](https://www.ionos.com/digitalguide/websites/web-development/what-is-a-gui/) do MongoDB para OS X, [Ubuntu](https://www.ionos.com/digitalguide/server/know-how/ubuntu-the-linux-system-for-everyone/ "Ubuntu: O sistema Linux para todos") e Windows, por exemplo. Para que você possa usar o MongoDB Compass, este [banco de dados orientado a documentos](https://www.ionos.com/digitalguide/hosting/technical-matters/document-database/ "Banco de dados orientado a documentos") já deve estar instalado. Aprenda o passo a passo para [instalar o MongoDB](https://www.ionos.com/digitalguide/websites/web-development/mongodb-tutorial-first-steps/ "Tutorial MongoDB: Primeiros passos"). Ainda, você precisará de direitos administrativos para fazer isso. Embora as instruções de instalação variem ligeiramente a depender do sistema operacional, o uso do MongoDB Compass é idêntico em todos eles. ## Instalar o MongoDB Compass Se você usa OS X ou Windows, basta acessar o site do MongoDB, selecionar a versão apropriada, fazer o download da ferramenta e seguir as instruções do assistente de instalação. Já para instalar o MongoDB Compass no Ubuntu, você precisará de privilégios *sudo*. Com tais privilégios, siga as seguintes etapas: 1. Acesse o [site oficial do MongoDB](https://www.mongodb.com/try/download/compass "Try MongoDB tools free — mongodb.com") e copie o link de download com a versão apropriada. 2. No terminal, insira o comando `wget`, seguido do link da versão adequada. Para baixar a versão 1.39.4, por exemplo, digite o comando: ```bash wget https://downloads.mongodb.com/compass/mongodb-compass_1.39.4_amd64.deb ``` 3. Finalizado o download, execute `apt` para instalar o MongoDB Compass: ```bash sudo apt install ./mongodb-compass_1.39.4_amd64.deb ``` 4. Depois de concluir a instalação, inicie o MongoDB Compass: ```bash $ mongodb-compass ``` Mais à frente, guiaremos você pela ferramenta, apresentando seus principais recursos. ## Estabelecer conexão com o servidor Para utilizar o MongoDB Compass, você deverá estabelecer uma conexão com o seu servidor. A maneira mais fácil de se fazer isso é seguindo estes passos: 1. No canto superior esquerdo da tela, clique em “New Connection” para estabelecer uma conexão. 2. Em seguida, encontre a opção “Fill in connection fields individually”, também na parte superior da tela, e clique nela. 3. Agora, insira o IP do seu servidor remoto no campo “Hostname”. 4. Se você não tiver alterado manualmente a respectiva porta em algum momento anterior, bastará deixar o valor padrão já configurado (27017). 5. Para implementar medidas de segurança adicionais, vá para “Authentication” e selecione “Username / Password”. Lá, insira as credenciais de login que você utiliza para acessar o MongoDB. 6. Após concluir essas etapas, o MongoDB Compass se conectará ao seu servidor. Uma conexão de sucesso exibirá um resumo dos seus bancos de dados. ## Criar banco de dados com o MongoDB Compass Se você ainda não tem um banco de dados ou se deseja criar um novo, poderá usar o MongoDB Compass para tal: 1. Clique no botão “CREATE DATABASE” no topo da tela — isso abrirá uma janela pop-up. 2. Agora, dê um nome ao seu novo banco de dados. 3. Também dê um título à coleção (*collection*). 4. Depois de preencher todas as entradas solicitadas, clique em “CREATE DATABASE”, no canto inferior direito da janela. ## Importar ou inserir documentos com o MongoDB Compass Você também pode armazenar seus dados em documentos BSON com o MongoDB Compass, já que a interface gráfica de usuário oferece recursos para importar e inserir novos documentos. Para fazer isso, siga estes passos: 1. No lado esquerdo da tela, selecione no banco de dados em que as ações devem ser executadas. 2. Clique na coleção desejada — isso abrirá uma nova janela. 3. Em “Add Data”, você encontrará opções para importar um documento existente (“Import File”) e para inserir um novo documento (“Insert Document”). - Para importar um documento existente, clique em “Import File”, selecione o arquivo desejado e especifique o formato. Em seguida, clique no botão “IMPORT”. - Ao clicar em “Insert Document”, uma nova janela será aberta. Lá, você poderá adicionar valores no formato JSON ou como pares de chave-valor. Após editar o documento, clique no botão “INSERT”. ## Visualizar, editar e excluir documentos com o MongoDB Compass Você pode visualizar, editar ou excluir documentos com o MongoDB Compass. A seguir, indicaremos o passo a passo para a realização desses processos. ### Visualizar documentos Para visualizar o conteúdo de um documento específico, você terá de optar por um desses três modelos: - Formato de lista - JSON - Formato de tabela Escolha o modelo de visualização mais apropriado na barra superior, na opção “VIEW”. Nota Para conseguir **editar e excluir documentos**, você precisa do MongoDB Compass na versão completa ou na versão isolada (*isolated*). A versão somente leitura (*read-only*) não possibilita esse tipo de ação. ### Editar documentos Se você deseja editar um documento com o MongoDB Compass, siga estas etapas: 1. Acesse o documento correspondente. 2. Clique no ícone contendo um lápis, no canto superior direito da tela. 3. Selecione o campo que deseja alterar. 4. Quando terminar, confirme a seleção com “UPDATE”. ### Excluir documentos É muito fácil excluir um documento pelo MongoDB Compass: 1. Abra o documento correspondente. 2. Certifique-se de que realmente não precisa mais do documento. 3. Clique no ícone contendo uma lixeira, no canto superior direito da tela, e confirme a operação. Dica O MongoDB Compass também oferece uma função de pesquisa simples (*query bar*), capaz de realizar consultas (*queries*) em coleções específicas. Aprenda, com o nosso artigo especializado, como realizar [consultas complexas no MongoDB](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/mongodb-queries/). This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/mongodb-compass/](https://www.ionos.com/pt-br/digitalguide/sites-de-internet/desenvolvimento-web/mongodb-compass/) for AI/LLM consumption.