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 to 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
}

Часто задаваемые вопросы