Como criar script de migração de database entre versões

Como Criar um Script de Migração de Banco de Dados Entre Versões (Guia para Iniciantes)

Olá, querido(a) cliente! 👋 Seja bem-vindo(a) ao nosso Sensei da GeHost — o seu guia de confiança para tudo que envolve hospedagem. Hoje vamos aprender juntos como criar um script de migração de banco de dados entre versões do seu sistema. Isso é super útil quando você atualiza um site, sistema ou aplicativo e precisa levar os dados antigos para a nova versão sem perder nada.

Se você está um pouco nervoso com a ideia de mexer em banco de dados, relaxa! Vamos passo a passo, com linguagem simples, como se estivéssemos conversando sobre café. 💬☕

📖 O que é migração de banco de dados?

Imagine que você tem um sistema antigo (como um site de vendas) e quer atualizar para uma versão nova. O banco de dados é como o "coração" do sistema — ele guarda todos os clientes, pedidos, produtos, etc.

Quando você atualiza o sistema, ele pode ter estruturas diferentes (nomes de tabelas, campos novos, tipos de dados). A migração é o processo de "transportar" os dados do banco antigo para o novo, de forma segura e organizada.

💡 Dica do Sensei: Sempre faça um backup antes de qualquer migração. É como guardar uma cópia de segurança do seu carro antes de trocar o pneu!

🔧 Passo a Passo: Criando o Script de Migração

Vamos dividir o processo em etapas simples e práticas. Você não precisa ser programador — só precisa seguir com atenção.

1. Exporte o banco de dados antigo
   Acesse o cPanel da sua conta na GeHost. Após logar, vá até a seção Bancos de Dados MySQL (veja a imagem abaixo).

2. Exporte como arquivo SQL
   Na tela de bancos de dados, clique em Exportar (ou "Export" em inglês) ao lado do banco que você quer migrar. Escolha a opção Exportar todos os dados e Salvar como arquivo. O arquivo será baixado no seu computador com extensão .sql.
3. Abra o arquivo SQL com um editor de texto
   Use um editor simples como o Notepad (no Windows), TextEdit (no Mac, em modo texto puro), ou o VS Code (recomendado, gratuito e fácil). Abra o arquivo .sql que você baixou.
4. Verifique o conteúdo do arquivo
   Você verá comandos como CREATE TABLE, INSERT INTO, ALTER TABLE, etc. Isso é o que o banco de dados entende. Fique atento a:
   • Nome das tabelas (pode ter mudado na nova versão)
   • Campos (colunas) que não existem mais ou que foram renomeados
   • Chaves estrangeiras ou índices que precisam ser ajustados
5. Crie o script de migração
   Agora, vamos criar um novo arquivo (também com extensão .sql) com os comandos que vão ajustar os dados para a nova versão. Por exemplo:
   • Se uma tabela foi renomeada, use RENAME TABLE antiga_tabela TO nova_tabela
   • Se um campo foi excluído, remova os dados dele com DELETE FROM tabela WHERE campo = 'valor'
   • Se um campo foi adicionado, use ALTER TABLE tabela ADD COLUMN novo_campo VARCHAR(255)
   • Se os dados precisam ser transformados (ex: data em formato diferente), use comandos como UPDATE tabela SET data = DATE_FORMAT(data, '%Y-%m-%d')
6. Teste o script em um banco de teste
   Não use o banco de produção! Crie um novo banco de dados no cPanel (como seu_site_teste) e execute o script nele. Isso evita erros no sistema real.
7. Execute o script no banco novo
   Após testar com sucesso, vá ao novo banco de dados da versão atualizada e use o phpMyAdmin (dentro do cPanel) para importar o script. Clique em Importar e carregue o arquivo SQL com os comandos de migração.
8. Verifique tudo funcionando
   Acesse o sistema novo e confira se os dados aparecem corretamente. Faça testes com usuários, pedidos, produtos, etc.

✅ Dicas do Sensei para não errar

• ⚠️ Nunca mexa diretamente no banco de produção sem backup. Use sempre um ambiente de teste.
• 📝 Documente cada passo. Anote o que você mudou, por que e quando. Isso ajuda muito se precisar voltar atrás.
• 🔄 Use versões do script. Chame seu arquivo de migracao_v1.sql, migracao_v2.sql, etc.
• 🔍 Pequenos erros no SQL podem causar grandes problemas. Use o phpMyAdmin para ver o que está sendo executado antes de confirmar.

🌟 Palavra final do Sensei: Você não precisa ser um gênio da programação para migrar bancos de dados. Com paciência, organização e um bom guia como este, você consegue. E quando errar? Tudo bem! A GeHost está aqui para te ajudar. Basta abrir um ticket no suporte — e o nosso time te ajuda com carinho. ❤️

Se você gostou desse guia, compartilhe com quem precisa. E lembre-se: seu site é importante — e você é capaz!