Investigar uma importação recusada
Encontre um campo ausente ou adicional antes de procurar problemas de tipos de dados ou exigências de datas no programa que recebe o ficheiro de origem.
Validador CSV
Analise um CSV para detetar inconsistências estruturais, colunas irregulares e erros comuns antes de reutilizar os dados.
- Área de transferência
Dados não enviados
Relatório de validação
Esta ferramenta foi útil?
Como funciona esta ferramenta?
Um CSV que abre numa folha de cálculo pode falhar numa importação de gestão: um registo tem um campo a menos, falta o título de uma coluna ou uma aspa aberta absorve o resto do documento. O validador CSV procura estes problemas estruturais antes de converter ou carregar os dados. Apresenta o número de registos, linhas de dados e colunas, juntamente com as anomalias encontradas. Este diagnóstico não verifica as regras do programa de destino, a validade dos endereços nem a correção dos montantes registados.
A leitura reconhece células entre aspas, separadores no seu interior, aspas duplicadas e mudanças de linha citadas. Uma marca BOM UTF-8 inicial é removida. O modo automático escolhe entre vírgula, ponto e vírgula, tabulação e barra vertical usando o primeiro registo lógico. Pode impor um separador para testar uma hipótese de importação. Uma deteção ambígua pode apresentar uma única coluna onde esperava várias: interprete sempre o estado em conjunto com o separador e a largura pretendida.
A largura do primeiro registo serve de referência. Cada registo seguinte deve conter o mesmo número de células; um campo vazio depois de um separador também conta como célula. Os registos curtos ou longos são assinalados com as larguras real e esperada. O número indicado conta registos lógicos, não necessariamente as linhas físicas do editor: uma célula entre aspas com três linhas continua a pertencer a um único registo. Uma aspa por fechar é assinalada em separado e não é completada automaticamente.
A opção de cabeçalho começa ativa. Verifica os títulos depois de retirar os espaços exteriores: um título vazio é assinalado e dois títulos normalizados iguais são considerados duplicados. As maiúsculas continuam a contar, pelo que Codigo e codigo são diferentes. Sem esta opção, o primeiro registo permanece um dado e não se verificam os títulos. A validação não efetua reparações. Procura estes defeitos concretos, sem certificar exaustivamente todas as restrições lexicais de RFC 4180 ou todas as convenções de outros leitores CSV.
Como usar esta ferramenta
Forneça o texto que pretende verificar
Cole o CSV ou importe um ficheiro CSV ou TSV. Mantenha as aspas e os separadores existentes: retirá-los esconderia precisamente os defeitos estruturais que está a tentar diagnosticar.
Confirme as opções de leitura
Comece pela deteção automática e ajuste o cabeçalho ao primeiro registo real. Se uma tabela larga aparecer como uma coluna, escolha explicitamente o separador esperado.
Corrija a origem e volte a verificar
Consulte os detalhes das anomalias na página e exporte o resumo numérico se necessário. Repare o ficheiro original e valide a nova versão: o relatório não gera um CSV corrigido.
Casos de uso
Conferir uma exportação regular
Verifique dimensões e títulos de um novo ficheiro do fornecedor e compare-os com o esquema acordado antes de o utilizar numa cadeia de processamento.
Preparar uma conversão tabular
Localize cabeçalhos vazios ou repetidos antes de converter registos em objetos JSON, cujas propriedades devem representar sem ambiguidade as colunas da tabela original.
Exemplos
Uma célula que contém o separador
O ponto e vírgula dentro do nome entre aspas pertence à célula e não acrescenta uma coluna. Com o cabeçalho ativo, o motor conta três registos totais, duas linhas de dados e duas colunas. Nenhum dos controlos aplicados encontra anomalias.
Entrada
id;nome
1;"Casa; jardim"
2;OficinaResultado
CSV válido
Linhas: 3
Linhas de dados: 2
Colunas: 2
Separador detetado: ;Um registo de dados incompleto
O terceiro registo contém apenas um campo, enquanto o cabeçalho define dois. O identificador 2 não é eliminado nem completado automaticamente. A anomalia permite encontrar o registo na origem e decidir se falta o nome ou se a exportação ficou truncada.
Entrada
id;nome
1;Oficina
2Resultado
CSV a corrigir
Linhas: 3
Linhas de dados: 2
Colunas: 2
Separador detetado: ;
A linha 3 contém 1 colunas em vez de 2.Dicas e boas práticas
- Uma célula vazia corretamente delimitada não é um erro de largura. Confirme separadamente se o destino aceita essa ausência, sobretudo quando a coluna deveria conter um identificador obrigatório.
- A exportação de texto contém o resumo das dimensões e do separador; os detalhes das anomalias são apresentados na página. Não suponha que a descarga contém registos reparados ou um novo ficheiro de dados.
- Números de registo aparentemente deslocados podem resultar de células entre aspas com várias linhas. Procure o registo com um leitor CSV, em vez de dividir o texto por cada mudança física de linha.
Fontes e referências
- RFC 4180 — Common Format and MIME Type for CSV Files (abre num novo separador), RFC EditorPágina em inglês
Perguntas frequentes
O meu programa aceitará um CSV assinalado como válido?
Não necessariamente. O estado indica que os controlos estruturais desta ferramenta não encontraram problemas. Um importador pode ainda exigir uma ordem de colunas, títulos específicos, formatos de data ou valores obrigatórios.
Porque pode ser válido um ficheiro com uma única coluna?
Uma tabela de uma coluna é possível, mas um separador errado também pode esconder as colunas reais. Compare a largura indicada com a esperada e imponha o separador adequado quando a deteção for ambígua.
São permitidos cabeçalhos que contenham apenas espaços?
São assinalados como vazios quando a opção de cabeçalho está ativa. Os espaços exteriores também são ignorados ao procurar títulos duplicados, sem modificar o texto original no campo de entrada.
O validador elimina os registos incorretos?
Não. Descreve os problemas sem transformar o CSV. Guarde o original, corrija a exportação ou o programa que a gera e volte a verificar a estrutura antes de continuar o processamento.
Ferramentas relacionadas
Continue com estas ferramentas
Ferramentas semelhantes ou complementares a esta.
Ferramentas semelhantes
Converta dados CSV em JSON ou JSON em CSV sem alterar a estrutura útil.
Dados e folhas de cálculoEm destaqueUtilizar esta ferramenta
Renomeie uma ou mais colunas de um ficheiro CSV sem alterar os dados das linhas.
Dados e folhas de cálculoUtilizar esta ferramenta
Funda vários ficheiros CSV numa única tabela mantendo colunas coerentes.
Dados e folhas de cálculoEm destaqueUtilizar esta ferramenta
Leia também
GuiaBoas práticasIniciante
Converter CSV, Excel, JSON e TSV sem perder a estrutura dos dados
Compreenda o que é preservado ou perdido numa conversão entre CSV, Excel, JSON e TSV e como preparar as colunas antes de mudar de formato.
29 de agosto de 20264 min
GuiaBoas práticasIniciante
Dados e tabelas: compreender CSV, Excel, JSON e a estrutura de um conjunto de dados
Perceba como se estruturam dados tabulares, o que distingue CSV, Excel, JSON e TSV e como escolher o formato antes de limpar ou converter.
29 de agosto de 20263 min
GuiaBoas práticasIniciante
Duplicados e validação CSV: tornar uma tabela fiável antes da importação
Descubra como identificar duplicados, escolher as colunas-chave certas e validar a estrutura de um CSV antes de o importar ou comparar.
29 de agosto de 20263 min
GuiaBoas práticasIniciante
Limpar um ficheiro CSV ou Excel antes de o utilizar
Prepare uma tabela removendo duplicados, linhas vazias e espaços desnecessários, controlando colunas e valores antes de importar ou analisar.
29 de agosto de 20263 min