Da JSON a CSV

Cos'è la conversione da JSON a CSV?

La conversione da JSON a CSV trasforma dati strutturati dal formato JSON in valori separati da virgola, un formato tabulare che fogli di calcolo, database e strumenti di analisi consumano nativamente. JSON memorizza i dati come oggetti e array annidati senza uno schema fisso. CSV memorizza i dati come righe e colonne, con una riga di intestazione che definisce i nomi dei campi. La conversione è il modo in cui i dati delle API raggiungono i fogli di calcolo e i database.

CSV (Comma-Separated Values) è definito da RFC 4180. Ogni riga è un record, e i campi all'interno di una riga sono separati da un carattere delimitatore, più comunemente una virgola. I campi che contengono il delimitatore, virgolette doppie o interruzioni di riga devono essere racchiusi tra virgolette doppie, con le virgolette interne precedute da un raddoppio. Questo meccanismo di escape è la principale fonte di bug quando si scrive un convertitore da JSON a CSV a mano.

La conversione è diretta quando l'input è un array piatto di oggetti con chiavi consistenti. Ogni oggetto diventa una riga, e ogni chiave univoca diventa un'intestazione di colonna. Oggetti annidati e array richiedono un passaggio di appiattimento, e chiavi inconsistenti tra gli oggetti richiedono una strategia per gestire i campi mancanti — in genere lasciando la cella vuota. Un convertitore affidabile gestisce automaticamente tutti questi casi limite.

Perché convertire JSON in CSV?

Le API restituiscono JSON, ma fogli di calcolo, database SQL e strumenti BI si aspettano dati tabulari. Convertire JSON in CSV consente di spostare i dati tra questi sistemi senza scrivere script di importazione personalizzati.

Casi d'uso della conversione JSON in CSV

Riferimento ai delimitatori CSV

Il carattere delimitatore separa i campi all'interno di ogni riga. La virgola è il più comune, ma altri delimitatori sono standard in contesti specifici. Scegliere il delimitatore sbagliato causa la fusione o la divisione errata dei campi quando il file viene aperto.

Gestione del JSON annidato in CSV

CSV è un formato piatto senza modo nativo di rappresentare oggetti o array annidati. Quando il JSON contiene strutture annidate, il convertitore deve appiattirle in colonne. Esistono diverse strategie, e la scelta giusta dipende da come il CSV verrà utilizzato.

Esempi di codice

Convertire JSON in CSV in modo programmatico richiede di gestire l'estrazione delle intestazioni, la quotatura dei campi e l'escaping del delimitatore. La maggior parte dei linguaggi dispone di supporto integrato o nella libreria standard per la scrittura di 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
}

Domande frequenti