Como converter CSV em JSON rapidamente no terminal com jq

Por que transformar tabelas em dados estruturados no terminal

Quando lidamos com arquivos de planilhas tabulares, o formato CSV (valores separados por vírgula) continua sendo o padrão mais universal para exportar dados. No entanto, sistemas modernos, APIs e bancos de dados orientados a documentos exigem o formato JSON (notação de objetos JavaScript), que organiza a informação em árvores e pares de chave-valor. Fazer essa conversão diretamente no console economiza tempo e dispensa o uso de softwares pesados de escritório. Para quem busca otimizar fluxos de trabalho no console, conhecer métodos rápidos de processamento é tão útil quanto saber como converter PST em MBOX no Linux pelo terminal ao lidar com caixas de e-mail legadas.

Entendendo a ferramenta jq e os utilitários Unix

O jq é um processador de JSON de linha de comando leve e flexível, que funciona como um canivete suíço para manipular dados estruturados no terminal. Combinado com comandos clássicos do sistema operacional Unix como awk (ferramenta de varredura e processamento de padrões) e sed (editor de fluxo para filtrar e transformar texto), ele permite fatiar e reorganizar arquivos brutos. Na prática, isso significa que podemos pegar uma planilha gigante e transformá-la em objetos limpos com pouquíssimas linhas de comando, sem abrir nenhuma interface gráfica.

Preparando o arquivo CSV para a conversão

Antes de aplicar qualquer transformação mágica, precisamos garantir que o arquivo CSV esteja limpo e traga a primeira linha contendo os nomes das colunas, conhecidos como cabeçalhos. Esses cabeçalhos servirão de base para nomear as chaves no nosso objeto final JSON. Se o arquivo contiver caracteres especiais ou quebras de linha indesejadas dentro das células, o processo pode falhar. É o mesmo princípio de cuidado que temos ao como converter áudio em texto no terminal com Whisper, onde a qualidade do arquivo de entrada determina diretamente o sucesso da operação.

Construindo o comando de conversão passo a passo

Para realizar a conversão na prática, utilizamos uma combinação de leitura de fluxo e comandos encadeados por pipes (o caractere de barra vertical que passa a saída de um comando como entrada para o seguinte). O processo lê o arquivo linha por linha, separa os valores com base nas vírgulas e mapeia cada célula para o respectivo título da coluna. Veja abaixo um exemplo funcional de script que lê o CSV e devolve uma lista de objetos JSON organizados:

cat dados.csv | awk 'NR==1 {split($0, headers, ","); next} { 
  print "{"; 
  n=split($0, fields, ","); 
  for (i=1; i<=n; i++) 
    print "  \"" headers[i] "\": \"" fields[i] "\"" (i==n ? "" : ","); 
  print "}"; 
}'

Esse pequeno bloco utiliza o awk para ler o cabeçalho na primeira linha e associar cada coluna subsequente ao seu respectivo valor textual, gerando um formato estruturado que pode ser refinado posteriormente.

Lidando com tipos de dados e valores numéricos

Um dos desafios mais comuns ao converter arquivos tabulares em JSON é que o CSV original trata tudo estritamente como texto simples. Se a sua tabela possui colunas com números inteiros, valores monetários ou booleanos (verdadeiro ou falso), o comando básico gerará tudo entre aspas como strings. Para evitar esse comportamento indesejado, podemos refinar o comando adicionando funções de tratamento de tipo na lógica de processamento, garantindo que números sejam salvos como números reais e não como textos, facilitando análises posteriores.

Validando e salvando o resultado final

Depois de executar o comando e visualizar o resultado na tela, o passo final consiste em redirecionar essa saída para um arquivo físico e validar se a estrutura sintática está perfeita. No terminal, usamos o caractere de maior (>) para salvar o fluxo em um novo arquivo com extensão json. Em seguida, podemos executar o próprio jq sem nenhum argumento extra apenas apontando para o arquivo gerado; se ele não retornar nenhum erro de sintaxe, significa que a conversão foi concluída com total sucesso e está pronta para consumo. Para aprofundar esses conceitos na prática em produção, confira também nossa análise técnica sobre Como testar um MOSFET de canal N com multímetro na bancada.

Considerações finais

Dominar a manipulação de formatos de dados diretamente na linha de comando amplia drasticamente a autonomia de quem trabalha com tecnologia, engenharia ou análise de dados. A combinação entre utilitários Unix tradicionais e o poder do jq elimina dependências de bibliotecas complexas em linguagens de programação para tarefas pontuais. Com prática, essa abordagem se torna um reflexo natural para resolver problemas de integração e limpeza de dados de forma imediata e elegante.