NDJSON (JSON Lines) — fichier .ndjson

Le NDJSON (Newline Delimited JSON, aussi appelé JSON Lines) place un document JSON complet et valide sur chaque ligne du fichier, plutôt qu’un unique document englobant l’ensemble comme dans un fichier JSON classique. Cette structure permet de traiter le fichier ligne par ligne, sans devoir charger l’intégralité du contenu en mémoire.

Ce format n’a aucune signature binaire fiable, comme le JSON dont il dérive : chaque ligne peut commencer par une accolade, un crochet ou toute autre valeur JSON valide.

Le NDJSON est particulièrement adapté aux flux de données volumineux ou continus — journaux d’événements, exports de bases de données, flux d’API — où traiter chaque ligne indépendamment, au fur et à mesure de sa réception, est préférable à l’attente du document complet.

Un fichier JSON classique invalide totalement si une seule virgule ou accolade est mal fermée quelque part dans le document ; en NDJSON, une ligne corrompue n’affecte que cette ligne, les autres restant parfaitement exploitables — une robustesse appréciable pour des journaux générés en continu sur de longues périodes.

De nombreux outils d’ingestion de données (Elasticsearch, BigQuery, divers pipelines de traitement de flux) acceptent nativement le NDJSON en entrée précisément pour cette capacité à traiter chaque enregistrement indépendamment, sans étape de découpage préalable du fichier source.

Le pilote de journalisation par défaut de Docker écrit d’ailleurs les journaux de chaque conteneur dans ce même format, un objet JSON par ligne représentant un message de log horodaté, ce qui permet à des outils de collecte externes de lire ces fichiers au fil de l’eau sans attendre la fin de vie du conteneur.