JSON zu JSONL abflachen
Verschachtelte JSON-Objekte und -Arrays extrahieren und in das JSONL (JSON Lines)-Format abflachen. Jeder Datensatz wird zu einer separaten Zeile. 100 % clientseitig.
Eingabe JSON
Eine .json-Datei hier ablegen oder zum Durchsuchen klicken
Unterstützt .json, .txt
Eingabe JSON
Eine .json-Datei hier ablegen oder zum Durchsuchen klicken
Unterstützt .json, .txt
Ausgabe JSONL
Verschachteltes JSON einfügen oder ablegen, um in JSONL abzuflachen
Was ist JSON-Abflachung?
JSON-Abflachung ist der Prozess der Umwandlung einer tief verschachtelten JSON-Struktur in ein flaches, zeilenweises Format. Verschachtelte Objektschlüssel werden in Punktnotation konvertiert (z. B. address.city), und Arrays von Objekten werden erweitert, sodass jedes Element zu einem eigenen Datensatz im JSONL-Format wird.
Dies ist besonders nützlich, wenn Sie API-Antworten oder Datenbankexporte mit komplexer Verschachtelung haben und diese in ein flaches tabellarisches Format für Machine-Learning-Training, CSV-Konvertierung oder Streaming-Datenpipelines konvertieren müssen, die einen Datensatz pro Zeile erwarten.
Zwei Methoden zum Abflachen eines Arrays — passend zum Ziel auswählen
Verschachtelte Objekte lassen sich eindeutig abflachen, indem ihre Schlüssel mit Punkten verbunden werden. Bei Arrays ist hingegen eine echte Entscheidung erforderlich. Die richtige Strategie hängt davon ab, wo die abgeflachten Daten verwendet werden:
| Strategie | Aus [{"sku":"A"},{"sku":"B"}] wird | Geeignet, wenn |
|---|---|---|
| Index-Expansion | items.0.sku = A, items.1.sku = B — eine Zeile, mehr Spalten | Die Zeilenanzahl mit der Eingabe identisch bleiben muss und Arrays kurz und begrenzt sind |
| In Zeilen auflösen | Zwei Zeilen mit jeweils items.sku — mehr Zeilen, stabile Spalten | Die Daten in SQL oder Analysesysteme fließen, in denen jedes Array-Element einen eigenen Datensatz darstellt |
| Als JSON-String beibehalten | items = "[{\"sku\":\"A\"},...]" — eine nicht weiter interpretierte Zelle | Das Array Metadaten enthält, die Sie später erneut parsen, statt sie jetzt abzufragen |
Wie man JSON zu JSONL abflacht
Das Abflachen von JSON zu JSONL extrahiert Datensätze aus verschachtelten Strukturen und konvertiert jeden Datensatz in eine separate JSONL-Zeile. Wenn Ihr JSON ein Array von Objekten enthält, wird jedes Array-Element zu einer Zeile. Verschachtelte Objektschlüssel werden in Punktnotation abgeflacht.
Unser Tool arbeitet 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, und die abgeflachte JSONL-Ausgabe erscheint sofort. Felder auf übergeordneter Ebene werden automatisch in jeden Datensatz zusammengeführt.
Die Ausgabe ist gültiges JSONL mit einem kompakten JSON-Objekt pro Zeile. Sie können das Ergebnis in Ihre Zwischenablage kopieren oder als .jsonl-Datei herunterladen, bereit für Machine Learning, Datenpipelines oder Datenbankimport.
Vorher und nachher
Ein realistischer verschachtelter Datensatz und seine durch Index-Expansion abgeflachte Form. Beachten Sie die Bedeutung des Trennzeichens: Bei Punkten würde ein wörtlicher Schlüssel wie „config.debug“ in der Quelle mit dem abgeflachten Pfad config.debug kollidieren. Enthalten Ihre Schlüssel Punkte, wählen Sie stattdessen den 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 der übliche Vorverarbeitungsschritt vor einem Export nach CSV oder Excel, da diese Formate tabellarisch sind und keine Verschachtelung darstellen können. Tief verschachtelte Eingaben können sehr breite Ausgaben erzeugen. Flachen Sie daher zuerst eine Stichprobe ab und prüfen Sie die Spaltenanzahl auf Plausibilität, bevor Sie die gesamte Datei verarbeiten.
Häufige Anwendungsfälle
API-Antwortverarbeitung
Verschachtelte API-Antworten in JSONL abflachen für einfacheres Parsen, Protokollierung und nachgelagerte Verarbeitung in Datenpipelines.
ETL-Datentransformation
Datensätze aus komplexen JSON-Exporten extrahieren und in JSONL abflachen zum Laden in Datenbanken oder Data Warehouses.
ML-Datensatzvorbereitung
Verschachtelte JSON-Datensätze in flache JSONL-Datensätze konvertieren, die von OpenAI, Hugging Face und anderen ML-Trainingsplattformen benötigt werden.
Protokoll- & Analyseverarbeitung
Strukturierte Protokolldateien mit verschachtelten Metadaten in JSONL abflachen zur Analyse mit Tools wie grep, jq oder Elasticsearch.
Testdatengenerierung
Komplexe JSON-API-Mock-Antworten in einzelne JSONL-Datensätze abflachen zur Verwendung als Testdaten in automatisierten Testsuites.
Datenbankmigration
Verschachtelte dokumentenbasierte JSON-Exporte aus MongoDB oder CouchDB in flache JSONL-Datensätze abflachen für den Import in relationale Datenbanken wie PostgreSQL.
Häufige Fehler & Lösungen
Keine Datensätze zum Abflachen gefunden
Dieser Fehler tritt auf, wenn die JSON-Eingabe ein primitiver Wert (String, Zahl) oder ein leeres Objekt/Array ist. Das Tool benötigt Objekte oder Arrays von Objekten, um Datensätze zu extrahieren. Stellen Sie sicher, dass Ihr JSON mindestens ein Objekt mit Schlüssel-Wert-Paaren enthält.
Punktnotations-Schlüsselkonflikte
Wenn Ihr JSON einen Schlüssel wie "user.name" auf oberster Ebene hat und gleichzeitig ein verschachteltes {"user":{"name":"value"}'} enthält, werden beide zum selben Punktnotations-Schlüssel abgeflacht. Der verschachtelte Wert überschreibt den auf oberster Ebene. Benennen Sie konfliktbehaftete Schlüssel vor dem Abflachen um.
Zirkuläre Referenzen in JSON
Standard-JSON kann zwar keine zirkulären Referenzen enthalten, aber einige JSON-Generatoren können sehr tief verschachtelte Strukturen erzeugen, die diesen ähneln. Das Tool verarbeitet tiefe Verschachtelungen bis zu einer angemessenen Tiefe, stoppt aber das Abflachen, wenn die Struktur sichere Grenzen überschreitet.
Häufig gestellte Fragen
Was macht dieses JSON-Abflachen-Tool?
Verschachtelte Objektschlüssel werden in Punktnotation konvertiert. Zum Beispiel wird {"user":{"address":{"city":"NYC"}'}'} zu {"user.address.city":"NYC"}. Dies macht tief verschachtelte Daten als flache Schlüssel-Wert-Paare zugänglich.
Kann ich tief verschachteltes JSON zu JSONL abflachen?
Wenn das JSON ein Array von Objekten enthält, wird jedes Objekt zu einer separaten JSONL-Zeile. Arrays von Primitiven (Strings, Zahlen) werden als JSON-Strings in der abgeflachten Ausgabe serialisiert. Das Tool erkennt automatisch das Haupt-Array zum Erweitern.
Lädt dieses Tool meine JSON-Datei hoch?
Ja. Die gesamte Abflachung findet lokal in Ihrem Browser statt. Es werden keine Daten an einen Server gesendet. Ihr JSON-Inhalt verlässt niemals Ihr Gerät.
Wie wähle ich das Array zum Abflachen aus?
Ja. Das Tool verarbeitet jede Verschachtelungsebene. Skalare Felder auf oberster Ebene werden in jeden Datensatz zusammengeführt, verschachtelte Objekte verwenden Punktnotation, und das größte Array von Objekten wird in einzelne JSONL-Zeilen erweitert.
Was passiert mit skalaren (Nicht-Objekt) Array-Elementen?
Null-Werte bleiben in der abgeflachten Ausgabe als null erhalten. JSON kennt keinen undefined-Typ, sodass keine undefined-Werte auftreten. Leere Objekte werden zu nichts abgeflacht (es werden keine Schlüssel generiert), und leere Arrays werden als leere JSON-Arrays serialisiert.
Wie konvertiere ich das Ergebnis zurück in JSON?
Derzeit verarbeitet das Tool jeweils eine JSON-Eingabe. Um mehrere Dateien abzuflachen, verarbeiten Sie sie nacheinander. Für Batch-Operationen können Sie Kommandozeilentools wie jq in Kombination mit diesem Tool zur visuellen Überprüfung verwenden.
Kann ich JSON-Objekte mit gemischten Arrays und Objekten abflachen?
Das Tool unterstützt Verschachtelungstiefen, die typischerweise in realen JSON-Daten vorkommen (in der Regel bis zu 20+ Ebenen). Es gibt kein fest kodiertes Tiefenlimit, aber extrem tiefe Verschachtelungen können sehr lange Punktnotations-Schlüssel in der Ausgabe erzeugen.
Welche maximale Dateigröße kann dieses Tool verarbeiten?
JSON zu JSONL nimmt einfach jedes Element eines Arrays auf oberster Ebene und setzt es in eine separate Zeile. JSON zu JSONL abflachen geht weiter, indem verschachtelte Strukturen expandiert, verschachtelte Schlüssel in Punktnotation konvertiert und übergeordnete Felder in jeden Datensatz zusammengeführt werden. Verwenden Sie das Abflachen, wenn Sie Datensätze aus tief verschachteltem JSON extrahieren müssen.