> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# DBeaver: como conectar ao PostgreSQL (SSL)

# DBeaver: Como conectar com o PostgreSQL

O DBeaver permite que você gerencie suas tabelas, execute queries complexas e visualize dados do seu banco PostgreSQL hospedado na Square Cloud de forma intuitiva. Para estabelecer essa conexão com segurança, utilizaremos certificados de criptografia (SSL).

---

## 1. Dados de Conexão

Antes de abrir o DBeaver, localize a URL de conexão no seu dashboard. Você precisará extrair as seguintes informações:

*   **Host:** square-cloud-db-id.squareweb.app (`id` é o ID da sua instância, já incluso URL copiada).
*   **Porta:** A porta numérica fornecida (ex: 31000).
*   **Banco de Dados (Database):** `squarecloud` (ou o nome do banco que você criou).
*   **Usuário:** `squarecloud`
*   **Senha:** A senha gerada junto com a instância.

---

## 2. Configurando a Conexão no DBeaver

1.  Abra o DBeaver e clique no ícone de **Nova Conexão** (tomada com um sinal de mais).
2.  Selecione **PostgreSQL** e clique em "Próximo".
3.  Na aba **Main**, preencha os campos com os dados coletados no passo anterior (Host, Porta, Banco, Usuário e Senha).

---

## 3. Configurando o SSL (Passo Obrigatório)

A Square Cloud não permite conexões sem SSL para o PostgreSQL. Para configurar, siga este caminho dentro da janela de conexão:

1.  Vá para a aba **SSL**.
2.  Marque a caixa **Use SSL**.
3.  No campo **SSL Mode**, selecione `verify-ca` ou `require`.
4.  Agora, aponte os arquivos que você baixou do dashboard:
    *   **Root Certificate:** Selecione o arquivo `.crt`.
    *   **SSL Certificate:** Selecione o **mesmo** arquivo `.crt`.
    *   **SSL Key:** Selecione o arquivo `.key`.

---

## 4. Testando a Conexão

Após configurar o SSL, clique no botão **Testar Conexão** no canto inferior esquerdo.

*   **Se aparecer "Conectado":** Parabéns! Você já pode gerenciar seu banco.
*   **Se houver erro de "SSL":** Certifique-se de que o arquivo `.key` e o `.crt` estão nos campos corretos e que o modo SSL não está como "disable".

---

**Dica Pro:** No DBeaver, você pode salvar essas configurações em "Projetos" diferentes para alternar rapidamente entre seu banco de produção e o de desenvolvimento.