Prepare importações e exportações de dados confiáveis

Tempo estimado de leitura: 3 min. · Publicado em 1º de outubro de 2026

Descreva o contrato de dados

Escreva um dicionário de campo cobrindo significado, tipo, unidade, status obrigatório e valores ausentes. Defina identificadores e relações estáveis. Um código postal, número de produto ou código administrativo pode exigir uma representação de texto para preservar seu significado.

Especifique a codificação, delimitador, datas, fusos horários e convenções decimais. A documentação do CSV do Python explica a configuração do dialeto; Uma extensão de arquivo por si só não impõe convenções idênticas a cada produtor.

Construa um lote que desafia os limites

Inclua um nome acentuado, um valor ausente opcional, um identificador com um zero à esquerda, uma descrição de várias linhas e uma relação ausente. Adicione uma duplicata e um formato intencionalmente inválido. Mantenha este conjunto de dados sintético e claramente rotulado como dados de teste.

Decida se um problema rejeita uma linha, rejeita o arquivo ou produz uma importação com um relatório de problema. Evite relatar o sucesso ao soltar campos silenciosamente. Relatar as linhas aceitas, rejeitadas e revisadas.

Planeje as permissões e a segurança do Exchange

Defina quem pode exportar, importar e remover um lote. Não coloque exportações confidenciais em uma pasta pública por padrão. Para arquivos abertos em planilhas, revise os campos que podem ser interpretados como fórmulas usando um método apropriado para o software receptor.

Separe os dados autorizados do contexto interno que não devem viajar, como comentários privados, detalhes de contato desnecessários ou chaves técnicas. Use cópias de teste limpas ou sintéticas. Armazenamento de documentos, retenção e quem remove as exportações temporárias.

Reconciliar dados após o processamento

Compare identificadores, relações, totais e valores amostrados antes e depois do processamento. Se o suporte de ida e volta for necessário, exporte e reimporte para um ambiente de teste, compare o significado em vez do tamanho do arquivo.

Mantenha um backup e um registro antes de uma importação destrutiva. Distinguir atualizações, adições e exclusão. Uma linha ausente em uma exportação parcial não significa automaticamente que ela deve ser excluída. Concorde com essas regras antes de processar o banco de dados completo.

Documentação principal: Python — leitura e escrita de arquivos CSV.

Documentos de referência

Python — leitura e escrita de arquivos CSV

Conteúdo atualizado em 1º de outubro de 2026

Registe as verificações e os resultados no registo de testes web

Matriz de validação funcional para se adaptar ao projeto

Esses controles propostos usam casos fictícios. Decida qual comportamento é esperado com a equipe, anote o resultado e atribua discrepâncias não resolvidas antes da publicação.

Casos de teste, resultados esperados e evidências úteis
Caso	Resultado esperado	Prova para guardar
Acentos, separadores e texto de várias linhas	Os valores mantêm seu significado após a exportação e reimportação.	Comparação campo a campo usando um pequeno arquivo de referência representativo com valores conhecidos.
Zero, vazio, nulo e ausente	Os quatro estados seguem regras distintas quando exigido pelo contrato.	Dicionário de dados e valores realmente recebidos pelo destino.
Identificador repetido	A regra escolhida distingue a duplicação, atualizações e variantes legítimas.	Aceito e recusado log de linhas, com um motivo para cada decisão.
Falha na metade	A equipe sabe quais mudanças foram aplicadas e como retomar.	Estado final, linhas afetadas e um procedimento de recuperação exercido com dados sintéticos.

Perguntas frequentes

Por que manter alguns códigos como texto?

Eles identificam uma entidade em vez de uma quantidade. A conversão automática pode perder zeros à esquerda ou alterar a apresentação. Defina o tipo no contrato e teste um exemplo de limite.

Uma contagem de linhas inalteradas prova ser uma importação correta?

Não. As contagens podem corresponder apesar dos campos perdidos, relações interrompidas ou substituições incorretas. Compare identificadores, valores, unidades e erros usando um lote representativo.