JSON to CSV

Co je převod JSON na CSV?

Převod JSON na CSV transformuje strukturovaná data z formátu JSON do hodnot oddělených čárkami — tabulkového formátu, který tabulkové procesory, databáze a analytické nástroje nativně přijímají. JSON ukládá data jako vnořené objekty a pole bez pevného schématu. CSV ukládá data jako řádky a sloupce, přičemž záhlaví definuje názvy polí. Převod je způsob, jak se data z API dostávají do tabulek a databází.

CSV (Comma-Separated Values) je definováno specifikací RFC 4180. Každý řádek je jeden záznam a pole v řádku jsou oddělena oddělovacím znakem, nejčastěji čárkou. Pole obsahující oddělovač, dvojité uvozovky nebo konce řádků musí být uzavřena do dvojitých uvozovek, přičemž interní uvozovky jsou zdvojeny. Toto escapování je hlavním zdrojem chyb při ručním psaní převodníku JSON na CSV.

Převod je přímočarý, pokud je vstupem ploché pole objektů s konzistentními klíči. Každý objekt se stane jedním řádkem a každý jedinečný klíč se stane záhlavím sloupce. Vnořené objekty a pole vyžadují krok zploštění a nekonzistentní klíče napříč objekty vyžadují strategii pro zpracování chybějících polí — typicky ponechání buňky prázdné. Spolehlivý převodník zvládá všechny tyto hraniční případy automaticky.

Proč převádět JSON na CSV?

API vrací JSON, ale tabulkové procesory, SQL databáze a BI nástroje očekávají tabulková data. Převod JSON na CSV umožňuje přesunovat data mezi těmito systémy bez psaní vlastních importních skriptů.

Případy použití JSON na CSV

Přehled oddělovačů CSV

Oddělovací znak odděluje pole v každém řádku. Čárka je nejběžnější, ale jiné oddělovače jsou standardní v konkrétních kontextech. Volba nesprávného oddělovače způsobí, že se pole při otevření souboru sloučí nebo nesprávně rozdělí.

Zpracování vnořeného JSON v CSV

CSV je plochý formát bez nativní podpory pro reprezentaci vnořených objektů nebo polí. Pokud váš JSON obsahuje vnořené struktury, musí převodník tyto struktury zploštit do sloupců. Existuje několik strategií a správná volba závisí na tom, jak bude CSV spotřebováno.

Příklady kódu

Programový převod JSON na CSV vyžaduje zpracování extrakce záhlaví, uvozování polí a escapování oddělovačů. Většina jazyků má vestavěnou nebo standardní podporu pro zápis 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
}

Časté dotazy