JSON a 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.

JSON and CSV are the two most common formats for transferring and storing tabular data, each with its natural domain. JSON was born for hierarchical data: nested objects, typed arrays, flexible structures. CSV is flat by definition: rows and columns, everything text. The conversion makes sense when the JSON represents a real table, typically an array of objects with the same keys in every element.

CSV is the universal exchange format with spreadsheets such as Excel, Google Sheets, and LibreOffice, and with analysis tools like pandas in Python, R, and BI platforms. Even if your system produces JSON, exporting to CSV lets non-technical users explore and filter data without writing code. For imports into relational databases, bulk inserts via COPY in PostgreSQL or LOAD DATA in MySQL, and automated reports, CSV is the expected input format.

The conversion has structural limitations. Nested values such as objects within objects and value arrays do not exist in the flat CSV model. This tool handles those cases predictably: strings, numbers, booleans, and null become simple cells; nested objects and arrays are serialized as JSON text in the cell. If you need real structural flattening, apply it to the JSON before converting.

The default separator is a comma, but in European locales where a comma is the decimal separator, Excel may misread the file. In that case, consider semicolons or use the spreadsheet import wizard. Fields containing commas, double quotes, or line breaks are automatically wrapped in double quotes per RFC 4180.

JSON y CSV son los dos formatos más habituales para transferir y almacenar datos tabulares, cada uno con su dominio natural. JSON nació para datos jerárquicos: objetos anidados, arrays tipados, estructuras flexibles. CSV es plano por definición: filas y columnas, todo texto. La conversión tiene sentido cuando el JSON representa una tabla real, típicamente un array de objetos con las mismas claves en cada elemento.

CSV es el formato universal de intercambio con hojas de cálculo como Excel, Google Sheets y LibreOffice, y con herramientas de análisis como pandas en Python, R y plataformas de BI. Aunque tu sistema produzca JSON, exportar a CSV permite que usuarios no técnicos exploren y filtren datos sin escribir código. Para importaciones en bases de datos relacionales, inserciones masivas con COPY en PostgreSQL o LOAD DATA en MySQL y reportes automáticos, CSV es el formato de entrada esperado.

La conversión tiene limitaciones estructurales. Los valores anidados, como objetos dentro de objetos y arrays de valores, no existen en el modelo plano de CSV. Esta herramienta los trata de forma predecible: cadenas, números, booleanos y null se convierten en celdas simples; los objetos y arrays anidados se serializan como texto JSON en la celda. Si necesitas un aplanamiento estructural real, aplícalo al JSON antes de convertir.

El separador predeterminado es la coma, pero en configuraciones regionales europeas donde la coma es el separador decimal, Excel puede interpretar mal el archivo. En ese caso, considera el punto y coma o usa el asistente de importación. Los campos con comas, comillas dobles o saltos de línea se envuelven automáticamente en comillas dobles según la RFC 4180.