Conectar ao MySQL da sua conta com o MySQL Workbench

Bancos de DadosAcesso remoto e código··· 1.563 visualizações· 6 min de leitura

O MySQL Workbench é um programa que instala no seu computador para trabalhar no banco de dados como quem trabalha numa planilha: ver tabelas, rodar consultas, exportar, importar. É mais confortável do que o phpMyAdmin para quem passa lá horas, e é a ferramenta que um programador vai pedir.

A parte que costuma falhar não é o programa: é o caminho até o servidor. Este artigo trata disso, e começa por lhe poupar uma tarde.

A conexão direta à porta do banco de dados não costuma abrir de fora. A porta do MySQL não está exposta à internet por padrão, e isso é uma decisão de segurança, não uma avaria. Se meteu o endereço do servidor no Workbench e ele fica pensando até desistir, não é a sua senha que está errada. O caminho que funciona é o túnel SSH, e é o que se descreve a seguir.

As três coisas de que precisa

Dado Onde o vai buscar
O banco de dados No cPanel, em MySQL Databases. O nome completo leva o prefixo da sua conta à frente, e é esse nome completo que se escreve.
O usuário da base Também em MySQL Databases. Não é o usuário do cPanel. É uma conta à parte, criada só para a base, e tem de estar ligada à base com todos os privilégios.
A conta de SSH É a conta do cPanel, com a mesma senha. Todos os planos de hospedagem compartilhada têm acesso SSH, por isso a mesma conta serve.

Se ainda não tem base nem usuário criados, o passo a passo está em criar bancos de dados e usar o phpMyAdmin.

A conexão por túnel SSH, campo a campo

No Workbench, em vez de criar uma conexão normal, escolha o tipo Standard TCP/IP over SSH. Passa a haver dois blocos de campos: os do SSH, que são o caminho até a máquina, e os do MySQL, que são o que se faz depois de lá chegar.

Campo O que escrever
SSH Hostname O nome do servidor, seguido de dois pontos e de 2299. A porta de SSH aqui não é a 22, e esquecê-la é a causa número um de «não liga».
SSH Username O usuário do cPanel.
SSH Password A senha do cPanel, ou uma chave, se preferir chaves.
MySQL Hostname 127.0.0.1. E isto confunde todo mundo: aqui já se está DENTRO do servidor, por isso o endereço é o do próprio servidor visto de dentro.
MySQL Server Port 3306.
Username O usuário DO BANCO DE DADOS, com o prefixo da conta.
Password A senha desse usuário. Se não a tem, defina-a outra vez no cPanel: ela nunca é mostrada depois de criada.
Teste antes de gravar. O Workbench tem um botão de Test Connection que faz a conexão inteira e diz em que passo falhou. Se falhar no SSH, o problema é a conta ou a porta; se falhar no MySQL, é o usuário da base. São dois problemas diferentes e cada um tem a sua cura.

E o link direto, sem túnel?

Existe, e há casos em que faz sentido: uma aplicação de escritório que liga sempre do mesmo escritório, por exemplo. Mas têm de estar duas coisas certas ao mesmo tempo, e não basta uma.

1 O seu endereço de IP tem de estar autorizado, no cPanel, em Remote MySQL. Sem isso o servidor recusa a conexão mesmo com a senha certa.
2 A porta tem de estar aberta ao exterior, e por padrão não está. Isto não se resolve no cPanel: fale conosco, dizemos-lhe se dá para o seu caso e o que implica.
3 O seu IP tem de ser fixo. Se muda de dia para dia, como quase todas as conexões domésticas, vai passar a vida a pô-lo outra vez na lista. Para saber qual é o seu, veja como descobrir o seu endereço de IP.

Posto lado a lado, o túnel ganha quase sempre: funciona de qualquer rede, não expõe a base a ninguém, e não precisa de autorização nenhuma da nossa parte.

O que costuma dar errado

O que vê O que é
Fica pensando e desiste Quase com certeza tentou conexão direta em vez de túnel, ou escreveu a porta 22 no SSH em vez da 2299.
Access denied for user O usuário da base está certo mas não foi ligado à base, ou foi ligado sem todos os privilégios. Volte a Add User To Database no cPanel.
Unknown database Faltou o prefixo da conta no nome. O nome completo é o que aparece na lista do cPanel, e não o que você escreveu quando a criou.
Aviso sobre a versão do servidor O servidor corre MariaDB, que o Workbench conhece mas nem sempre reconhece pelo número. O aviso é inofensivo: continue.
Ligava ontem e hoje não liga Se andava a usar link direto, o seu IP mudou. Se usa túnel e parou, pode ter sido o firewall a bloquear o seu IP por tentativas falhadas: veja por que o firewall bloqueia o seu IP.
Não edite dados de verdade sem uma cópia à mão. O Workbench executa o que lhe mandar, sem perguntar segunda vez. Um UPDATE sem WHERE apaga a coluna toda em menos de um segundo. Faça a cópia primeiro: fazer e guardar a sua própria cópia.

Não encontra o Terminal nem o SSH Access no seu cPanel? Pergunte-nos, que confirmamos.

Abrir um pedido de suporte

Nos nossos planos

Todos os planos de hospedagem compartilhada incluem acesso SSH, então o túnel descrito neste artigo está disponível para você em qualquer plano. Seu acesso SSH é o usuário e a senha do cPanel. Todos os planos também têm PostgreSQL, além de MySQL, e o número de bancos de dados é ilimitado, então você pode ter um banco por projeto. Para confirmar na sua conta, abra o cPanel e procure Terminal ou Acesso SSH: se algum dos dois aparecer, o SSH está ativo. Se nenhum aparecer, ou o acesso for recusado, abra um chamado de suporte e verificamos a conta.

VEJA TAMBÉM

Planos de hospedagem e o que cada um inclui

Política de Suporte: até onde vai a nossa ajuda

PRODUTO RECOMENDADO

Hospedagem de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde R$ 36,30/mês (plano de 3 anos, com cupom)

Ver planos
Esta resposta foi útil? Sua resposta nos ajuda a melhorar este artigo.