JSON'dan CSV'ye Dönüştürücü

JSON'dan CSV'ye Dönüşüm Nedir?

JSON'dan CSV'ye dönüşüm, yapılandırılmış verileri JSON formatından virgülle ayrılmış değerlere (CSV) aktarır; bu tablo formatı, elektronik tablolar, veritabanları ve analitik araçlar tarafından doğrudan kullanılır. JSON, verileri sabit bir şema olmadan iç içe nesneler ve diziler olarak saklar. CSV ise verileri alan adlarını tanımlayan bir başlık satırıyla satırlar ve sütunlar halinde saklar. Bu dönüşüm, API verilerinin elektronik tablolara ve veritabanlarına ulaşmasını sağlar.

CSV (Comma-Separated Values), RFC 4180 tarafından tanımlanmıştır. Her satır bir kayıttır ve bir satırdaki alanlar en yaygın olarak virgül olan bir sınırlayıcı karakterle ayrılır. Sınırlayıcı, çift tırnak veya satır sonu içeren alanlar çift tırnak içine alınmalı; içindeki tırnak işaretleri ise ikiye katlanarak kaçırılmalıdır. Bu kaçırma işlemi, JSON'dan CSV dönüştürücüyü elle yazarken hataların birincil kaynağıdır.

Girdiniz tutarlı anahtarlara sahip düz bir nesne dizisi olduğunda dönüşüm basittir. Her nesne bir satır olur ve her benzersiz anahtar bir sütun başlığı olur. İç içe nesneler ve diziler bir düzleştirme adımı gerektirir; nesneler arasındaki tutarsız anahtarlar ise eksik alanları işlemek için bir strateji gerektirir — genellikle hücre boş bırakılır. Güvenilir bir dönüştürücü tüm bu özel durumları otomatik olarak işler.

Neden JSON'dan CSV'ye Dönüştürülür?

API'ler JSON döndürür; ancak elektronik tablolar, SQL veritabanları ve BI araçları tablo verisi bekler. JSON'dan CSV'ye dönüşüm, özel içe aktarma betikleri yazmadan bu sistemler arasında veri taşımanızı sağlar.

JSON'dan CSV'ye Kullanım Senaryoları

CSV Sınırlayıcı Referansı

Sınırlayıcı karakteri, her satırdaki alanları birbirinden ayırır. Virgül en yaygın olanıdır; ancak belirli bağlamlarda diğer sınırlayıcılar da standarttır. Yanlış sınırlayıcı seçimi, dosya açıldığında alanların yanlış birleşmesine veya bölünmesine neden olur.

CSV'de İç İçe JSON İşleme

CSV, iç içe nesneleri veya dizileri temsil etmek için yerel bir yola sahip olmayan düz bir formattır. JSON'unuz iç içe yapılar içerdiğinde, dönüştürücü bunları sütunlara düzleştirmelidir. Birkaç strateji vardır ve doğru seçim, CSV'nin nasıl kullanılacağına bağlıdır.

Kod Örnekleri

JSON'u programatik olarak CSV'ye dönüştürmek, başlık çıkarma, alan tırnaklama ve sınırlayıcı kaçırmayı gerektirir. Çoğu dilde CSV yazma için yerleşik veya standart kütüphane desteği mevcuttur.

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
}

Sıkça Sorulan Sorular