O que é um arquivo NDJSON?

NDJSON — JSON por linhas

O que é?

O NDJSON organiza um objeto JSON completo por linha, sem colchetes envolventes nem vírgulas entre as linhas. Cada linha é lida de forma independente das outras.

A vantagem é decisiva para grandes volumes: um arquivo JSON tradicional precisa ser carregado por inteiro na memória antes de ser utilizável. Um NDJSON é lido linha a linha — assim, é possível processar um arquivo de 50 GB numa máquina com apenas 8 GB de memória.

História e origem

A convenção se impôs naturalmente com a ascensão do processamento de dados em fluxo, à medida que os volumes tornavam inviável o carregamento integral de um arquivo.

Tornou-se o formato de facto para logs de aplicações e exportações de bancos de dados volumosos.

Por que é prático

É processado em fluxo, linha por linha, independentemente do volume total do arquivo.

Uma linha corrompida não invalida o restante — ao contrário de um JSON tradicional, em que uma única vírgula mal colocada torna o arquivo inteiro inutilizável.

Limites e defeitos

Não é um JSON válido em sentido estrito: um analisador convencional o rejeitará.

Não possui especificação oficial, o que abre espaço para variantes.

Dicas de uso

O NDJSON é o formato indicado para logs, exportações massivas ou fluxos de dados.

Para utilizá-lo numa planilha, converta-o para CSV — desde que a estrutura seja plana.

Converta seu NDJSON em segundos, nos nossos servidores seguros na França.

Converter um NDJSON