CSV naar NDJSON omzetten

NDJSON is geen ander dataformaat, maar een andere manier om JSON te verpakken: elke regel is een compleet, op zichzelf staand JSON-object, in plaats van één grote array die het hele bestand omvat.

Dat maakt het bruikbaar voor tools die regel voor regel verwerken — logsystemen, streaming-pijplijnen, opdrachtregelprogramma’s die een bestand niet in zijn geheel hoeven in te lezen om ermee te beginnen.

De kolomkoppen van de CSV worden de sleutels van elk JSON-object; elke rij daaronder levert de bijbehorende waarden. Rij twee van de CSV is regel twee van de NDJSON.

Ontbrak een waarde in een cel, dan komt dat terug als een lege of ontbrekende waarde in het object — er wordt niets verzonnen om een gat op te vullen.

Een CSV-bestand is platte tekst: elk veld is in principe een string, ook als het eruitziet als een getal of een datum. NDJSON verwacht wel degelijk onderscheid tussen tekst, getallen en waarheidswaarden.

Controleer daarom vooral kolommen met getallen die voorloopnullen bevatten, zoals postcodes: die kunnen bij het omzetten als getal worden geïnterpreteerd en hun voorloopnul verliezen.

CSV kent van zichzelf geen geneste structuur — elke rij is een rechte lijst van velden. De omzetting voegt daar niets aan toe: elk object in de NDJSON is een plat object met precies de kolommen van de bron.

Wil je juist geneste JSON-structuren bouwen vanuit tabeldata, dan is dat iets wat je na deze omzetting handmatig of met een ander gereedschap zou moeten doen.

Er wordt vanuit gegaan dat de eerste rij van de CSV de kolomnamen bevat. Ontbreekt die rij, of staat er in plaats daarvan al data, dan komen die waarden als sleutelnamen terecht in elk object.

Controleer dus voordat je omzet of het bestand daadwerkelijk met een koptekst begint — anders staat er straks een rij data in plaats van veldnamen boven elk object.

Typisch gebruik is het aanleveren van tabeldata aan een systeem dat regel voor regel JSON verwacht: een importtool, een logpijplijn, een opdrachtregelscript dat met `jq` of vergelijkbare tools werkt.

Voor gewoon menselijk lezen is een CSV vaak prettiger; NDJSON is bedoeld voor machines die één record tegelijk willen verwerken.

Omdat elke regel in de NDJSON op zichzelf staat, kan een ontvangend systeem het bestand stap voor stap verwerken zonder alles eerst in het geheugen te laden — precies het voordeel dat platte JSON niet biedt.

Voor een CSV met tienduizenden rijen is dat vaak de reden om specifiek voor NDJSON te kiezen in plaats van gewoon JSON.

Het omzetten draait volledig in de browser, zonder dat het CSV-bestand naar een server gaat.

Bij meerdere bestanden tegelijk werkt een batch tot honderd stuks, teruggegeven als één ZIP, zonder een limiet op het aantal per dag.