JSON para CSV

Como usar JSON para CSV

JSON e CSV são os dois formatos mais comuns para transferência e armazenamento de dados tabulares, e cada um tem seu domínio natural. JSON nasceu para dados hierárquicos: objetos aninhados, arrays tipados, estruturas flexíveis. CSV é plano por definição: linhas e colunas, tudo texto. A conversão faz sentido quando o JSON representa uma tabela real, tipicamente um array de objetos com as mesmas chaves em cada elemento.

CSV é o formato universal de troca com planilhas, como Excel, Google Sheets e LibreOffice, e com ferramentas de análise como pandas em Python, R e plataformas de BI. Mesmo que seu sistema produza JSON, exportar para CSV permite que usuários não técnicos explorem e filtrem dados sem precisar de código. Para importações em bancos de dados relacionais, inserções via COPY no PostgreSQL ou LOAD DATA no MySQL, e relatórios automáticos, CSV é a entrada esperada.

A conversão tem limitações estruturais. Valores aninhados como objetos dentro de objetos e arrays de valores não existem no modelo plano do CSV. Esta ferramenta trata esses casos de forma previsível: strings, números, booleanos e null viram células simples; objetos e arrays aninhados são serializados como texto JSON na célula. Se precisar de achatamento real da estrutura, aplique o flatten no JSON antes de converter.

O separador padrão é a vírgula, mas em localidades europeias onde a vírgula é separador decimal, o Excel pode interpretar o arquivo errado. Nesse caso, considere ponto-e-vírgula ou abra pelo assistente de importação. Campos com vírgulas, aspas duplas ou quebras de linha são automaticamente envolvidos em aspas duplas conforme a RFC 4180.