Pesquisar
Introduza pelo menos dois caracteres, sem dados pessoais.

    BibliotecaArtigos e FAQs Seu projetoSolicite um orçamento
    LínguaPT ▾
    Guias práticos

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

    Um arquivo que abre não é necessariamente utilizável. O Reliable Exchange preserva os significados dos campos, distingue valores desconhecidos de zero e corresponde aos registros sem tratar um rótulo de exibição como um identificador frágil.

    Veja o método

    Ilustração — Prepare importações e exportações de dados confiáveis
    Ilustração gerada por IA

    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.

    CSV com vírgulas: quatro fragmentos; [CRLF] indica quebra real
    Fragmento de exemploNúmero de camposCampos 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.

    Balanço de uma primeira importação fictícia de seis registos
    ResultadoNúmeroRegistos envolvidos
    Criados200120 e 00124
    Atualizado100121: valor diferente do destino
    Inalterado100122: valor já idêntico
    Recusados2Ocorrência 3: duplicado de 00120; ocorrência 5: relação ausente para 00123

    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.

    Comparar exportação e reimportação

    Unidade de armazenamento e cabo USB entre dois portáteis
    Ilustração gerada por IA · Compare os campos depois de exportar e voltar a importar.

    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

    Documentos de referência

    Conteúdo atualizado

    Referências documentadas para este tema

    Referências documentadas para este tema
    ReferênciaValor 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-8JSON 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:00O 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.

    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.

    Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.

    Casos de teste, resultados esperados e evidências úteis
    CasoResultado esperadoProva para guardar
    Acentos, separadores e texto de várias linhasOs 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 ausenteOs quatro estados seguem regras distintas quando exigido pelo contrato.Dicionário de dados e valores realmente recebidos pelo destino.
    Identificador repetidoA 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 metadeA 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.