Como limpar CSV antes da importação
Um processo seguro de limpeza que preserva o arquivo original e transforma as suposições de importação em verificações explícitas.
CSV é uma família de convenções, não um formato completamente uniforme. Delimitadores, aspas, codificação, marcas decimais, datas e quebras de linha variam entre exportadores.
Preserve o arquivo original sem alterações e faça a limpeza em uma cópia. Registre cada transformação para que a importação possa ser reproduzida ou revertida.
Confirme a estrutura
Detecte a codificação, o delimitador, o caractere de aspas, o tipo de quebra de linha, a presença do cabeçalho e o número esperado de colunas. Revise linhas do meio e do fim, não apenas a primeira página.
Procure quebras de linha incorporadas, aspas escapadas, cabeçalhos duplicados, separadores extras, caracteres BOM e linhas com colunas demais ou de menos.
Normalize com regras explícitas
Defina como representar strings vazias, valores nulos, booleanos, datas, separadores decimais, zeros à esquerda e espaços no sistema de destino.
Remova duplicatas usando uma chave de negócio estável em vez da linha inteira quando puderem existir diferenças inofensivas de formatação.
Proteja e verifique a importação
Trate células iniciadas por =, +, - ou @ como possíveis fórmulas quando os arquivos forem abertos em um aplicativo de planilhas.
Importe primeiro uma pequena amostra, compare linhas aceitas e rejeitadas e depois valide identificadores, totais e uma amostra aleatória no destino.
Checklist de limpeza CSV
- Preserve a exportação original.
- Verifique estrutura e número de colunas.
- Defina regras para valores nulos, datas, números e zeros à esquerda.
- Remova duplicatas com uma chave de negócio intencional.
- Neutralize fórmulas de planilha quando necessário.
- Teste uma importação de amostra e reconcilie as contagens de linhas.
Guias relacionados
Entenda o workflow por trás desta ferramenta e o que revisar depois.
Como depurar uma resposta JSON de API passo a passo
Um processo repetível para separar erros de transporte, problemas de sintaxe JSON e falhas do contrato de dados nas respostas de uma API.
Como depurar payloads JSON de API
Um workflow prático para formatar JSON, encontrar erros de sintaxe, validar o formato do payload e revisar o status quando dados de API parecem errados.