Tempo de leitura estimado : 5 min · Publicado
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.
Descreva o dialeto CSV antes de contar linhas. No formato RFC 4180, campos com vírgula, aspas ou quebra de linha ficam entre aspas duplas e as internas são duplicadas. [CRLF] representa um par real de retorno de carro e avanço de linha no teste. O campo continua parte de um registo lógico.
Teste: cabeçalho e dois registos, com CRLF num campo entre aspas do segundo, ocupam quatro linhas físicas, não quatro registos. Use analisador CSV e compare campos. O leitor Python padrão devolve cadeias: 00120 conserva zeros até conversão posterior. Defina vazio e uso em folha de cálculo separadamente; aspas CSV não neutralizam fórmulas.
Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.
| Fragmento de exemplo | Número de campos | Campos lidos em texto |
|---|---|---|
| "Paris, France" | 1 | ["Paris, France"] |
| "A ""B""" | 1 | ["A \"B\""] |
| "A[CRLF]B" | 1 | ["A[CRLF]B"] |
| 00120, | 2 | ["00120", ""] |
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.
Lote fictício: seis registos têm, nesta ordem, os identificadores textuais 00120, 00121, 00120, 00122, 00123 e 00124. Antes da importação, 00121 existe com um valor a alterar e 00122 já está igual. A regra escolhida aceita a primeira ocorrência de cada chave, recusa repetições no lote e recusa 00123 por faltar uma relação obrigatória. O primeiro processamento dá 2 criados + 1 atualizado + 1 inalterado + 2 recusados = 6 registos examinados.
Depois, o destino contém quatro identificadores: 00120, 00121, 00122 e 00124. Repetir exatamente o mesmo lote, com as mesmas regras e sem alterações intermédias, deve dar 0 criados, 0 atualizados, 4 inalterados e 2 recusados. Esta recuperação decorre do contrato de importação e não automaticamente do CSV. Preserve os zeros iniciais e conte os registos lógicos do analisador; um campo entre aspas pode incluir uma quebra de linha.
Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.
| Resultado | Número | Registos envolvidos |
|---|---|---|
| Criados | 2 | 00120 e 00124 |
| Atualizado | 1 | 00121: valor diferente do destino |
| Inalterado | 1 | 00122: valor já idêntico |
| Recusados | 2 | Ocorrência 3: duplicado de 00120; ocorrência 5: relação ausente para 00123 |
- Python : leitura e escrita de arquivos CSV
Python CSV, consultado em 22 de outubro de 2026: leitura e formatos. Os dados e as regras de aceitação são fictícios.
Fornecer exportações com nomes legíveis nos idiomas publicados.
Caso fictício: o nome de uma exportação contém acentos. Teste filename, filename*, tipo de conteúdo e ficheiro guardado. Limpe nomes provenientes de entradas antes de construir cabeçalhos. Este cabeçalho não protege o acesso nem substitui a autorização.
- O nome é legível, o tipo corresponde e nenhuma entrada consegue injetar outro cabeçalho.
- MDN Content-Disposition
Referência de apresentação ou download, incluindo parâmetros do nome do ficheiro.
Comparar exportação e reimportação

Caso proposto: exportar e importar altera zeros iniciais e datas, embora a contagem de linhas continue igual.
Use dados fictícios com acentos, valores vazios e formatos diferentes. Compare cada campo e registe transformações aceites ou erradas.
- Preparar casos variados
- Comparar campos importados
- Registar transformações
- Distinguir variantes do catálogo
Prepare um catálogo de produtos úteis antes de construir a loja
Documentos de referência
- MDN Content-Disposition · Fonte consultada
- W3C WAI : Tables Tutorial · Fonte consultada
- MDN : URLSearchParams · Fonte consultada
- IETF : RFC 4180: CSV format · Fonte consultada
- Python : leitura e escrita de arquivos CSV · Fonte consultada
- OWASP – injeção de CSV · Fonte consultada
Conteúdo atualizado
Referências documentadas para este tema
| Referência | Valor ou sintaxe | Âmbito |
|---|---|---|
| RFC 4180 · CSV | text/csv · "a,b" | Campos com vírgulas, aspas ou quebras de linha usam aspas; as aspas internas são duplicadas. |
| RFC 8259 · JSON | application/json · UTF-8 | JSON padrão não admite comentários nem vírgulas finais; as cadeias usam aspas duplas. |
| RFC 3339 · Date-time | 2026-10-22T09:00:00+02:00 | O desvio explícito relaciona a hora local com UTC; este exemplo não é uma marcação. |
As datas indicam a consulta das fontes. Estes dados não constituem uma auditoria do site nem uma declaração global de conformidade.
