.NDJSON estensione file

"Errore di analisi JSON" quando si utilizza un normale parser JSON

Molti parser JSON si aspettano un singolo documento JSON (spesso un oggetto o un array). Un file NDJSON contiene più testi JSON separati da ritorni a capo, quindi un parser che prevede un documento potrebbe non riuscire dopo la prima riga.

1. Conferma che il file sia NDJSON: ogni riga dovrebbe essere un valore JSON completo (comunemente un oggetto).
2. Utilizza un lettore/parser che supporti NDJSON/JSON delimitato da nuova riga (streaming JSON riga per riga) oppure dividi il file per righe e analizza ciascuna riga separatamente.

Una riga non è un JSON valido, interrompendo l'elaborazione a metà

NDJSON richiede che ogni record sia un JSON valido su una singola riga. Se un record contiene un ritorno a capo senza caratteri di escape all'interno di una stringa o la riga è troncata/danneggiata, gli strumenti potrebbero non riuscire su quella riga.

1. Individua il numero di riga errata (molti strumenti lo segnalano) e controlla quella riga specifica in un editor di testo.
2. Correggere o rimuovere il record non valido; assicurarsi che i ritorni a capo incorporati nelle stringhe siano correttamente sottoposti a escape e che ogni valore JSON rimanga su una riga.

Il file si apre come testo normale, ma sembra "non formattato" o difficile da leggere

NDJSON è ottimizzato per lo streaming piuttosto che per la leggibilità umana. Ogni riga può essere minimizzata JSON senza rientro.

1. Utilizza un editor di testo con funzionalità di formattazione JSON per stampare in modo gradevole singole righe (record per record).
2. Se hai bisogno di un singolo documento JSON, converti le righe in un array JSON con uno strumento/flusso di lavoro che legge NDJSON e restituisce JSON standard.

Tipo di contenuto/aspettative di tipo MIME errate in un'API o in una pipeline

NDJSON utilizza comunemente il tipo di supporto application/x-ndjson secondo le specifiche ndjson, ma questo non è un sottotipo registrato IANA; alcuni sistemi potrebbero aspettarsi qualcos'altro o trattarlo come testo generico.

1. Se controlli il mittente, imposta Content-Type su application/x-ndjson quando interagisci con sistemi che riconoscono la convenzione ndjson-spec.
2. Se hai bisogno di un'alternativa standardizzata per lo streaming JSON, prendi in considerazione le sequenze di testo JSON RFC 7464 (application/json-seq) dove supportate.

NDJSON è uguale a JSON?

Utilizza la stessa sintassi JSON, ma un file NDJSON contiene più testi JSON separati da ritorni a capo (uno per riga). Un tipico file .json contiene solitamente un documento JSON (spesso un oggetto o un array).

Quale tipo MIME dovrei usare per .ndjson?

Le specifiche ndjson consigliano application/x-ndjson. Si tratta di una convenzione ampiamente utilizzata, ma non è un sottotipo di tipo multimediale registrato da IANA (a differenza di application/json-seq di RFC 7464 per sequenze di testo JSON).

Perché Kibana esporta .ndjson?

L'esportazione degli oggetti salvati Kibana di Elastic utilizza NDJSON in modo che ogni riga sia un singolo documento, semplificando lo streaming, l'importazione e l'elaborazione dei record uno per uno.

Qual è l'alternativa standardizzata per lo streaming di sequenze JSON?

RFC 7464 definisce le "sequenze di testo JSON" con il tipo di supporto application/json-seq. Utilizza un approccio di framing diverso rispetto a NDJSON ed è standardizzato tramite RFC.