JSON to CSV

Wat is JSON naar CSV-conversie?

JSON naar CSV-conversie transformeert gestructureerde gegevens van JSON-formaat naar door komma's gescheiden waarden — een tabelindeling die spreadsheets, databases en analysetools native ondersteunen. JSON slaat gegevens op als geneste objecten en arrays zonder vast schema. CSV slaat gegevens op als rijen en kolommen, waarbij een koprij de veldnamen definieert. Via deze conversie bereiken API-gegevens spreadsheets en databases.

CSV (Comma-Separated Values) is gedefinieerd door RFC 4180. Elke regel is één record, en velden binnen een regel worden gescheiden door een scheidingsteken — meestal een komma. Velden die het scheidingsteken, dubbele aanhalingstekens of regelafbrekingen bevatten, moeten tussen dubbele aanhalingstekens staan, waarbij interne aanhalingstekens worden geëscaped door ze te verdubbelen. Dit escapen is de voornaamste oorzaak van fouten bij het handmatig schrijven van een JSON-naar-CSV-converter.

De conversie is eenvoudig wanneer de invoer een platte array van objecten is met consistente sleutels. Elk object wordt één rij, en elke unieke sleutel wordt een kolomkop. Geneste objecten en arrays vereisen een afvlakkingsstap, en inconsistente sleutels tussen objecten vereisen een strategie voor ontbrekende velden — doorgaans een lege cel. Een betrouwbare converter verwerkt al deze gevallen automatisch.

Waarom JSON naar CSV converteren?

API's retourneren JSON, maar spreadsheets, SQL-databases en BI-tools verwachten tabelgegevens. JSON naar CSV converteren maakt het mogelijk gegevens tussen deze systemen te verplaatsen zonder aangepaste importscripts te schrijven.

Toepassingen van JSON naar CSV

CSV-scheidingstekenreferentie

Het scheidingsteken scheidt velden binnen elke rij. Komma is het meest gebruikelijk, maar andere scheidingstekens zijn standaard in specifieke contexten. Een verkeerd scheidingsteken kiezen zorgt ervoor dat velden samenvoegen of onjuist splitsen wanneer het bestand wordt geopend.

Geneste JSON verwerken in CSV

CSV is een plat formaat zonder native mogelijkheid om geneste objecten of arrays weer te geven. Wanneer je JSON geneste structuren bevat, moet de converter deze afvlakken tot kolommen. Er zijn meerdere strategieën, en de juiste keuze hangt af van hoe de CSV wordt verwerkt.

Codevoorbeelden

JSON programmatisch naar CSV converteren vereist het afhandelen van koptekstextractie, veldaanhalingstekens en scheidingstekenescaping. De meeste talen hebben ingebouwde of standaardbibliotheekondersteuning voor CSV-schrijven.

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
}

Veelgestelde vragen