تبدیل JSON به CSV

تبدیل JSON به CSV چیست؟

تبدیل JSON به CSV داده‌های ساختاریافته را از فرمت JSON به مقادیر جداشده با کاما (CSV) تبدیل می‌کند؛ یعنی به فرمتی جدولی که صفحه‌گسترده‌ها، پایگاه‌های داده و ابزارهای تحلیل داده مستقیماً می‌خوانند. JSON داده را به‌صورت اشیاء و آرایه‌های تودرتو بدون schema ثابت ذخیره می‌کند. CSV داده را به‌صورت سطر و ستون با یک سطر سرصفحه برای نام فیلدها ذخیره می‌کند. این تبدیل، پل ارتباطی بین داده‌های API و صفحه‌گسترده‌ها و پایگاه‌های داده است.

CSV (مقادیر جداشده با کاما) در RFC 4180 تعریف شده است. هر خط یک رکورد است و فیلدهای هر خط با یک کاراکتر جداکننده — معمولاً کاما — از هم جدا می‌شوند. فیلدهایی که شامل جداکننده، گیومه دوتایی یا سطر جدید هستند باید در گیومه دوتایی محصور شوند و گیومه‌های داخلی با دوبرابر کردن آن‌ها escape می‌شوند. این escape کردن اصلی‌ترین منشأ باگ هنگام نوشتن دستی یک مبدل JSON به CSV است.

این تبدیل وقتی ورودی شما یک آرایه تخت از اشیاء با کلیدهای یکسان باشد ساده است. هر شیء یک سطر می‌شود و هر کلید منحصربه‌فرد یک سرصفحه ستون. اشیاء تودرتو و آرایه‌ها نیاز به یک مرحله تسطیح دارند، و کلیدهای متفاوت در بین اشیاء نیاز به استراتژی برای مدیریت فیلدهای غایب دارند — معمولاً سلول را خالی می‌گذارند. یک مبدل قابل‌اعتماد همه این موارد لبه‌ای را به‌طور خودکار مدیریت می‌کند.

چرا JSON را به CSV تبدیل کنیم؟

API‌ها JSON برمی‌گردانند، اما صفحه‌گسترده‌ها، پایگاه‌های داده SQL و ابزارهای BI داده جدولی می‌خواهند. تبدیل JSON به CSV به شما امکان می‌دهد داده را بین این سیستم‌ها بدون نوشتن اسکریپت import سفارشی جابجا کنید.

موارد استفاده تبدیل JSON به CSV

راهنمای جداکننده‌های CSV

کاراکتر جداکننده فیلدها را در هر سطر از هم جدا می‌کند. کاما رایج‌ترین است، اما جداکننده‌های دیگر در زمینه‌های خاص استاندارد هستند. انتخاب جداکننده اشتباه باعث ادغام یا تقسیم نادرست فیلدها هنگام باز کردن فایل می‌شود.

مدیریت JSON تودرتو در CSV

CSV یک فرمت تخت است و هیچ روش بومی برای نمایش اشیاء یا آرایه‌های تودرتو ندارد. وقتی JSON شما شامل ساختارهای تودرتو است، مبدل باید آن‌ها را به ستون‌ها تسطیح کند. روش‌های مختلفی وجود دارد و انتخاب درست بستگی به نحوه مصرف CSV دارد.

نمونه‌های کد

تبدیل برنامه‌ای JSON به CSV نیاز به مدیریت استخراج سرصفحه، نقل‌قول‌گذاری فیلدها و escape کردن جداکننده دارد. اکثر زبان‌ها پشتیبانی داخلی یا کتابخانه استاندارد برای نوشتن 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
}

سوالات متداول