Ce que la conversion JSON vers CSV gère réellement
JSON est hiérarchique. CSV est plat. Convertir JSON en CSV signifie décider quoi faire avec les objets imbriqués, quoi faire avec les tableaux, et quel délimiteur rend la sortie compatible avec l'outil de feuille de calcul ou de pipeline que vous vous apprêtez à utiliser.
Les objets imbriqués deviennent des colonnes en notation pointée. Un objet JSON {"user": {"name": "Ana", "age": 33}} devient des colonnes CSV user.name,user.age avec les valeurs Ana,33 sur la même ligne. Sans aplatissement, la colonne user contiendrait la chaîne [object Object] et le reste de la hiérarchie serait perdu.
Les tableaux présentent trois choix. Vous pouvez joindre les éléments du tableau dans une cellule avec un séparateur comme |, diviser chaque élément du tableau dans une nouvelle ligne en répétant les champs parent, ou transformer le tableau en chaîne JSON dans une seule cellule CSV. Le bon choix dépend de ce dans quoi vous allez importer. Les utilisateurs d'Excel préfèrent généralement les lignes divisées. Les importations de base de données préfèrent généralement une jointure.
Les délimiteurs ont de l'importance car CSV signifie valeurs séparées par des virgules, mais de nombreuses régions et plates-formes s'attendent à des points-virgules, et les fichiers délimités par des tabulations évitent les problèmes d'échappement quand des virgules apparaissent dans vos données. Le convertisseur vous permet de choisir entre virgule, point-virgule, tabulation ou barre verticale.
Le mode inversé lit le CSV et le reconvertit en JSON. Vous choisissez si la première ligne contient les en-têtes, si les colonnes en notation pointée doivent se ré-imbriquer dans des objets, et si vous voulez un tableau d'objets ou un seul objet avec des clés de ligne.
Comment utiliser ce convertisseur JSON vers CSV
- Collez le JSON dans Entrée JSON ou CSV, ou déposez une URL si votre JSON se trouve à un point de terminaison API et que nous le récupérions pour vous.
- Définissez Mode sur JSON → CSV ou CSV → JSON.
- Choisissez votre Délimiteur. La virgule est l'option par défaut. Passez au point-virgule si vous envoyez vers Excel en locale européenne, tabulation si votre JSON contient des virgules dans les valeurs de chaîne, ou barre verticale si vous envoyer la sortie dans un script Unix.
- Activez Aplatir les clés imbriquées avec la notation pointée si votre JSON a plus d'un niveau d'imbrication. Désactivez-la si vous voulez que les objets imbriqués soient transformés en chaîne dans des cellules uniques.
- Cliquez sur Convertir. Vous voyez un tableau d'aperçu montrant les 20 premières lignes et chaque colonne. Vérifiez que l'aplatissement et la gestion des tableaux correspondent à vos attentes.
- Cliquez sur Télécharger CSV pour enregistrer le fichier, ou copiez la sortie et collez-la directement dans Google Sheets, Excel ou votre outil d'importation de base de données.
Essayez de coller ce JSON :
[
{"product": "Widget A", "sales": {"Q1": 1200, "Q2": 1450}, "tags": ["new", "sale"]},
{"product": "Widget B", "sales": {"Q1": 980, "Q2": 1100}, "tags": ["featured"]}
]
Avec l'aplatissement activé et le délimiteur défini sur virgule, la sortie est :
product,sales.Q1,sales.Q2,tags
Widget A,1200,1450,new|sale
Widget B,980,1100,featured
Sans aplatissement, la colonne sales affiche [object Object] et vous perdez la ventilation trimestrielle. La jointure de tableau par défaut utilise | comme séparateur. Passez au mode division par lignes et vous obtenez quatre lignes : une par étiquette par produit.
Pourquoi la conversion JSON vers CSV est importante pour les flux de travail des données
Les fichiers plats sont le format d'échange universel. JSON est le format de sortie de chaque API moderne, tableau de bord d'analyse et webhook. Si votre flux de travail implique de prendre des données d'un système et de les mettre dans un autre, vous allez convertir JSON en CSV au moins une fois par semaine.
Exportations API. La plupart des API REST renvoient JSON par défaut. Google Analytics Data API, rapports Stripe, versions GitHub, exportations Airtable — tout en JSON. Charger ces données dans Power BI, Tableau ou une base de données SQL est plus rapide quand elles arrivent au format CSV. Vous pouvez automatiser la conversion, mais vérifier la sortie manuellement d'abord capte les surprises de schéma avant qu'elles deviennent des erreurs de pipeline.
Pipelines de transformation de données. Les flux de travail ETL se divisent souvent en une étape d'extraction qui tire du JSON et une étape de chargement qui s'attend à du CSV. Aplatir le JSON imbriqué dans le navigateur avant le chargement économise l'écriture et la maintenance d'un script de transformation. Pour les migrations ponctuelles ou l'analyse exploratoire, ce convertisseur termine le travail en moins d'une minute.
Importations de feuilles de calcul. Les analystes qui n'écrivent pas de code peuvent toujours importer des données API s'ils ont un moyen de transformer JSON en CSV. Google Sheets et Excel gèrent tous deux le collage et l'importation de fichiers CSV. Aucun ne gère le JSON brut à moins que vous n'écriviez un script. Cet outil comble l'écart.
Le choix de délimiteur prévient la corruption silencieuse des données. CSV délimité par des virgules se casse quand un champ de texte contient une virgule sauf si chaque valeur est entre guillemets et le caractère de guillemet est échappé. Les délimiteurs de tabulation et de point-virgule évitent ce problème dans la plupart des ensembles de données. Si votre JSON inclut des adresses, des descriptions de produits ou du texte généré par l'utilisateur, passez à la tabulation.
Aplatissement JSON imbriqué expliqué
Le CSV plat a une ligne par enregistrement et une valeur par colonne. Le JSON imbriqué a des objets à l'intérieur d'objets. L'aplatissement comble l'écart en transformant chaque niveau d'imbrication en nom de colonne avec un séparateur de point.
Un objet JSON avec trois niveaux :
{
"company": "Acme Inc",
"contact": {
"person": "Jane Doe",
"email": {"work": "[email protected]", "personal": "[email protected]"}
}
}
devient quatre colonnes CSV :
company,contact.person,contact.email.work,contact.email.personal
Acme Inc,Jane Doe,[email protected],[email protected]
La notation pointée préserve la hiérarchie originale de façon à pouvoir l'inverser. Certains convertisseurs CSV-vers-JSON reconnaissent les colonnes en notation pointée et reconstruisent la structure imbriquée. Si vous laissez l'aplatissement désactivé, le convertisseur transforme les objets imbriqués en chaîne dans une seule cellule. Cette sortie est lisible dans une feuille de calcul mais non réversible en données structurées.
Les tableaux à l'intérieur d'objets présentent un choix. Si un objet a "tags": ["new", "sale", "limited"] vous pouvez joindre le tableau dans une cellule comme new|sale|limited, diviser en trois lignes avec les autres colonnes répétées, ou transformer le tableau en chaîne en tant que fragment JSON ["new","sale","limited"]. Le mode jointure garde une ligne par enregistrement et est l'option par défaut. Le mode division est utile quand le tableau représente une relation un-à-plusieurs. Le mode stringify préserve l'information de type mais rend le CSV plus difficile à interroger.
Quand votre JSON inclut des types mixtes — certains enregistrements ont un tableau où d'autres ont une seule chaîne — le convertisseur les normalise en enveloppant les valeurs uniques dans un tableau avant d'appliquer la règle de gestion du tableau choisie. Cela empêche les colonnes manquantes et garde le schéma CSV cohérent.
Erreurs courantes
- Coller un fragment JSON au lieu d'une structure complète. Le convertisseur s'attend à du JSON valide : soit un tableau d'objets
[{…}, {…}]soit un objet unique{…}. Si vous collez une réponse API tronquée ou un morceau JSON sans accolades de fermeture, l'analyseur lève une erreur. Copiez la réponse complète. - Laisser l'aplatissement activé quand vous voulez la lisibilité plutôt que la réversibilité. Les noms de colonnes aplatis comme
meta.author.profile.urlsont difficiles à scanner dans une feuille de calcul. Si vous avez seulement besoin de lire les données et ne les reconvertirez pas en JSON, désactivez l'aplatissement et acceptez les objets imbriqués transformés en chaîne. - Utiliser le délimiteur virgule quand vos données ont des virgules. Les adresses, les noms complets et les descriptions de produits incluent presque toujours des virgules. Si votre JSON contient des champs de texte libre, passez au délimiteur tabulation ou barre verticale avant de convertir. Sinon vous allez ouvrir le CSV dans Excel et voir les colonnes décalées.
- Oublier que les fichiers volumineux dépassent la mémoire du navigateur. Ce convertisseur s'exécute côté client. Si votre JSON est plus grand que 50 MB, le navigateur peut se figer ou planter. Pour les ensembles de données de cette taille, utilisez plutôt un outil en ligne de commande comme
jqoucsvkit. - Ne pas vérifier l'aperçu avant de télécharger. Le tableau d'aperçu affiche les 20 premières lignes et chaque colonne. Vérifiez-le. Un mauvais délimiteur ou une division de tableau surprenante peut doubler le nombre de lignes et casser les importations en aval. Le corriger après le téléchargement gaspille du temps.
Conseils avancés
- Validez d'abord votre JSON. Si le convertisseur lève une erreur de syntaxe et que vous ne pouvez pas identifier le problème à l'œil nu, collez votre JSON dans un validateur comme
jsonlint.comou exécutez-le à traversjq .sur la ligne de commande. Le message d'erreur pointera le numéro de ligne. - Utilisez le mode inverse pour faire un aller-retour de vos données. Convertissez JSON en CSV, modifiez le CSV dans votre feuille de calcul, puis reconvertissez en JSON. Ce flux de travail est plus rapide que d'écrire un script quand vous avez besoin de modifier en masse les propriétés d'objets.
- Pour le JSON profondément imbriqué, aplatissez d'abord, puis filtrez les colonnes dans votre outil de feuille de calcul. Une hiérarchie de dix niveaux produit des dizaines de colonnes en notation pointée. La plupart d'entre elles sont vides pour la plupart des lignes. Supprimez les colonnes vides après l'importation.
- Enregistrez l'aperçu comme capture d'écran avant de télécharger. Si vous convertissez des données API pour un rapport ou un audit, l'aperçu vous donne la preuve de la structure et du nombre de lignes. Les parties prenantes demandent « combien d'enregistrements avez-vous importés ? » et la capture d'écran répond.
- En travaillant avec des tableaux de primitives comme
["red", "blue", "green"], le mode jointure avec délimiteur barre verticale est presque toujours le bon choix. Le mode division n'a de sens que quand chaque élément du tableau a besoin de sa propre ligne pour la normalisation de base de données.
Une fois que vous avez votre CSV, l'étape suivante est généralement le filtrage ou la restructuration. Si votre CSV inclut une colonne de mots-clés et vous voulez la combiner avec d'autres listes, exécutez-la via notre combineur de mots-clés pour générer des permutations. Si vous créez des URL à partir des lignes CSV, alimentez la colonne pertinente dans le générateur de slugs pour produire des slugs d'URL propres en masse. Quand votre CSV est le résultat d'un audit SEO et vous voulez valider la structure, utilisez la liste de contrôle SEO pour confirmer que chaque champ dont vous avez besoin est présent.