# MongoDB Compass: instalação e primeiros passos

O MongoDB Compass facilita o trabalho com o MongoDB graças à sua interface gráfica de utilizador. A seguir, mostramos como instalar e utilizar esta ferramenta.

## MongoDB Compass: uma maneira mais fácil de gerenciar bancos de dados

[O MongoDB](https://www.ionos.com/pt-pt/digitalguide/paginas-web/desenvolvimento-web/mongodb-apresentacao-e-comparacao-com-o-mysql/) é uma das soluções NoSQL mais conhecidas. O sistema de gestão de bases de dados centra-se no armazenamento e gestão de conjuntos de dados extensos que podem ser processados em vários formatos e agrupados como documentos BSON em coleções. Apesar de a solução pretender facilitar a utilização, trabalhar com a linha de comandos requer alguns conhecimentos prévios e uma grande precisão.

O MongoDB Compass oferece uma **interface gráfica intuitiva** que permite visualizar, editar e analisar dados. Aqui explicamos como instalar a ferramenta no seu sistema e quais as possibilidades que ela oferece no uso diário.

## Quais são as funções do MongoDB Compass?

O MongoDB Compass pode realizar todas as tarefas que são possíveis com o shell, mas de forma muito mais rápida e simples, graças a uma interface muito visual. A ferramenta permite trabalhar com documentos individuais e coleções e facilita a construção de bases de dados completas. Estas são algumas das tarefas que podem ser realizadas com o MongoDB Compass:

- criar novas bases de dados, coleções e documentos,
- visualizar os dados que armazenou na sua base de dados,
- adicionar, editar e eliminar um documento,
- analisar exaustivamente o sistema e as bases de dados criadas,
- verificar continuamente o desempenho do sistema,
- acompanhar e personalizar os dados de acordo com os princípios do formato de texto JSON.

Além disso, o MongoDB Compass é gratuito.

## Requisitos de instalação e versões da ferramenta

Antes de instalar o MongoDB Compass, você precisa escolher uma versão da ferramenta:

- O**MongoDB Compass** é a versão completa.
- **O MongoDB Compass Readonly** não permite editar ou apagar documentos.
- **O MongoDB Compass Isolated** funciona de forma isolada, sem necessidade de ligação à rede.

Pode descarregar qualquer uma das três versões a partir do [site da MongoDB](https://www.mongodb.com/try/download/compass "MongoDB Compass Download").

O MongoDB Compass é compatível com os sistemas operacionais mais comuns. Pode obter a interface gráfica do utilizador para OS X, Ubuntu e Windows.

Para poder utilizar a ferramenta, a base de dados documental deve já estar instalada. Pode ver como funciona no nosso tutorial do MongoDB. Também precisará de direitos de administrador. Embora os passos para realizar a instalação possam diferir ligeiramente dependendo do sistema, a utilização do MongoDB Compass é idêntica em todos os dispositivos.

## Como instalar o MongoDB Compass

Se utiliza OS X ou Windows, basta aceder ao site indicado no link acima, selecionar a versão adequada, fazer o download e seguir as instruções do assistente de instalação. Se deseja instalar o MongoDB Compass no Ubuntu, por exemplo, precisará de direitos sudo. Se os tiver, pode prosseguir conforme indicado abaixo:

1. Acesse a [página do MongoDB Compass](https://www.mongodb.com/try/download/compass "MongoDB Compass Download") e copie o link de download da versão correspondente.
2. Use o comando `wget`. Com a versão 1.39.4, ele aparecerá assim:

```bash
wget https://downloads.mongodb.com/compass/mongodb-compass_1.39.4_amd64.deb
```

3. Instale o MongoDB Compass utilizando o comando `apt` desta forma:

```bash
sudo apt install ./mongodb-compass_1.39.4_amd64.deb
```

4. Quando a instalação estiver concluída, abra o MongoDB Compass:

```bash
$ mongodb-compass
```

Primeiro, você verá uma tela inicial. Nas seções a seguir, explicamos como proceder e quais opções você tem.

## Estabelecer uma ligação com o servidor

Para utilizar o MongoDB Compass, primeiro deve estabelecer uma ligação com o seu servidor. A forma mais simples de o fazer é seguir os seguintes passos:

1. Clique em «New Connection» (nova ligação) no canto superior esquerdo para estabelecer uma ligação.
2. Em seguida, encontrará a opção «Fill in connection fields individually» (preencher os campos de ligação individualmente) bem no topo. Clique nela.
3. Agora introduza o IP do seu servidor remoto no campo «Hostname» (nome do host).
4. Se nunca alterou a porta manualmente, poderá utilizar o valor padrão, que é «27017».
5. Se desejar aplicar medidas de segurança adicionais, em “Authentication” (autenticação), selecione “Username/Password” (nome de utilizador/palavra-passe) e insira os dados de acesso que costuma utilizar para o MongoDB.
6. Depois de concluir as etapas necessárias, o MongoDB Compass conectar-se-á ao seu servidor. Em seguida, poderá ver um resumo da(s) sua(s) base(s) de dados à direita.

## Criar bases de dados com o MongoDB Compass

Se ainda não criou uma base de dados ou deseja criar uma adicional, o MongoDB Compass facilita muito isso. Basta seguir os seguintes passos:

1. Clique no botão «CREATE DATABASE» (criar base de dados) na parte superior. Será aberta uma janela pop-up.
2. Em seguida, dê um nome à sua nova base de dados.
3. Dê também um título à sua coleção.
4. Quando estiver satisfeito com todos os dados, clique em «CREATE DATABASE» (criar base de dados) no canto inferior direito.

## Adicionar ou criar documentos

Com o MongoDB Compass, também pode guardar os seus dados em documentos BSON. Além disso, tem a opção de criar e inserir novos documentos na GUI. Para isso, basta seguir os seguintes passos:

1. Clique na base de dados correspondente no lado esquerdo.
2. Selecione agora a coleção correspondente. Em seguida, uma nova janela será aberta.
3. Em «Add Data» (adicionar dados), tem a opção de importar um documento existente («Import File») ou criar um novo documento («Insert Document»).
- Se quiser adicionar um documento existente, clique em «Importar ficheiro», selecione o ficheiro e especifique o formato. Em seguida, clique em «IMPORTAR».
- Em «Insert Document» (inserir documento), também se abre uma nova janela na qual pode adicionar valores no formato JSON ou em pares de chave-valor. Depois de editar o documento, clique em «INSERT» (inserir) para finalizar.

## MongoDB Compass: visualizar, editar ou apagar documentos

No MongoDB Compass, também pode visualizar, editar ou eliminar documentos. Aqui, explicamos também estes diferentes processos de forma breve e concisa.

### Visualizar documentos

Quando quiser ver o conteúdo de um documento específico, o MongoDB Compass oferece três visualizações diferentes:

- em forma de lista,
- no formato JSON e
- em forma de tabela.

Basta selecionar o modo que preferir na barra superior, ao lado da opção «VIEW» (ver).

Nota Para poder editar e apagar documentos, precisará da versão completa ou da versão isolada do MongoDB Compass. Na versão somente leitura, não é possível realizar essas ações.

### Editar documentos

Quando quiser editar um documento, faça o seguinte:

1. Acesse o documento correspondente.
2. Clique no ícone com o lápis que aparece no canto superior direito.
3. Selecione o campo que deseja alterar.
4. Quando terminar, confirme clicando em «UPDATE» (atualizar).

### Apagar documentos

Apagar um documento no MongoDB Compass é muito fácil:

1. Reabra o documento correspondente.
2. Certifique-se de que já não precisa do documento.
3. Clique no ícone da lixeira localizado no canto superior direito e confirme a operação.

Dica O MongoDB Compass oferece uma função de pesquisa simples (barra de consulta) para realizar consultas em coleções específicas. No artigo[“criar consultas MongoDB”](https://www.ionos.com/pt-pt/digitalguide/paginas-web/desenvolvimento-web/consultas-mongodb/), ensinamos como criar consultas mais complexas.


This is a markdown version of: [https://www.ionos.com/pt-pt/digitalguide/paginas-web/desenvolvimento-web/mongodb-compass/](https://www.ionos.com/pt-pt/digitalguide/paginas-web/desenvolvimento-web/mongodb-compass/) for AI/LLM consumption.