.JSONL Dateiendung

„Es wird nicht als JSON geparst“ (ein einzelnes JSON-Dokument erwartet)

Eine .jsonl-Datei ist normalerweise kein einzelnes JSON-Array oder -Objekt; Es handelt sich um viele durch Zeilenumbrüche getrennte JSON-Werte. Tools, die ein JSON-Dokument für die gesamte Datei erwarten, schlagen möglicherweise mit Fehlern nach der ersten Zeile fehl.

1. Verwenden Sie einen Reader, der zeilengetrenntes JSON unterstützt (z. B. pandas.read_json(...,lines=True)).
2. Wenn ein Tool ein einzelnes JSON-Array erfordert, konvertieren Sie es, indem Sie Datensätze in ein Array einschließen und Kommas zwischen den Zeilen einfügen (nur wenn jede Zeile gültiges JSON ist).

Einige Zeilen können nicht analysiert werden (fehlerhafte JSON-Datensätze).

Jede Zeile muss ein gültiger JSON-Text gemäß RFC 8259 sein. Eine einzelne unterbrochene Zeile (abgeschnittene Ausgabe, Anführungszeichen ohne Escapezeichen, nachgestellter Müll) kann dazu führen, dass Teilimporte fehlschlagen.

1. Überprüfen Sie die fehlerhafte(n) Zeile(n) in einem Texteditor; Überprüfen Sie, ob jede Zeile ein vollständiger JSON-Code ist (häufig ein einzelnes Objekt).
2. Generieren Sie die Datei aus dem Quellsystem neu, wenn sie abgeschnitten wurde, oder entfernen/reparieren Sie nur die fehlerhaften Zeilen, bevor Sie sie erneut importieren.

Probleme mit der Zeichenkodierung (verstümmelter Text oder Dekodierungsfehler)

JSON ist als Unicode-Text definiert und wird üblicherweise als UTF-8 codiert. Wenn die Datei in einer anderen Kodierung erstellt wurde oder ungültige Bytesequenzen enthält, kommt es bei einigen Lesegeräten zu Fehlern oder der Anzeige von Mojibake.

1. Versuchen Sie, die Datei mit UTF-8-Kodierung in Ihrem Editor oder Importtool erneut zu öffnen.
2. Wenn Sie die Generierung steuern, stellen Sie sicher, dass der Produzent UTF-8 schreibt und dass jeder Datensatz gültiger JSON-Text bleibt.

Sieht aus wie JSON-Zeilen, ist aber in Wirklichkeit JSON-Textsequenzen (RFC 7464).

Einige Streaming-JSONs verwenden RFC 7464-Framing (Datensatztrennzeichen + JSON-Text) und sind mit application/json-seq verknüpft, nicht mit durch Zeilenumbrüche getrenntem JSON. Ein JSON Lines-Reader kann das zusätzliche Rahmenzeichen möglicherweise nicht verarbeiten.

1. Suchen Sie vor jedem JSON-Text nach einem führenden ASCII-Datensatztrennzeichen (0x1E). das gibt RFC 7464 JSON-Textsequenzen an.
2. Wenn es sich um RFC 7464 handelt, verwenden Sie Tools, die JSON-Textsequenzen unterstützen, oder entfernen Sie den RS-Rahmen, bevor Sie ihn als zeilengetrennten JSON behandeln.

Was ist der Unterschied zwischen .json und .jsonl?

.json ist normalerweise ein JSON-Wert für die gesamte Datei (häufig ein Objekt oder ein Array). .jsonl (JSON Lines) speichert viele JSON-Werte, einen pro Zeile, sodass er Datensatz für Datensatz gestreamt und verarbeitet werden kann.

Benötige ich spezielle Software, um eine .jsonl-Datei zu öffnen?

Nein – jeder Texteditor kann es öffnen, da es sich um einfachen Text handelt. Verwenden Sie für die Analyse/den Import Tools, die zeilengetrenntes JSON verstehen (z. B. pandas.read_json mitlines=True).

Ist .jsonl dasselbe wie NDJSON?

Sie werden in der Praxis häufig synonym verwendet: Beide beschreiben durch Zeilenumbrüche getrennte JSON-Datensätze (ein JSON-Text pro Zeile). Die NDJSON-Spezifikation ist eine häufig referenzierte Beschreibung dieses Stils.

Welchen MIME-Typ sollte ich für .jsonl verwenden?

Die bereitgestellten Quellen führen keinen offiziellen IANA-Medientyp speziell für JSON Lines auf. IANA registriert application/json für JSON und application/json-seq für RFC 7464 JSON-Textsequenzen; JSON Lines hängt mit dem Streaming von JSON zusammen, ist aber nicht dasselbe wie application/json-seq.