Aplatir du JSON en JSONL

Extrayez les objets et tableaux JSON imbriqués et aplatissez-les au format JSONL (JSON Lines). Chaque enregistrement occupe une ligne distincte. Le traitement se fait à 100% côté client.

JSON en entrée

Déposez un fichier .json ici ou cliquez pour sélectionner un fichier

Formats acceptés : .json, .txt

Résultat JSONL

Collez du JSON imbriqué ou déposez un fichier pour l’aplatir en JSONL

Qu’est-ce que l’aplatissement du JSON ?

L’aplatissement du JSON consiste à transformer une structure JSON profondément imbriquée en un format plat, organisé ligne par ligne. Les clés des objets imbriqués sont converties en notation pointée (par exemple, address.city), et les tableaux d’objets sont décomposés pour que chaque élément devienne un enregistrement distinct au format JSONL.

Cette opération est particulièrement utile pour convertir des réponses d’API ou des exports de bases de données aux structures complexes en un format tabulaire plat. Ce format peut servir à l’entraînement de modèles de machine learning, à la conversion en CSV ou à des pipelines de données en streaming qui attendent un enregistrement par ligne.

Deux façons d’aplatir un tableau : choisissez selon l’usage prévu

Pour les objets imbriqués, la méthode est évidente : joindre les clés par des points. Pour les tableaux, en revanche, il faut choisir une stratégie selon l’usage prévu pour les données aplaties :

Stratégie[{"sku":"A"},{"sku":"B"}] devientÀ utiliser lorsque
Décomposition par indiceitems.0.sku = A, items.1.sku = B — une seule ligne, plus de colonnesLe nombre de lignes doit rester identique à celui des données d’entrée ; les tableaux sont courts et leur taille est bornée
Décomposition en lignesDeux lignes, chacune avec items.sku — plus de lignes, les mêmes colonnesLes données sont destinées à SQL ou à des outils d’analyse, et chaque élément du tableau constitue un enregistrement à part entière
Conservation sous forme de chaîne JSONitems = "[{\"sku\":\"A\"},...]" — une seule cellule opaqueLe tableau contient des métadonnées que vous parserez à nouveau plus tard, sans avoir à les interroger pour le moment

Comment aplatir du JSON en JSONL

L’aplatissement du JSON en JSONL consiste à extraire les enregistrements de structures imbriquées et à placer chacun sur une ligne JSONL distincte. Si votre JSON contient un tableau d’objets, chaque élément du tableau devient une ligne. Les clés des objets imbriqués sont converties en notation pointée.

L’outil fonctionne entièrement dans votre navigateur. Aucune donnée n’est envoyée à un serveur. Collez votre JSON imbriqué ou glissez-déposez un fichier : le résultat JSONL aplati s’affiche instantanément. Les champs du niveau parent sont automatiquement intégrés à chaque enregistrement.

Le résultat est du JSONL valide, avec un objet JSON compact par ligne. Vous pouvez le copier dans le presse-papiers ou le télécharger dans un fichier .jsonl, prêt à être utilisé pour le machine learning, dans des pipelines de données ou pour un import en base de données.

Avant et après

Voici un exemple réaliste d’enregistrement imbriqué et sa version aplatie par décomposition des tableaux selon leurs indices. Le choix du séparateur compte : avec un point comme séparateur, une clé littérale comme « config.debug » dans la source entrerait en conflit avec le chemin aplati config.debug. Si vos clés contiennent des points, utilisez le caractère de soulignement comme séparateur :

// Avant — enregistrement imbriqué :
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}


// Après — aplati avec un point comme séparateur et développement des indices de tableaux :
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}

L’aplatissement est l’étape de prétraitement habituelle avant un export en CSV ou vers Excel : ces formats tabulaires ne peuvent pas représenter les structures imbriquées. Des données très imbriquées peuvent produire un résultat avec un très grand nombre de colonnes. Aplatissez d’abord un échantillon et vérifiez que le nombre de colonnes reste raisonnable avant de traiter le fichier entier.

Cas d'utilisation courants

Traitement des réponses d’API
Aplatissez les réponses d’API imbriquées en JSONL pour faciliter leur parsing, leur journalisation et les traitements en aval dans les pipelines de données.
Transformation de données ETL
Extrayez les enregistrements d’exports JSON complexes et aplatissez-les en JSONL pour les charger dans des bases de données ou des entrepôts de données.
Préparation de jeux de données pour le ML
Convertissez des jeux de données JSON imbriqués en enregistrements JSONL plats, au format attendu par OpenAI, Hugging Face et d’autres plateformes d’entraînement de modèles de ML.
Traitement des logs et analyse de données
Aplatissez en JSONL des fichiers de logs structurés contenant des métadonnées imbriquées pour les analyser avec des outils comme grep, jq ou Elasticsearch.
Génération de données de test
Aplatissez des réponses JSON complexes issues de mocks d’API en enregistrements JSONL distincts, à utiliser comme fixtures dans vos suites de tests automatisés.
Migration de bases de données
Aplatissez des exports JSON de documents imbriqués issus de MongoDB ou CouchDB en enregistrements JSONL plats pour les importer dans des bases de données relationnelles comme PostgreSQL.

Erreurs courantes et solutions

Aucun enregistrement à aplatir

Cette erreur survient lorsque le JSON fourni est une valeur primitive (chaîne, nombre), un objet vide ou un tableau vide. Pour extraire des enregistrements, l’outil a besoin d’objets ou de tableaux d’objets. Vérifiez que votre JSON contient au moins un objet avec des paires clé-valeur.

Conflits de clés en notation pointée

Si votre JSON contient une clé comme "user.name" au premier niveau ainsi qu’un objet imbriqué {"user":{"name":"value"}}, les deux produisent la même clé en notation pointée après aplatissement. La valeur imbriquée écrase alors celle du premier niveau. Renommez les clés en conflit avant d’aplatir les données.

Références circulaires dans le JSON

Le JSON standard ne peut pas contenir de références circulaires, mais certains générateurs JSON peuvent produire des structures si profondément imbriquées qu’elles y ressemblent. L’outil gère les imbrications jusqu’à une profondeur raisonnable, puis interrompt l’aplatissement si la structure dépasse les limites de sécurité.

Questions fréquentes

Comment fonctionne l’aplatissement des objets imbriqués ?

Les clés des objets imbriqués sont converties en notation pointée. Par exemple, {"user":{"address":{"city":"NYC"}}} devient {"user.address.city":"NYC"}. Les données profondément imbriquées deviennent ainsi accessibles sous forme de paires clé-valeur à plat.

Comment les tableaux présents dans le JSON sont-ils traités ?

Si le JSON contient un tableau d’objets, chaque objet devient une ligne JSONL distincte. Les tableaux de valeurs primitives (chaînes, nombres) sont sérialisés sous forme de chaînes JSON dans le résultat aplati. L’outil détecte automatiquement le tableau principal à décomposer.

Mes données sont-elles en sécurité pendant l’aplatissement ?

Oui. L’aplatissement s’effectue entièrement en local, dans votre navigateur. Aucune donnée n’est envoyée à un serveur. Votre contenu JSON ne quitte jamais votre appareil.

Puis-je aplatir du JSON contenant plusieurs niveaux d’imbrication ?

Oui. L’outil gère tous les niveaux d’imbrication. Les champs scalaires du premier niveau sont intégrés à chaque enregistrement, les clés des objets imbriqués sont converties en notation pointée et le plus grand tableau d’objets est décomposé en lignes JSONL distinctes.

Comment les valeurs null et undefined sont-elles traitées lors de l’aplatissement ?

Les valeurs null sont conservées telles quelles dans le résultat aplati. JSON n’a pas de type undefined : vous ne rencontrerez donc pas de valeurs undefined. Les objets vides ne produisent aucune clé après aplatissement, et les tableaux vides sont sérialisés sous forme de tableaux JSON vides.

Puis-je aplatir plusieurs fichiers JSON à la fois ?

Pour le moment, l’outil traite une seule entrée JSON à la fois. Pour aplatir plusieurs fichiers, traitez-les un par un. Pour les traitements par lots, vous pouvez utiliser des outils en ligne de commande comme jq et vous servir de cet outil pour vérifier visuellement le résultat.

Quelle est la profondeur maximale d’imbrication prise en charge par cet outil ?

L’outil prend en charge les profondeurs d’imbrication courantes dans les données JSON réelles (généralement jusqu’à 20 niveaux et plus). Aucune limite de profondeur n’est codée en dur, mais une imbrication extrême peut produire des clés en notation pointée très longues dans le résultat.

En quoi cet outil diffère-t-il d’une simple conversion de JSON vers JSONL ?

La conversion de JSON en JSONL place simplement chaque élément d’un tableau de premier niveau sur une ligne distincte. L’aplatissement du JSON en JSONL va plus loin : il décompose les structures imbriquées, convertit les clés imbriquées en notation pointée et intègre les champs du niveau parent à chaque enregistrement. Utilisez l’aplatissement pour extraire des enregistrements d’un JSON profondément imbriqué.

Outils et guides associés