JSON vers CSV

Qu'est-ce que la conversion JSON vers CSV ?

La conversion JSON vers CSV transforme des données structurées du format JSON en valeurs séparées par des virgules, un format tabulaire que les tableurs, bases de données et outils d'analyse consomment nativement. JSON stocke les données sous forme d'objets imbriqués et de tableaux sans schéma fixe. CSV stocke les données en lignes et colonnes, avec une ligne d'en-tête définissant les noms de champs. La conversion est le passage obligé pour faire transiter des données d'API vers des tableurs et des bases de données.

CSV (Comma-Separated Values) est défini par RFC 4180. Chaque ligne correspond à un enregistrement, et les champs d'une ligne sont séparés par un caractère délimiteur, le plus souvent une virgule. Les champs contenant le délimiteur, des guillemets doubles ou des sauts de ligne doivent être encadrés de guillemets doubles, avec les guillemets internes échappés en les doublant. Cet échappement est la principale source de bugs lors de l'écriture manuelle d'un convertisseur JSON vers CSV.

La conversion est directe lorsque l'entrée est un tableau plat d'objets aux clés cohérentes. Chaque objet devient une ligne, et chaque clé unique devient un en-tête de colonne. Les objets et tableaux imbriqués nécessitent une étape d'aplatissement, et des clés incohérentes entre objets demandent une stratégie pour gérer les champs manquants — généralement en laissant la cellule vide. Un convertisseur fiable gère automatiquement tous ces cas limites.

Pourquoi convertir JSON en CSV ?

Les API renvoient du JSON, mais les tableurs, bases de données SQL et outils de BI attendent des données tabulaires. Convertir JSON en CSV permet de déplacer des données entre ces systèmes sans écrire de scripts d'import personnalisés.

Cas d'utilisation JSON vers CSV

Référence des délimiteurs CSV

Le caractère délimiteur sépare les champs au sein de chaque ligne. La virgule est la plus courante, mais d'autres délimiteurs sont standards dans des contextes spécifiques. Choisir le mauvais délimiteur provoque la fusion ou le découpage incorrect des champs à l'ouverture du fichier.

Gestion du JSON imbriqué dans CSV

CSV est un format plat sans moyen natif de représenter des objets ou tableaux imbriqués. Lorsque votre JSON contient des structures imbriquées, le convertisseur doit les aplatir en colonnes. Il existe plusieurs stratégies, et le bon choix dépend de la façon dont le CSV sera consommé.

Exemples de code

Convertir JSON en CSV par programme nécessite de gérer l'extraction des en-têtes, le guillemétage des champs et l'échappement des délimiteurs. La plupart des langages disposent d'un support natif ou de bibliothèques standard pour l'écriture CSV.

const data = [
  { name: "Alice", age: 30, city: "Berlin" },
  { name: "Bob", age: 25, city: "Tokyo" },
]

// Extract headers from the first object
const headers = Object.keys(data[0])
const csv = [
  headers.join(","),
  ...data.map(row => headers.map(h => {
    const val = String(row[h] ?? "")
    // Quote fields that contain commas, quotes, or newlines
    return val.includes(",") || val.includes('"') || val.includes("\n")
      ? '"' + val.replace(/"/g, '""') + '"'
      : val
  }).join(","))
].join("\n")

console.log(csv)
// → name,age,city
// → Alice,30,Berlin
// → Bob,25,Tokyo

import json, csv, io

json_str = '[{"name":"Alice","age":30,"city":"Berlin"},{"name":"Bob","age":25,"city":"Tokyo"}]'
data = json.loads(json_str)

output = io.StringIO()
writer = csv.DictWriter(output, fieldnames=data[0].keys())
writer.writeheader()
writer.writerows(data)

print(output.getvalue())
# → name,age,city
# → Alice,30,Berlin
# → Bob,25,Tokyo

# Using jq to convert JSON array to CSV
echo '[{"name":"Alice","age":30},{"name":"Bob","age":25}]' | \
  jq -r '(.[0] | keys_unsorted) as $k | $k, (.[] | [.[$k[]]] ) | @csv'
# → "name","age"
# → "Alice",30
# → "Bob",25

# Using Miller (mlr) for streaming conversion
echo '[{"name":"Alice","age":30}]' | mlr --json --ocsv cat
# → name,age
# → Alice,30

package main

import (
    "encoding/csv"
    "encoding/json"
    "fmt"
    "os"
)

func main() {
    jsonStr := `[{"name":"Alice","age":30},{"name":"Bob","age":25}]`
    var data []map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    w := csv.NewWriter(os.Stdout)
    // Write header
    headers := []string{"name", "age"}
    w.Write(headers)
    // Write rows
    for _, row := range data {
        record := make([]string, len(headers))
        for i, h := range headers {
            record[i] = fmt.Sprintf("%v", row[h])
        }
        w.Write(record)
    }
    w.Flush()
    // → name,age
    // → Alice,30
    // → Bob,25
}

Questions fréquentes