Softonic

Validador de CSV

Etapa 1 / 3 Validador de CSV

Arquivo carregado:

Próximo: delimitador e cabeçalho

Um CSV que abre sem problemas numa planilha ainda pode falhar na importação para um banco de dados ou no envio para uma API. Este validador lê o arquivo como a RFC 4180 descreve e lista cada problema de estrutura com o respectivo número de linha: aspas que nunca fecham, linhas com número errado de colunas, nomes de cabeçalho vazios ou repetidos, uma marca de ordem de bytes (BOM) no início e delimitadores sobrando no fim de uma linha. Cole o texto ou escolha um arquivo, selecione o delimitador (ou deixe a ferramenta detectá-lo) e leia o relatório.

Como validar um arquivo CSV

  1. 1

    Cole ou envie o CSV

    Cole o texto na caixa ou escolha um arquivo .csv, .tsv ou .txt. São aceitos arquivos de até 1.000.000 de caracteres.

  2. 2

    Escolha o delimitador e a linha de cabeçalho

    Deixe o delimitador na detecção automática ou force vírgula, ponto e vírgula, tabulação ou barra vertical. Informe se a primeira linha contém os nomes das colunas.

  3. 3

    Leia o relatório

    Cada problema aparece com o número da linha e uma descrição clara, marcado como erro ou aviso. Copie o relatório para compartilhá-lo.

  4. 4

    Corrija e verifique de novo

    Corrija as linhas no seu editor, recomece e cole o arquivo outra vez até o relatório indicar que não há problemas.

O que o validador verifica

A RFC 4180 é o mais perto de um padrão que o CSV tem. Ela determina que os registros são separados por quebras de linha, que os campos com delimitador, aspas ou quebra de linha ficam entre aspas duplas, e que aspas dentro de um campo entre aspas se escrevem duas vezes (""). O validador aplica essas regras ao seu texto e acrescenta algumas verificações importantes na prática.

Verificações e como são classificadas

Verificação Gravidade O que a aciona
Aspas sem fechar Erro Um campo entre aspas é aberto e o arquivo termina antes de ele fechar. A linha mostrada é onde as aspas foram abertas.
Aspas num campo sem aspas Erro Um " no meio de um campo que não começa com aspas, como 5" pipe.
Texto depois de aspas de fechamento Erro Depois das aspas de fechamento vem algo diferente de um delimitador ou quebra de linha, como "abc"def.
Número de colunas Erro Uma linha tem mais ou menos campos do que a primeira.
Nome de cabeçalho vazio Erro O nome de uma coluna na linha de cabeçalho está em branco.
Nome de cabeçalho repetido Erro Duas colunas têm o mesmo nome ao ignorar espaços e maiúsculas/minúsculas (Name e name).
Marca de ordem de bytes (BOM) Aviso O arquivo começa com o caractere invisível U+FEFF.
Delimitador no fim da linha Aviso Uma linha termina com um delimitador e, por isso, tem uma coluna vazia a mais.
Linha em branco Aviso Uma linha vazia entre registros.

Delimitadores

O modo automático examina as primeiras 25 linhas não vazias e escolhe a vírgula, o ponto e vírgula, a tabulação ou a barra vertical que mais vezes as divide no mesmo número de campos. Delimitadores dentro de campos entre aspas são ignorados, de modo que "Silva, J" não conta como duas colunas. Em caso de empate, vence a vírgula. Arquivos separados por ponto e vírgula são comuns em países onde a vírgula é o separador decimal, como o Brasil e Portugal: escolha o delimitador você mesmo quando um arquivo misturar os dois.

Números de linha

Os números de linha contam as linhas físicas do texto fornecido, a partir de 1. Um campo entre aspas com quebras de linha ocupa várias linhas físicas; um problema nesse registro é informado na linha em que o registro começa.

Causas comuns de erros em CSV

  • Uma exportação de planilha que acrescenta um BOM, lido por alguns importadores como parte do nome da primeira coluna.
  • Uma coluna de texto livre com vírgulas ou aspas que o script de exportação não colocou entre aspas.
  • A junção de arquivos com números diferentes de colunas.
  • Uma vírgula no fim da linha, acrescentada por um script que escreve cada valor seguido de um delimitador.

Perguntas frequentes

Não. Se a linha tem o mesmo número de campos que a primeira, um último valor vazio é um dado como qualquer outro. O validador só avisa sobre um delimitador no fim da linha quando ele cria um campo a mais do que a primeira linha tem, ou quando a própria linha de cabeçalho termina com um delimitador.

Quando um campo entre aspas nunca fecha, tudo o que vem depois é lido como parte desse campo, e as linhas seguintes não podem ser comparadas com segurança. Corrija as aspas na linha indicada e valide de novo para ver o que vem a seguir.

Não. Ele verifica a estrutura do arquivo: aspas, delimitadores, número de colunas, nomes de cabeçalho, a marca de ordem de bytes e linhas em branco. Não confere se um valor é um número, uma data ou um e-mail válido, e lê o texto como UTF-8.

Não. O texto colado ou o arquivo escolhido é lido e verificado no seu navegador. Ele não é enviado aos nossos servidores nem incluído no link da página. Entre as etapas, fica guardado apenas na aba do navegador, e recomeçar o apaga. No link aparecem só as escolhas de delimitador e cabeçalho.

Ferramentas relacionadas

Contador de FPS

Meça o FPS do navegador com requestAnimationFrame: suavização, taxa de quadros mínima e máxima, limite de alerta e gráfico opcional. Roda localmente, sem upload nem API.

Gerador de Configuração Webpack

Crie um webpack.config.js para webpack 5 com JavaScript puro, React ou Vue: TypeScript, Babel, CSS ou Sass, imagens, HtmlWebpackPlugin, servidor de desenvolvimento e a linha de npm install.

Conversor de Tamanho de Arquivo

Converta entre bytes, KB, MB, GB, TB e as unidades binárias IEC (KiB, MiB, GiB, TiB), combinando decimal e binário como preferir.

Gerador de textura de ruído

Gere uma textura de ruído em SVG que se repete sem emendas, com opacidade, frequência do grão, tipo de ruído e cor de fundo ajustáveis, e copie o CSS já pronto.

Gerador de Licença

Gere o texto completo de licenças de código aberto com seu nome e ano preenchidos. Abrange licenças MIT, Apache 2.0, GPLv3, BSD-3, MPL-2.0 e CC.

Desofuscador de JavaScript

Desofusque JavaScript compactado ou ofuscado: descompacte camadas eval e packer, decodifique strings com escape, substitua arrays de strings, simplifique constantes, renomeie nomes _0x e formate o código.

Ferramenta disponível em outros idiomas