JSON zu JSONL abflachen

Datensätze aus verschachtelten JSON-Objekten und -Arrays extrahieren und ins JSONL-Format (JSON Lines) überführen. Jeder Datensatz steht in einer eigenen Zeile. Die Verarbeitung erfolgt zu 100 % im Browser.

JSON-Eingabe

Ziehen Sie eine .json-Datei hierher oder klicken Sie, um eine Datei auszuwählen

Unterstützte Formate: .json, .txt

JSONL-Ausgabe

Verschachteltes JSON einfügen oder ablegen, um in JSONL abzuflachen

Was bedeutet es, JSON abzuflachen?

Beim Abflachen von JSON wird eine tief verschachtelte JSON-Struktur in ein flaches, zeilenbasiertes Format überführt. Die Schlüssel verschachtelter Objekte werden in Punktnotation zusammengefasst (z. B. address.city). Arrays mit Objekten werden so aufgelöst, dass jedes Element einen eigenen Datensatz im JSONL-Format bildet.

Das ist besonders nützlich, wenn Sie API-Antworten oder Datenbankexporte mit komplexen Verschachtelungen in ein flaches Tabellenformat umwandeln müssen: etwa für das Training von ML-Modellen, die Konvertierung in CSV oder Streaming-Datenpipelines, die einen Datensatz pro Zeile erwarten.

Zwei Methoden zum Abflachen eines Arrays — passend zum Ziel auswählen

Bei verschachtelten Objekten liegt die Vorgehensweise nahe: Die Schlüssel werden mit Punkten verbunden. Bei Arrays müssen Sie dagegen entscheiden, wie die Daten aufgelöst werden sollen. Die passende Strategie hängt davon ab, wo Sie die abgeflachten Daten anschließend verwenden:

StrategieAus [{"sku":"A"},{"sku":"B"}] wirdGeeignet, wenn …
Über Indizes in Spalten auflösenitems.0.sku = A, items.1.sku = B — eine Zeile, mehr Spaltendie Zeilenanzahl gegenüber der Eingabe gleich bleiben muss und die Arrays kurz sowie in ihrer Länge begrenzt sind
In einzelne Zeilen auflösenZwei Zeilen mit jeweils items.sku — mehr Zeilen, gleichbleibende SpaltenSie die Daten in SQL oder für Analysen verwenden und jedes Array-Element einen eigenen Datensatz darstellt
Als JSON-String beibehaltenitems = "[{\"sku\":\"A\"},...]" — eine Zelle, deren Inhalt nicht weiter aufgeschlüsselt wirddas Array Metadaten enthält, die Sie später erneut parsen möchten und jetzt nicht abfragen müssen

So flachen Sie JSON zu JSONL ab

Beim Abflachen von JSON zu JSONL werden Datensätze aus verschachtelten Strukturen extrahiert und jeweils in eine eigene JSONL-Zeile geschrieben. Enthält Ihr JSON ein Array mit Objekten, wird jedes Array-Element zu einer Zeile. Die Schlüssel verschachtelter Objekte werden dabei in Punktnotation zusammengefasst.

Das Tool läuft vollständig in Ihrem Browser. Es werden keine Daten an einen Server gesendet. Fügen Sie Ihr verschachteltes JSON ein oder ziehen Sie eine Datei per Drag & Drop in das Tool. Die abgeflachte JSONL-Ausgabe erscheint sofort. Felder aus übergeordneten Ebenen werden automatisch in jeden Datensatz übernommen.

Die Ausgabe ist gültiges JSONL mit einem kompakten JSON-Objekt pro Zeile. Sie können das Ergebnis in die Zwischenablage kopieren oder als .jsonl-Datei herunterladen und direkt für Machine Learning, Datenpipelines oder den Import in eine Datenbank verwenden.

Vorher und nachher

Ein typischer verschachtelter Datensatz und seine flache Form, bei der Array-Elemente über ihre Indizes aufgelöst werden. Die Wahl des Trennzeichens ist dabei entscheidend: Mit einem Punkt als Trennzeichen würde ein Schlüssel wie "config.debug" in den Quelldaten mit dem abgeflachten Pfad config.debug kollidieren. Wenn Ihre Schlüssel Punkte enthalten, verwenden Sie stattdessen einen Unterstrich als Trennzeichen:

// Vorher — verschachtelter Datensatz:
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}


// Nachher — mit Punkt als Trennzeichen abgeflacht, Arrays durch Index-Expansion verarbeitet:
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}

Das Abflachen ist ein üblicher Vorbereitungsschritt für den Export nach CSV oder Excel: Diese Formate sind tabellarisch und können keine Verschachtelungen abbilden. Bei tief verschachtelten Eingaben können sehr viele Spalten entstehen. Flachen Sie deshalb zuerst eine Stichprobe ab und prüfen Sie, ob die Spaltenanzahl plausibel ist, bevor Sie die gesamte Datei verarbeiten.

Häufige Anwendungsfälle

API-Antworten verarbeiten
Flachen Sie verschachtelte API-Antworten zu JSONL ab, um das Parsen, das Logging und die anschließende Verarbeitung in Datenpipelines zu vereinfachen.
Daten für ETL-Prozesse transformieren
Extrahieren Sie Datensätze aus komplexen JSON-Exporten und flachen Sie sie zu JSONL ab, um sie in Datenbanken oder Data Warehouses zu laden.
ML-Datensätze vorbereiten
Wandeln Sie verschachtelte JSON-Datensätze in flache JSONL-Datensätze um, wie sie OpenAI, Hugging Face und andere Plattformen für das ML-Training benötigen.
Logs und Analysedaten verarbeiten
Flachen Sie strukturierte Logdateien mit verschachtelten Metadaten zu JSONL ab, um sie mit Tools wie grep, jq oder Elasticsearch zu analysieren.
Testdaten erzeugen
Flachen Sie komplexe JSON-Mock-Antworten von APIs zu einzelnen JSONL-Datensätzen ab, die Sie als Test-Fixtures in automatisierten Testsuites verwenden können.
Datenbanken migrieren
Flachen Sie verschachtelte, dokumentbasierte JSON-Exporte aus MongoDB oder CouchDB zu JSONL-Datensätzen ab, um sie in relationale Datenbanken wie PostgreSQL zu importieren.

Häufige Fehler und ihre Lösungen

Keine Datensätze zum Abflachen gefunden

Dieser Fehler tritt auf, wenn die JSON-Eingabe ein primitiver Wert (String, Zahl), ein leeres Objekt oder ein leeres Array ist. Das Tool benötigt Objekte oder Arrays mit Objekten, um Datensätze zu extrahieren. Stellen Sie sicher, dass Ihr JSON mindestens ein Objekt mit Schlüssel-Wert-Paaren enthält.

Schlüsselkonflikte durch Punktnotation

Wenn Ihr JSON auf oberster Ebene einen Schlüssel wie "user.name" und zugleich ein verschachteltes Objekt wie {"user":{"name":"value"}} enthält, entsteht beim Abflachen für beide derselbe Schlüssel in Punktnotation. Der verschachtelte Wert überschreibt den Wert auf oberster Ebene. Benennen Sie die betroffenen Schlüssel vor dem Abflachen um.

Zirkuläre Referenzen in JSON

Standardkonformes JSON kann keine zirkulären Referenzen enthalten. Manche JSON-Generatoren erzeugen jedoch sehr tief verschachtelte Strukturen, die solchen Referenzen ähneln. Das Tool verarbeitet auch tiefe Verschachtelungen, bricht das Abflachen aber ab, wenn die Struktur die Grenzen einer sicheren Verarbeitung überschreitet.

Häufig gestellte Fragen

Wie werden verschachtelte Objekte abgeflacht?

Die Schlüssel verschachtelter Objekte werden in Punktnotation zusammengefasst. Beispielsweise wird aus {"user":{"address":{"city":"NYC"}}} die flache Struktur {"user.address.city":"NYC"}. So lassen sich auch tief verschachtelte Daten als flache Schlüssel-Wert-Paare ansprechen.

Was passiert mit Arrays im JSON?

Enthält das JSON ein Array mit Objekten, wird jedes Objekt zu einer eigenen JSONL-Zeile. Arrays mit primitiven Werten (Strings, Zahlen) werden in der abgeflachten Ausgabe als JSON-Strings serialisiert. Das Tool erkennt automatisch das Haupt-Array, das aufgelöst werden soll.

Sind meine Daten beim Abflachen sicher?

Ja. Das Abflachen erfolgt vollständig lokal in Ihrem Browser. Es werden keine Daten an einen Server gesendet. Ihre JSON-Daten verlassen Ihr Gerät zu keinem Zeitpunkt.

Kann ich JSON mit unterschiedlich tief verschachtelten Strukturen abflachen?

Ja. Das Tool verarbeitet jede Verschachtelungstiefe. Skalare Felder auf oberster Ebene werden in jeden Datensatz übernommen, verschachtelte Objekte werden in Punktnotation dargestellt und das größte Array mit Objekten wird in einzelne JSONL-Zeilen aufgelöst.

Wie werden null- und undefined-Werte beim Abflachen behandelt?

Null-Werte bleiben in der abgeflachten Ausgabe als null erhalten. JSON kennt keinen undefined-Typ, daher treten auch keine undefined-Werte auf. Leere Objekte entfallen beim Abflachen (es werden keine Schlüssel erzeugt), und leere Arrays werden als leere JSON-Arrays serialisiert.

Kann ich mehrere JSON-Dateien gleichzeitig abflachen?

Das Tool verarbeitet derzeit jeweils eine JSON-Eingabe. Wenn Sie mehrere Dateien abflachen möchten, verarbeiten Sie diese nacheinander. Für die Stapelverarbeitung bieten sich Kommandozeilentools wie jq an; mit diesem Tool können Sie die Ergebnisse visuell überprüfen.

Welche maximale Verschachtelungstiefe unterstützt das Tool?

Das Tool unterstützt die in der Praxis üblichen Verschachtelungstiefen von JSON-Daten (in der Regel bis zu 20+ Ebenen). Es gibt keine fest im Code definierte Tiefenbegrenzung. Bei extrem tiefen Verschachtelungen können allerdings sehr lange Schlüssel in Punktnotation entstehen.

Wie unterscheidet sich dieses Tool von einer einfachen Konvertierung von JSON zu JSONL?

Eine einfache JSON-zu-JSONL-Konvertierung schreibt jedes Element eines Arrays auf oberster Ebene in eine eigene Zeile. Beim Abflachen von JSON zu JSONL werden zusätzlich verschachtelte Strukturen aufgelöst, die Schlüssel verschachtelter Objekte in Punktnotation zusammengefasst und Felder aus übergeordneten Ebenen in jeden Datensatz übernommen. Nutzen Sie das Abflachen, wenn Sie Datensätze aus tief verschachteltem JSON extrahieren müssen.

Verwandte Tools & Anleitungen