Geneste JSON omzetten naar platte JSONL

Haal records uit geneste JSON-objecten en arrays en zet ze om naar platte JSONL (JSON Lines). Elk record komt op een aparte regel. De verwerking gebeurt 100% in je browser.

JSON-invoer

Sleep hier een .json-bestand naartoe of klik om een bestand te kiezen

Ondersteunt .json en .txt

JSONL-uitvoer

Plak of sleep geneste JSON om plat te maken naar JSONL

Wat houdt JSON platmaken in?

JSON platmaken betekent dat je een diep geneste JSON-structuur omzet naar een platte structuur met één record per regel. Sleutels van geneste objecten worden omgezet naar puntnotatie (bijvoorbeeld address.city). Arrays van objecten worden opgesplitst, zodat elk element een eigen record in JSONL-formaat wordt.

Dit is vooral handig als je API-responses of database-exports met complexe geneste structuren wilt omzetten naar een platte tabelstructuur. Die kun je gebruiken voor het trainen van machinelearningmodellen, conversie naar CSV of streaming datapipelines die één record per regel verwachten.

Twee manieren om een array plat te maken — kies op basis van het doelformaat

Bij geneste objecten ligt de aanpak voor de hand: verbind de sleutels met punten. Bij arrays moet je een keuze maken. Welke aanpak geschikt is, hangt af van waar je de platte gegevens voor gaat gebruiken:

Strategie[{"sku":"A"},{"sku":"B"}] wordtGeschikt als
Uitsplitsen op indexitems.0.sku = A, items.1.sku = B — één rij, meer kolommenHet aantal rijen gelijk moet blijven aan de invoer en de arrays kort zijn en een begrensde lengte hebben
Opsplitsen in rijenTwee rijen, elk met items.sku — meer rijen, dezelfde kolommenJe de gegevens in SQL of analysetools gebruikt en elk array-element een afzonderlijk record vormt
Bewaren als JSON-stringitems = "[{\"sku\":\"A\"},...]" — één cel waarvan de inhoud als geheel wordt behandeldDe array metadata bevat die je later opnieuw gaat parsen en die je nu niet hoeft te bevragen

Zo zet je geneste JSON om naar platte JSONL

Bij het omzetten naar platte JSONL worden records uit geneste JSON-structuren gehaald en krijgt elk record een eigen JSONL-regel. Bevat je JSON een array van objecten, dan komt elk array-element op één regel. Sleutels van geneste objecten worden omgezet naar puntnotatie.

Deze tool werkt volledig in je browser. Er worden geen gegevens naar een server verstuurd. Plak je geneste JSON of sleep een bestand naar het invoervak en je ziet direct de platte JSONL-uitvoer. Velden uit bovenliggende niveaus worden automatisch aan elk record toegevoegd.

De uitvoer is geldige JSONL met één compact JSON-object per regel. Je kunt het resultaat naar je klembord kopiëren of als .jsonl-bestand downloaden, klaar voor machine learning, datapipelines of import in een database.

Voor en na

Een realistisch genest record en de platte versie ervan, met arrays uitgesplitst op index. Let op het scheidingsteken: als je punten gebruikt, botst een letterlijke sleutel als "config.debug" in de bron met het platgemaakte pad config.debug. Bevatten je sleutels punten, gebruik dan een underscore als scheidingsteken:

// Voor — genest record:
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}


// Na — platgemaakt met punt als scheidingsteken, arrays index-geëxpandeerd:
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}

Platmaken is de gebruikelijke voorbewerking bij export naar CSV of Excel: deze formaten werken met tabellen en kunnen geen geneste structuren weergeven. Diep geneste invoer kan uitvoer met erg veel kolommen opleveren. Maak daarom eerst een steekproef plat en controleer of het aantal kolommen werkbaar is voordat je het hele bestand verwerkt.

Veelvoorkomende toepassingen

API-responses verwerken
Zet geneste API-responses om naar platte JSONL om ze eenvoudiger te parsen, te loggen en verder te verwerken in datapipelines.
Data transformeren voor ETL
Haal records uit complexe JSON-exports en zet ze om naar platte JSONL om ze in databases of datawarehouses te laden.
Datasets voorbereiden voor machine learning
Zet geneste JSON-datasets om naar de platte JSONL-records die OpenAI, Hugging Face en andere ML-trainingsplatforms vereisen.
Logs en analysegegevens verwerken
Zet gestructureerde logbestanden met geneste metadata om naar platte JSONL voor analyse met tools als grep, jq of Elasticsearch.
Testdata genereren
Zet complexe, geneste JSON-mockresponses van API’s om naar afzonderlijke JSONL-records die je als testfixtures in geautomatiseerde testsuites kunt gebruiken.
Databases migreren
Zet geneste JSON-documentexports uit MongoDB of CouchDB om naar platte JSONL-records voor import in relationele databases zoals PostgreSQL.

Veelvoorkomende fouten en oplossingen

Geen records gevonden om plat te maken

Deze fout verschijnt als de JSON-invoer een primitieve waarde (string of getal), een leeg object of een lege array is. De tool heeft objecten of arrays van objecten nodig om records uit te halen. Zorg dat je JSON minstens één object met sleutel-waardeparen bevat.

Conflicterende sleutels in puntnotatie

Als je JSON op het hoogste niveau een sleutel als "user.name" bevat en daarnaast een genest object als {"user":{"name":"value"}}, leveren die na het platmaken dezelfde sleutel in puntnotatie op. De geneste waarde overschrijft dan de waarde op het hoogste niveau. Hernoem conflicterende sleutels voordat je de JSON platmaakt.

Circulaire verwijzingen in JSON

Standaard-JSON kan geen circulaire verwijzingen bevatten. Sommige JSON-generators kunnen wel zo diep geneste structuren maken dat ze daarop lijken. De tool kan tot een redelijke diepte met geneste structuren overweg, maar stopt met platmaken als de structuur de veilige grenzen overschrijdt.

Veelgestelde vragen

Hoe worden geneste objecten platgemaakt?

Sleutels van geneste objecten worden omgezet naar puntnotatie. Zo wordt {"user":{"address":{"city":"NYC"}}} omgezet naar {"user.address.city":"NYC"}. Daardoor kun je diep geneste gegevens benaderen als platte sleutel-waardeparen.

Wat gebeurt er met arrays in de JSON?

Als de JSON een array van objecten bevat, krijgt elk object een eigen JSONL-regel. Arrays met primitieve waarden (strings, getallen) worden in de platte uitvoer geserialiseerd als JSON-strings. De tool bepaalt automatisch welke array de hoofdarray is en splitst die op.

Zijn mijn gegevens veilig tijdens het platmaken?

Ja. Het platmaken gebeurt volledig lokaal in je browser. Er worden geen gegevens naar een server verstuurd. De inhoud van je JSON verlaat je apparaat nooit.

Kan ik JSON met verschillende nestingsniveaus platmaken?

Ja. De tool kan elk niveau van nesteling verwerken. Scalaire velden op het hoogste niveau worden aan elk record toegevoegd, geneste objecten worden omgezet naar puntnotatie en de grootste array van objecten wordt opgesplitst in afzonderlijke JSONL-regels.

Hoe worden null- en undefined-waarden verwerkt bij het platmaken?

Null-waarden blijven in de platte uitvoer behouden als null. JSON kent geen undefined-type, dus undefined-waarden komen niet voor. Lege objecten leveren na het platmaken geen sleutels op en lege arrays worden geserialiseerd als lege JSON-arrays.

Kan ik meerdere JSON-bestanden tegelijk platmaken?

De tool verwerkt momenteel één JSON-invoer tegelijk. Wil je meerdere bestanden platmaken, verwerk ze dan één voor één. Voor batchverwerking kun je commandlinetools zoals jq gebruiken en het resultaat met deze tool visueel controleren.

Wat is de maximale nestingsdiepte die de tool ondersteunt?

De tool ondersteunt de nestingsdieptes die je doorgaans in JSON-data tegenkomt (meestal tot 20+ niveaus). Er is geen hardgecodeerde dieptelimiet, maar bij extreem diepe nesteling kunnen de sleutels in puntnotatie erg lang worden.

Wat is het verschil tussen deze tool en de converter van JSON naar JSONL?

Bij gewone conversie van JSON naar JSONL wordt elk element van een array op het hoogste niveau op een aparte regel gezet. Bij het platmaken van JSON naar JSONL worden ook geneste structuren uitgewerkt, geneste sleutels omgezet naar puntnotatie en velden uit bovenliggende niveaus aan elk record toegevoegd. Gebruik deze tool als je records uit diep geneste JSON wilt halen.

Gerelateerde tools & gidsen