> ## 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).

# MySQL Workbench: como conectar (SSL)

# MySQL Workbench: Como conectar com o MySQL

O MySQL Workbench é uma das ferramentas de administração visual mais utilizadas para gerenciar bancos de dados. Para conectar-se à sua instância na Square Cloud, você precisará configurar os parâmetros de rede e, obrigatoriamente, o certificado SSL para garantir uma conexão criptografada.

---

## 1. Localizando as Informações de Acesso

Antes de iniciar, tenha em mãos os dados extraídos da sua URL de conexão no dashboard da Square Cloud:

*   **Hostname:** `square-cloud-db-{id}.squareweb.app`
*   **Porta:** A numeração que aparece após o host (ex: 3306).
*   **Username:** `squarecloud`
*   **Password:** A senha definida na criação da instância.

---

## 2. Criando uma Nova Conexão

1.  Abra o MySQL Workbench e clique no ícone de **"+"** ao lado de "MySQL Connections".
2.  No campo **Connection Name**, dê um nome de sua preferência (ex: "Banco Produção Square").
3.  Na aba **Parameters**, preencha:
    *   **Hostname:** Cole o endereço do seu host.
    *   **Port:** Insira a porta do seu banco.
    *   **Username:** Digite `squarecloud`.

---

## 3. Configurando o Certificado SSL

Por motivos de segurança, a Square Cloud exige que a conexão seja feita através de SSL. Sem este passo, a conexão será recusada pelo servidor.

1.  Ainda na janela de configuração, clique na aba **SSL**.
2.  No campo **Use SSL**, selecione a opção **Require** ou **If available**.
3.  No campo **SSL CA File**, clique no botão de seleção (três pontos) e aponte para o arquivo **.crt** que você baixou no dashboard da Square Cloud.

> **Atenção:** Certifique-se de usar o arquivo com a extensão `.crt`. Ele é o responsável por validar a Autoridade Certificadora (CA) do servidor.

---

## 4. Testando o Acesso

1.  Clique no botão **Test Connection** no canto inferior direito.
2.  O Workbench solicitará a sua **Password**. Digite a senha da sua instância.
3.  Se tudo estiver correto, você verá uma mensagem confirmando que a conexão SSL foi estabelecida com sucesso.

---

## 5. Resolução de Problemas

*   **SSL Connection Error:** Verifique se o caminho para o arquivo `.crt` está correto e se o arquivo não foi movido de pasta.
*   **Authentication Plugin:** Se encontrar erros de plugin de autenticação, certifique-se de estar usando uma versão atualizada do MySQL Workbench