JSON to CSV

Що таке конвертація JSON у CSV?

Конвертація JSON у CSV перетворює структуровані дані з формату JSON у значення, розділені комою — табличний формат, який таблиці, бази даних і аналітичні інструменти сприймають нативно. JSON зберігає дані як вкладені об'єкти та масиви без фіксованої схеми. CSV зберігає дані як рядки й стовпці з рядком заголовка, що визначає імена полів. Конвертація — це спосіб, яким дані з API потрапляють до таблиць і баз даних.

CSV (Comma-Separated Values) визначається стандартом RFC 4180. Кожен рядок — це один запис, а поля в рядку розділяються символом-роздільником, найчастіше комою. Поля, що містять роздільник, подвійні лапки або переноси рядка, мають бути взяті у подвійні лапки, а внутрішні лапки екрануються подвоєнням. Саме це екранування є головним джерелом помилок при написанні конвертера JSON у CSV вручну.

Конвертація проста, коли вхідні дані — це плаский масив об'єктів з однаковими ключами. Кожен об'єкт стає одним рядком, а кожен унікальний ключ — заголовком стовпця. Вкладені об'єкти та масиви потребують кроку вирівнювання, а непослідовні ключі між об'єктами вимагають стратегії обробки відсутніх полів — зазвичай клітинку залишають порожньою. Надійний конвертер обробляє всі ці граничні випадки автоматично.

Навіщо конвертувати JSON у CSV?

API повертають JSON, але таблиці, SQL-бази даних і BI-інструменти очікують табличні дані. Конвертація JSON у CSV дозволяє переміщати дані між цими системами без написання власних скриптів імпорту.

Сценарії використання JSON у CSV

Довідник роздільників CSV

Символ-роздільник розділяє поля в кожному рядку. Кома є найпоширенішою, але інші роздільники є стандартними в конкретних контекстах. Вибір неправильного роздільника призводить до злиття або розбиття полів при відкритті файлу.

Обробка вкладеного JSON у CSV

CSV — це плаский формат без нативного способу представлення вкладених об'єктів або масивів. Коли JSON містить вкладені структури, конвертер має вирівняти їх у стовпці. Існує кілька стратегій, і правильний вибір залежить від того, як буде використовуватися CSV.

Приклади коду

Програмна конвертація JSON у CSV потребує обробки видобутку заголовків, екранування полів і роздільників. У більшості мов є вбудована або стандартна бібліотечна підтримка запису 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
}

Часті запитання