JSON naar NDJSON omzetten

Deze pagina is voor iemand die records in iets laadt dat een stream leest: een logstore, een bulk-loader, een jq-pijplijn, een laadtaak voor BigQuery of Snowflake. Elke regel moet een op zichzelf staand JSON-document zijn.

Wat hier het meest telt, is niet het formaat zelf maar de vorm van het bronbestand — en dat is precies het onderdeel dat het vaakst tot verrassingen leidt.

Is het hoogste niveau van het JSON-bestand een array, dan wordt elk element een eigen regel — dat is het geval waarvoor deze omzetting het vaakst wordt gebruikt.

Is het hoogste niveau iets anders dan een array — inclusief een object met één sleutel die een array bevat, zoals `{"data": [...]}` — dan wordt het hele document één enkele regel. Dit pad pakt zo’n envelop niet automatisch uit, in tegenstelling tot de tabulaire omzettingen op deze site.

Een CSV- of TSV-omzetting moet wel uitpakken, omdat een tabel geen plek heeft voor een envelop rond de eigenlijke rijen — die omzettingen halen `{"data": [...]}` automatisch uit elkaar tot losse rijen. NDJSON kent die beperking niet: elke regel kan zelf al een willekeurig genest document zijn.

Daardoor is er hier geen reden om automatisch uit te pakken, en gebeurt dat dus ook niet. Wil je toch dat de array binnen `data` wordt uitgepakt tot losse regels, verwijder dan zelf eerst de buitenste envelop vóór het omzetten.

Elke regel wordt geschreven als de volledige, ongewijzigde JSON-representatie van dat element — geneste objecten en arrays blijven intact, precies zoals ze in de bron stonden.

Wat wél verandert, is de opmaak: de inspringing van het bronbestand gaat verloren, omdat elke regel als één compacte JSON-string wordt geschreven zonder witruimte ertussen.

Moeten de gegevens uiteindelijk in kolommen terechtkomen — een spreadsheet, een SQL-tabel — dan is een omzetting naar CSV, TSV of XLSX het betere doel, omdat die de envelop wél uitpakt en velden naar dotted kolomnamen plat maakt.

Deze omzetting is specifiek voor bestemmingen die regel voor regel een JSON-document lezen, niet voor bestemmingen die met rijen en kolommen werken.

De omzetting draait volledig in de browser; het bestand wordt niet naar een server gestuurd. De limiet op het gratis plan is 100 MB per bestand.

Voor een groot exportbestand met veel records is dat ruim voldoende, en er is geen limiet op het aantal keer per dag.

Tot honderd JSON-bestanden tegelijk kunnen in één sessie worden omgezet, elk met een eigen voortgangsindicator — bruikbaar wanneer een systeem elke dag een nieuw exportbestand aflevert dat naar dezelfde bulk-loader moet.

Het resultaat komt terug als losse bestanden of als ZIP, met dezelfde bestandsnamen als het origineel maar de `.ndjson`-extensie.

De inhoud en volgorde van de gegevens blijven exact zoals in het bronbestand — er wordt niets herschikt, gefilterd of samengevoegd. Rijvolgorde in het resultaat komt overeen met elementvolgorde in de brondata.

Voor wie een audit-trail nodig heeft tussen bron en resultaat, betekent dat: elk element in de array staat terug te vinden als precies één regel, in dezelfde volgorde.