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