Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Você precisa de um servidor em execução e de um cliente que consiga falar com ele. Qualquer servidor MySQL 8.4 ou mais recente funciona, e o VillageSQL também, que é o MySQL com um framework de extensões adicionado. Nenhuma lição aqui usa uma extensão, então qualquer um dos dois serve.

Escolha uma forma de rodar um servidor

Cada uma dessas páginas termina com um servidor em execução. Volte aqui quando tiver um.

Obtenha um cliente

Este tutorial comanda o servidor com mysql, o cliente de linha de comando. De onde ele vem depende da forma que você escolheu:
  • O instalador. O instalador coloca um cliente em ~/.villagesql/, mas não no seu PATH. Rode o comando Connect salvo em ~/.villagesql/credentials.txt (a senha de root está no mesmo arquivo), depois rode SELECT VERSION(); no prompt mysql> em vez do comando abaixo.
  • Um servidor existente. O cliente veio com o servidor, então você já o tem.
  • Docker. O cliente mora dentro do contêiner, não na sua máquina. Alcance-o com docker exec -it CONTAINER_NAME mysql -u root -p, ou instale um cliente localmente e conecte pela porta que o contêiner publica.

Verifique que você consegue conectar

Rode isto, e pressione Return no prompt de senha se root não tiver senha:
A sua string de versão vai ser diferente. O que importa é que uma versão voltou, porque isso significa que o cliente alcançou o servidor e fez login.

Quando não conecta

Os dois erros abaixo significam que o cliente nunca alcançou um servidor, então nenhum deles é sobre a sua senha. Você pode reproduzir qualquer um dos dois em uma configuração que funciona apontando o cliente para um lugar errado. Um caminho de socket sem nada por trás:
Uma porta sem nada escutando nela:
O número entre os parênteses finais é o número de erro do próprio sistema operacional, então ele pode diferir entre macOS e Linux. O número de socket ausente é 2 nos dois; o número de conexão recusada é 61 no macOS e 111 no Linux. A parte a ler é o caminho do socket ou o host e a porta, porque isso diz onde o cliente procurou. Se esse lugar estiver errado, corrija-o. Se estiver certo, o servidor não está em execução.

Veja também