Anúncios incomodam? Ir Sem anúncios Hoje 

Formatação e validação de NDJSON

DadosDesenvolvedorTexto

ANUNCIADO Remover?

ENTRADA

Processo Automático

SAÍDA

Lado cliente

ANUNCIADO Remover?

Guia

Formatação e validação de NDJSON

Cole um documento de Newline-Delimited JSON (NDJSON / JSON Lines) e verifique cada registro de forma simultânea. Cada linha é analisada independentemente, então um registro quebrado não oculta os demais. A ferramenta exibe o número de linhas válidas e inválidas, as chaves de nível superior mais comuns e o erro de análise exato para qualquer linha que falhe — ideal para fluxos de log, exportações do BigQuery e payloads de bulk do Elasticsearch.

Como usar

Cole seu conteúdo NDJSON no campo de entrada ou arraste um .ndjson / .jsonl / .txt arquivo usando o carregador.
Escolha um modo de formatação: Compacto mantém um registro por linha (verdadeiro NDJSON), ou Formatado reescrita de cada registro com indentação e separadores de linha em branco.
Alternar Pular linhas em branco se seus dados possuem linhas vazias extras que deseja remover, e Ordenar chaves para diferenças determinísticas.
Consulte a seção de estatísticas para o total, número de linhas válidas e inválidas e mensagens de erro por linha, depois copie ou baixe a saída formatada.

Características

Validação por linha – cada linha é analisada independentemente com a mensagem exata do erro do JavaScript JSON.parse e o número de linha original.
Modos Compacto e Formatado – alternar entre o NDJSON estrito de um registro por linha e formatação humana de múltiplas linhas conforme necessário.
Distribuição de chaves principais – veja quais campos de nível superior aparecem com mais frequência entre registros válidos, útil para descoberta de esquema ad hoc.
Ordenar chaves – alfabetizar chaves de objetos profundamente para diferenças reprodutíveis e hashes estáveis.
Tratamento de linhas em branco – contar e opcionalmente remover linhas vazias que algumas ferramentas inserem em fluxos de log.
Amigável para arquivos e clipboard – carregue arquivos grandes, copie a saída limpa para o clipboard ou baixe-a como um arquivo NDJSON pronto para pipetagem.
Executa totalmente no navegador – nada é carregado; a ferramenta é segura para dados de log sensíveis e exportações.

Quando usar NDJSON

O NDJSON é o formato de fato para streaming JSON: logs de contêineres Docker e Kubernetes, corpos do Elasticsearch _bulk bodies, exportações do BigQuery, trabalhos em lote do OpenAI e ingestão do Loki usam um objeto JSON independente por linha. Um formatação padrão de JSON para para o primeiro caractere de nova linha, enquanto esta ferramenta foi desenvolvida especificamente para esse formato.

ANUNCIADO Remover?

 Perguntas frequentes

Qual a diferença entre JSON e NDJSON?

O JSON padrão codifica um único valor (objeto, array, número, string, booleano ou nulo) por documento. O NDJSON, também chamado de JSON Lines ou LDJSON, codifica um valor JSON independente por linha, separado por um caractere de nova linha. O NDJSON é streamável: um analisador pode processar registros à medida que chegam sem carregar todo o arquivo na memória, o que é a razão pela qual domina pipelines de log e APIs em massa.
Por que os registros NDJSON não podem conter novas linhas não escapadas?

O caractere de nova linha é o separador de registro no NDJSON, então qualquer nova linha não escapada dentro de um valor dividiria um registro em dois. O formato exige que o codificador JSON produza uma representação compacta por registro, com novas linhas escritas como a sequência de escape backslash-n. O JSON formatado com indentação e objetos multilinhas, portanto, não é válido NDJSON.
O NDJSON é o mesmo que JSON Lines e LDJSON?

Na prática, sim. O NDJSON (newline-delimited JSON), JSON Lines (jsonlines.org) e LDJSON (line-delimited JSON) descrevem a mesma convenção: um valor JSON por linha, separado por U+000A nova linha. Diferenças menores existem sobre se espaços em branco no final, o BOM UTF-8 ou terminações de linha com retorno de carro são toleradas, mas todos os analisadores úteis aceitam registros simples separados por LF.
Como a validação por linha difere da validação do documento inteiro?

Com um analisador padrão de JSON, o primeiro erro de sintaxe interrompe a análise completa e oculta quaisquer problemas posteriores. A validação por linha executa um analisador independente por linha, então cada registro é bem-sucedido ou exibe sua própria mensagem de erro e número de linha. Isso isolar registros quebrados, permite continuar importando os válidos e torna a comparação de mudanças de produtor muito mais fácil.
Qual tipo MIME e extensão de arquivo deve usar o NDJSON?

O tipo de mídia registrado pela IANA para NDJSON é application/x-ndjson, e application/jsonl também é amplamente aceito. As extensões convencionais são .ndjson e .jsonl. Usar .json para um arquivo com novas linhas é tecnicamente incorreto e quebra ferramentas que detectam automaticamente o formato a partir da extensão.