<aside> 💬

Contexto: O sistema está instalado e funcionando. Mas o banco está vazio. A Cláudia olha para a tela e pergunta:

"- E os meus 3.000 sócios? Cinco anos de cadastro vão para o lixo?"

Não vão — mas transferir esses dados do Excel para o banco de dados é provavelmente a etapa mais delicada de toda a implantação. Um erro aqui pode significar dados perdidos, duplicados ou corrompidos. Não tem como desfazer sem backup.

</aside>

⁉️O que é Migração de Dados ⁉️

Migração de dados é o processo de transferir informações de um sistema ou formato para outro, garantindo que os dados cheguem íntegros, completos e no formato correto. Na prática de implantação, os cenários mais comuns são:

No caso da Chapecoense, o cenário é o mais comum: uma planilha Excel com anos de dados que precisa ir para o PostgreSQL.

❓ Por que migração é a etapa de maior risco ❓

Nas outras etapas da implantação, se algo der errado você pode simplesmente refazer. Instalou errado? Desinstala e instala de novo. Configurou o .env errado? Corrige e reinicia.

Com dados, não é assim.

Dados reais têm valor que não pode ser recuperado. Os 3.000 sócios da Chapecoense representam cinco anos de relacionamento com o clube. Se esses dados forem perdidos ou corrompidos, não existe git checkout para desfazer.

Os riscos mais comuns numa migração são:

• Perda de dados Registros que existiam no sistema antigo não chegam ao novo. Pode acontecer por erro no script, por filtros incorretos ou por dados que não passaram na validação.
• Duplicação O mesmo registro é importado mais de uma vez. Uma sócia chamada Maria aparece três vezes no sistema novo porque o script rodou três vezes sem verificar se o registro já existia.
• Inconsistência Os dados chegaram, mas com problemas de integridade. Um sócio tem uma mensalidade vinculada a um plano que não existe. Uma data de nascimento que veio como texto "15/03/1990" foi salva como null porque o script esperava o formato 1990-03-15.
• Dados sujos O sistema antigo acumulou erros ao longo dos anos: CPFs inválidos, telefones no formato errado, campos obrigatórios em branco, nomes com caracteres especiais inesperados. Esses problemas precisam ser resolvidos antes ou durante a migração.

As três fases de uma migração

🔍 Fase 1 — Análise e limpeza dos dados de origem

Antes de escrever qualquer script, o técnico precisa entender o que está migrando.

Analise a planilha ou banco de origem:

• Quantos registros existem?
• Quais campos existem? Quais são obrigatórios?
• Existem campos vazios que não deveriam estar vazios?
• Os formatos estão consistentes? (datas, telefones, CPFs)
• Existem duplicatas?
• Existem caracteres especiais ou encoding incorreto?

Limpe os dados antes de migrar:

• Padronize formatos (todas as datas no mesmo formato, todos os telefones sem espaço e com DDD)
• Remova duplicatas
• Decida o que fazer com registros incompletos — migrar com campos nulos ou não migrar?
• Documente as decisões tomadas

<aside> 📌

Regra prática: se você encontrar dados sujos, não tente corrigir tudo no script de migração. Corrija na origem primeiro, valide, depois migre. Scripts de migração que fazem limpeza e importação ao mesmo tempo são difíceis de debugar quando algo dá errado.

</aside>