JSON to CSV

Was ist JSON-zu-CSV-Konvertierung?

Die JSON-zu-CSV-Konvertierung wandelt strukturierte Daten aus dem JSON-Format in kommagetrennte Werte um — ein tabellarisches Format, das Tabellenkalkulationen, Datenbanken und Analyse-Tools nativ verarbeiten können. JSON speichert Daten als verschachtelte Objekte und Arrays ohne festes Schema. CSV speichert Daten als Zeilen und Spalten, wobei eine Kopfzeile die Feldnamen definiert. Die Konvertierung ist der Weg, wie API-Daten in Tabellenkalkulationen und Datenbanken gelangen.

CSV (Comma-Separated Values) ist durch RFC 4180 definiert. Jede Zeile ist ein Datensatz, und Felder innerhalb einer Zeile werden durch ein Trennzeichen getrennt, meist ein Komma. Felder, die das Trennzeichen, doppelte Anführungszeichen oder Zeilenumbrüche enthalten, müssen in doppelte Anführungszeichen eingeschlossen werden, wobei interne Anführungszeichen durch Verdopplung escaped werden. Dieses Escaping ist die häufigste Fehlerquelle beim manuellen Schreiben eines JSON-zu-CSV-Konverters.

Die Konvertierung ist unkompliziert, wenn die Eingabe ein flaches Array von Objekten mit konsistenten Schlüsseln ist. Jedes Objekt wird zu einer Zeile, und jeder eindeutige Schlüssel wird zu einem Spaltenheader. Verschachtelte Objekte und Arrays erfordern einen Flattening-Schritt, und inkonsistente Schlüssel über Objekte hinweg erfordern eine Strategie für fehlende Felder — typischerweise wird die Zelle leer gelassen. Ein zuverlässiger Konverter behandelt all diese Grenzfälle automatisch.

Warum JSON in CSV konvertieren?

APIs liefern JSON, aber Tabellenkalkulationen, SQL-Datenbanken und BI-Tools erwarten tabellarische Daten. Die Konvertierung von JSON in CSV ermöglicht den Datentransfer zwischen diesen Systemen, ohne eigene Import-Skripte schreiben zu müssen.

JSON-zu-CSV-Anwendungsfälle

CSV-Trennzeichen-Referenz

Das Trennzeichen trennt Felder innerhalb jeder Zeile. Komma ist das häufigste, aber andere Trennzeichen sind in bestimmten Kontexten Standard. Die Wahl des falschen Trennzeichens führt dazu, dass Felder beim Öffnen der Datei falsch zusammengefasst oder aufgeteilt werden.

Verschachtelte JSON-Strukturen in CSV verarbeiten

CSV ist ein flaches Format ohne native Möglichkeit, verschachtelte Objekte oder Arrays darzustellen. Wenn das JSON verschachtelte Strukturen enthält, muss der Konverter sie in Spalten flattenen. Es gibt verschiedene Strategien, und die richtige Wahl hängt davon ab, wie die CSV weiterverarbeitet wird.

Code-Beispiele

Die programmatische Konvertierung von JSON in CSV erfordert die Behandlung von Header-Extraktion, Feld-Quoting und Trennzeichen-Escaping. Die meisten Sprachen bieten integrierte oder Standard-Bibliotheks-Unterstützung für das CSV-Schreiben.

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
}

Häufig gestellte Fragen