Come aprire file .JSONL su Mac
Per aprire file .JSONL su Mac, apri il file in un editor di testo normale (ad esempio, TextEdit in modalità testo normale) per visualizzare i record JSON per riga.
Istruzioni passo passo
- Apri il file in un editor di testo normale (ad esempio, TextEdit in modalità testo normale) per visualizzare i record JSON per riga.
- Per l'analisi, caricalo in Python/pandas utilizzando pandas.read_json(path, lines=True).
Problemi comuni
"Non verrà analizzato come JSON" (previsto un singolo documento JSON)
Un file .jsonl non è in genere un singolo array o oggetto JSON; sono molti valori JSON separati da caratteri di fine riga. Gli strumenti che prevedono un documento JSON per l'intero file potrebbero non riuscire con errori dopo la prima riga.
- Utilizza un lettore che supporti JSON delimitato da righe (ad esempio, pandas.read_json(..., lines=True)).
- Se uno strumento richiede un singolo array JSON, convertilo racchiudendo i record in un array e inserendo virgole tra le righe (solo se ogni riga è JSON valido).
Alcune righe non riescono ad analizzare (record JSON non validi)
Ogni riga deve essere testo JSON valido in base a RFC 8259. Una singola riga interrotta (output troncato, virgolette senza caratteri di escape, rifiuti finali) può causare il fallimento delle importazioni parziali.
- Controllare le righe non funzionanti in un editor di testo; verificare che ogni riga sia JSON completa (spesso un singolo oggetto).
- Rigenerare il file dal sistema di origine se è stato troncato oppure rimuovere/riparare solo le righe con formato errato prima di reimportarlo.
Problemi di codifica dei caratteri (testo confuso o errori di decodifica)
JSON è definito come testo Unicode ed è comunemente codificato come UTF-8. Se il file è stato prodotto con una codifica diversa o contiene sequenze di byte non valide, alcuni lettori genereranno un errore o visualizzeranno mojibake.
- Prova a riaprire il file con la codifica UTF-8 nel tuo editor o nello strumento di importazione.
- Se controlli la generazione, assicurati che il produttore scriva UTF-8 e che ogni record rimanga un testo JSON valido.
Sembra linee JSON ma in realtà sono sequenze di testo JSON (RFC 7464)
Alcuni JSON di streaming utilizzano il framing RFC 7464 (separatore di record + testo JSON) e sono associati a application/json-seq, non a JSON delimitato da nuova riga. Un lettore di linee JSON potrebbe non gestire il carattere di framing aggiuntivo.
- Verificare la presenza di un separatore di record ASCII iniziale (0x1E) prima di ogni testo JSON; che indica sequenze di testo JSON RFC 7464.
- Se si tratta di RFC 7464, utilizzare strumenti che supportino sequenze di testo JSON o eliminare il framing RS prima di trattarlo come JSON delimitato da righe.
Nota di sicurezza
Un file .jsonl è testo semplice e non contiene codice eseguibile di per sé, ma può comunque essere pericoloso da elaborare se i sistemi downstream trattano i suoi campi come codice (ad esempio, inserendo stringhe non attendibili in SQL, comandi shell o modelli).