- Início
- Ferramentas
- Achatar JSON para JSONL
Achatar JSON para JSONL
Extraia e achate objetos e arrays JSON aninhados no formato JSONL (JSON Lines). Cada registro fica em uma linha separada. O processamento é feito 100% no navegador.
JSON de entrada
Solte um arquivo .json aqui ou clique para selecionar
Aceita .json e .txt
JSONL de saída
Cole ou arraste um JSON aninhado para achatá-lo em JSONL
O que é achatamento de JSON?
Achatar JSON é transformar uma estrutura JSON com vários níveis de aninhamento em um formato plano, com um registro por linha. As chaves dos objetos aninhados são convertidas para notação de ponto (por exemplo, address.city), e os arrays de objetos são expandidos para que cada elemento vire um registro separado no formato JSONL.
Isso é especialmente útil quando você tem respostas de APIs ou exportações de bancos de dados com estruturas complexas de aninhamento e precisa convertê-las em um formato tabular plano para treinar modelos de aprendizado de máquina, converter para CSV ou alimentar pipelines de dados em streaming que esperam um registro por linha.
Duas formas de achatar um array — escolha conforme o destino dos dados
Para objetos aninhados, o achatamento tem um caminho claro: unir as chaves com pontos. Já os arrays exigem uma escolha. A estratégia adequada depende de onde os dados achatados serão usados:
| Estratégia | [{"sku":"A"},{"sku":"B"}] se torna | Quando usar |
|---|---|---|
| Expansão por índice | items.0.sku = A, items.1.sku = B — uma linha, mais colunas | Quando o número de linhas precisa ser igual ao da entrada e os arrays são curtos e têm tamanho limitado |
| Expandir em linhas | Duas linhas, cada uma com items.sku — mais linhas, as mesmas colunas | Ao alimentar SQL ou ferramentas de análise em que cada elemento do array representa um registro independente |
| Manter como string JSON | items = "[{\"sku\":\"A\"},...]" — uma célula cujo conteúdo não é desmembrado | Quando o array contém metadados que você vai interpretar novamente depois, em vez de dados para consultar agora |
Como achatar JSON para JSONL
Ao achatar JSON para JSONL, a ferramenta extrai registros de estruturas aninhadas e coloca cada um em uma linha separada do JSONL. Se o seu JSON contiver um array de objetos, cada elemento do array vira uma linha. As chaves dos objetos aninhados passam a usar notação de ponto.
A ferramenta funciona inteiramente no seu navegador. Nenhum dado é enviado a servidores. Basta colar seu JSON aninhado ou arrastar e soltar um arquivo para ver o JSONL achatado na hora. Os campos do nível pai são incorporados automaticamente a cada registro.
O resultado é um JSONL válido, com um objeto JSON compacto por linha. Você pode copiá-lo para a área de transferência ou baixá-lo como um arquivo .jsonl, pronto para uso em aprendizado de máquina, pipelines de dados ou importação para bancos de dados.
Antes e depois
Um exemplo realista de registro aninhado e sua versão plana, com arrays expandidos por índice. Veja como a escolha do separador faz diferença: ao usar pontos, uma chave literal como "config.debug" na origem entraria em conflito com o caminho achatado config.debug — se as suas chaves contiverem pontos, use underscore como separador:
// Antes — registro aninhado:
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}
// Depois — achatado com separador de ponto, arrays expandidos por índice:
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}O achatamento é a etapa padrão de pré-processamento antes de exportar para CSV ou Excel, pois esses formatos são tabulares e não conseguem representar estruturas aninhadas. Entradas com muitos níveis de aninhamento podem gerar resultados com um número muito grande de colunas. Por isso, achate uma amostra primeiro e confira a quantidade de colunas antes de processar o arquivo inteiro.
Casos de uso comuns
- Processamento de respostas de APIs
- Achate respostas aninhadas de APIs em JSONL para facilitar o parsing, o registro de logs e as etapas seguintes de processamento em pipelines de dados.
- Transformação de dados em ETL
- Extraia registros de exportações JSON complexas e achate-os em JSONL para carregá-los em bancos de dados ou data warehouses.
- Preparação de datasets para ML
- Converta datasets JSON aninhados em registros JSONL planos, como exigem a OpenAI, o Hugging Face e outras plataformas de treinamento de ML.
- Processamento de logs e análise de dados
- Achate arquivos de log estruturados com metadados aninhados em JSONL para analisá-los com ferramentas como grep, jq ou Elasticsearch.
- Geração de dados de teste
- Achate respostas JSON complexas de mocks de APIs em registros JSONL individuais para usá-los como fixtures em suítes de testes automatizados.
- Migração de bancos de dados
- Achate exportações de documentos JSON aninhados do MongoDB ou CouchDB em registros JSONL planos para importá-los em bancos de dados relacionais como o PostgreSQL.
Erros comuns e soluções
Nenhum registro encontrado para achatar
Este erro ocorre quando o JSON de entrada é um valor primitivo (string, número), um objeto vazio ou um array vazio. A ferramenta precisa de objetos ou arrays de objetos para extrair registros. Verifique se o seu JSON contém pelo menos um objeto com pares de chave e valor.
Conflitos de chaves em notação de ponto
Se o seu JSON tiver uma chave como "user.name" no nível superior e também um objeto aninhado {"user":{"name":"value"}}, os dois vão gerar a mesma chave em notação de ponto. O valor aninhado sobrescreverá o valor do nível superior. Renomeie as chaves em conflito antes de achatar.
Referências circulares no JSON
Embora o formato JSON padrão não permita referências circulares, alguns geradores de JSON podem criar estruturas com tantos níveis de aninhamento que parecem ter esse tipo de referência. A ferramenta processa estruturas profundamente aninhadas até uma profundidade razoável, mas interrompe o achatamento se a estrutura ultrapassar os limites seguros.
Perguntas frequentes
Como funciona o achatamento de objetos aninhados?
As chaves dos objetos aninhados são convertidas para notação de ponto. Por exemplo, {"user":{"address":{"city":"NYC"}}} vira {"user.address.city":"NYC"}. Assim, dados com vários níveis de aninhamento ficam acessíveis como pares de chave e valor em uma estrutura plana.
O que acontece com os arrays no JSON?
Se o JSON contiver um array de objetos, cada objeto vira uma linha separada no JSONL. Arrays de valores primitivos (strings, números) são serializados como strings JSON no resultado achatado. A ferramenta detecta automaticamente o array principal a ser expandido.
Meus dados estão seguros durante o achatamento?
Sim. Todo o achatamento é feito localmente no seu navegador. Nenhum dado é enviado a servidores. O conteúdo do seu JSON nunca sai do seu dispositivo.
Posso achatar um JSON com diferentes níveis de aninhamento?
Sim. A ferramenta processa qualquer nível de aninhamento. Os campos escalares do nível superior são incorporados a cada registro, os objetos aninhados usam notação de ponto e o maior array de objetos é expandido em linhas JSONL individuais.
Como os valores null e undefined são tratados durante o achatamento?
Valores null são mantidos como null no resultado achatado. O formato JSON não tem o tipo undefined, então você não encontrará valores undefined. Objetos vazios não geram nenhuma chave no achatamento, e arrays vazios são serializados como arrays JSON vazios.
Posso achatar vários arquivos JSON de uma só vez?
Atualmente, a ferramenta processa uma entrada JSON por vez. Para achatar vários arquivos, processe um de cada vez. Para operações em lote, considere usar ferramentas de linha de comando como jq junto com esta ferramenta para conferir o resultado visualmente.
Qual é a profundidade máxima de aninhamento que a ferramenta suporta?
A ferramenta aceita as profundidades de aninhamento comuns em dados JSON reais (normalmente até 20+ níveis). Não há um limite fixo de profundidade definido no código, mas estruturas com muitos níveis de aninhamento podem gerar chaves em notação de ponto muito longas no resultado.
Qual é a diferença entre achatar JSON para JSONL com esta ferramenta e fazer uma conversão simples de JSON para JSONL?
A conversão de JSON para JSONL coloca cada elemento de um array do nível superior em uma linha separada. O achatamento de JSON para JSONL também expande estruturas aninhadas, converte chaves aninhadas para notação de ponto e incorpora os campos do nível pai a cada registro. Use o achatamento quando precisar extrair registros de um JSON com vários níveis de aninhamento.
Ferramentas e guias relacionados
Converta arrays JSON para o formato JSONL. Ideal para preparar dados para streaming e treinamento de ML.
Exporte dados JSONL para planilhas CSV. Ideal para análises no Excel ou no Google Sheets.
Converta dados JSONL em planilhas no formato nativo do Excel (.xlsx). Ideal para relatórios de negócios, análise de dados e compartilhamento com pessoas de áreas não técnicas.
Valide arquivos JSONL linha por linha. Detecte erros de sintaxe, problemas de codificação e de formato instantaneamente.
Estratégias para processar gigabytes de dados JSONL: leitura por streaming, gerenciamento de memória, divisão de arquivos, compressão e ferramentas online.