Conversor CSV para JSONL

Como converter CSV para JSONL

A conversão de CSV para JSONL lê a primeira linha do seu arquivo CSV como cabeçalhos de colunas, e depois converte cada linha subsequente em um objeto JSON com esses cabeçalhos como chaves.

Nosso conversor detecta automaticamente o delimitador (vírgula, tabulação ou ponto e vírgula) e lida com campos entre aspas, incluindo campos contendo vírgulas ou quebras de linha. Os valores são tipados automaticamente — números, booleanos e null são detectados.

A saída é em formato JSONL válido com um objeto JSON compacto por linha, pronto para uso com plataformas de aprendizado de máquina, pipelines de dados e APIs.

Regras de inferência de tipos

Uma célula CSV é apenas texto; transformá-la em JSON útil significa adivinhar tipos. O conversor segue estas regras — e mostra como sobrescrevê-las quando o palpite destruiria dados:

Dígitos → número

Células como 42 ou 3.14 se tornam números JSON. A armadilha: valores que parecem numéricos mas não são — o CEP americano 00501 perderia os zeros à esquerda ao virar o número 501. Qualquer coisa em que zeros à esquerda ou o texto exato importem deve permanecer entre aspas na origem ou ser mantida como coluna de string.

true/false → booleano

true e false (sem distinção de maiúsculas) se tornam booleanos JSON. As strings yes, no, 0 e 1 ficam intocadas — adivinhar a intenção nesses casos causa mais bugs do que resolve.

Célula vazia → null

Células vazias se tornam null em JSON em vez de strings vazias — o código a jusante pode então usar uma verificação simples de null em vez de testar por "".

Campos entre aspas, vírgulas e quebras de linha embutidas

As regras padrão de aspas do CSV são respeitadas: um campo entre aspas pode conter vírgulas e até quebras de linha, e aspas duplicadas ("") são convertidas em um único caractere de aspas. Um campo com quebra de linha embutida ainda vira uma única linha JSONL — a quebra é escapada como \n dentro da string JSON.

Erros comuns e soluções

O que é conversão de CSV para JSONL?

A conversão de CSV para JSONL transforma dados tabulares de planilhas e bancos de dados no formato JSON Lines. Cada linha do CSV se torna um objeto JSON separado em sua própria linha, com os cabeçalhos das colunas usados como nomes de chaves.

Esta conversão é essencial para preparar dados de planilhas para treinamento de aprendizado de máquina (OpenAI, Hugging Face), carregar dados em bancos de dados NoSQL e alimentar dados estruturados em pipelines de streaming.

A mesma conversão em pandas

Se o seu CSV já vive em um pipeline Python, o pandas faz essa conversão em duas chamadas — e sua inferência de dtype segue a mesma intuição descrita acima:

import pandas as pd

df = pd.read_csv('input.csv', dtype={'zip': 'string'})  # protege os CEPs
df.to_json('output.jsonl', orient='records', lines=True, force_ascii=False)

O argumento dtype é a versão pandas da regra dos zeros à esquerda: declare explicitamente as colunas frágeis como strings em vez de confiar na inferência. force_ascii=False mantém texto não-ASCII legível em vez de escapado com \u.

Perguntas frequentes