VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
Pré-requisitos
- Binários do VillageSQL: Garanta que você tenha os binários do VillageSQL prontos (compilados a partir do código-fonte ou baixados).
- Versão do MySQL: O VillageSQL é baseado no MySQL 8.4 LTS. Atualizar a partir do MySQL 8.4 é o caminho suportado.
Etapa 1: Faça Backup dos Seus Dados
Antes de tocar em qualquer arquivo de sistema ou serviço, crie um backup completo do seu banco de dados.Opção A: Backup Lógico (mysqldump)
Crie um dump SQL de todos os bancos de dados. Este é o método mais seguro e mais portátil.Opção B: Backup Físico (Diretório de Dados)
Se o seu conjunto de dados for grande, pare o servidor e copie o diretório de dados.Etapa 2: Pare o Servidor MySQL
Pare a instância do servidor MySQL em execução para liberar os bloqueios sobre os arquivos de dados. Usando Systemd (Linux):Etapa 3: Substitua os Binários
O núcleo da atualização consiste em trocar os arquivos executáveis (mysqld, mysql, etc.) das versões do MySQL upstream pelas versões do VillageSQL.
Método A: Trocando os Diretórios de Instalação (Recomendado)
Se você instalou o MySQL via tarball (por exemplo, em/usr/local/mysql), o método mais limpo é instalar o VillageSQL ao lado dele e trocar o link simbólico.
- Extraia/Instale o VillageSQL em um novo diretório, por exemplo,
/usr/local/villagesql-8.4. - Atualize o link simbólico:
- Verifique as permissões: Garanta que o usuário que executa o banco de dados (geralmente
mysql) tenha permissão de execução sobre os novos binários.
Método B: Sobrescrevendo os Binários
Se você compilou o VillageSQL a partir do código-fonte e quer sobrescrever a instalação do sistema (por exemplo,/usr/bin ou /usr/local/bin):
Se você instalou o MySQL por meio de um gerenciador de pacotes (
apt, yum), sobrescrever os binários manualmente é arriscado, pois o gerenciador de pacotes pode sobrescrevê-los de volta durante as atualizações. Recomenda-se desinstalar o pacote mysql-server (mantendo os arquivos de dados!) ou usar update-alternatives, se disponível.Etapa 4: Verificação da Configuração
Garanta que o seu arquivo de configuração (geralmente/etc/my.cnf ou /etc/mysql/my.cnf) aponte para o seu diretório de dados existente.
my.cnf existente deve funcionar sem modificações.
Etapa 5: Inicie o VillageSQL
Inicie o servidor usando o seu gerenciador de serviços ou manualmente. Usando Systemd:Atualização Automática
Na inicialização, o VillageSQL detecta automaticamente se os arquivos de dados são de uma versão mais antiga e realiza as atualizações necessárias nas tabelas de sistema. Verifique o log de erros (geralmente em/var/log/mysql/error.log ou dentro do seu datadir) para confirmar que a atualização foi concluída com sucesso. Procure por:
[System] [MY-013381] [Server] Server upgrade from '...' to '...' completed.
Etapa 6: Verifique a Instalação
Conecte-se ao servidor e verifique se você está executando o VillageSQL.INSTALL EXTENSION.
Solução de Problemas
- “Data Dictionary Upgrade Failed”: Se o servidor se recusar a iniciar, você pode estar tentando fazer um downgrade (por exemplo, de 8.4 para 8.0) ou os arquivos de dados estão corrompidos. Verifique o log de erros.
- Erros de Permissão: Garanta que o usuário
mysqldo sistema operacional seja o dono dodatadire do novo diretório de instalação do VillageSQL.
Veja também
- Migrações de Esquema no MySQL — executando alterações de DDL seguras após a atualização
- Estratégias de Backup do MySQL — faça backup antes de atualizar
- MySQL no Docker — executando o MySQL ou o VillageSQL em um contêiner como alternativa
- Atualizando do MySQL 8.0 para o 8.4 Após o Fim do Suporte — chegando primeiro ao 8.4 se você ainda estiver no 8.0