JSON to CSV

JSON से CSV रूपांतरण क्या है?

JSON से CSV रूपांतरण संरचित डेटा को JSON फ़ॉर्मेट से अल्पविराम-पृथक मानों (comma-separated values) में बदलता है — एक सारणीबद्ध फ़ॉर्मेट जिसे स्प्रेडशीट, डेटाबेस और विश्लेषण उपकरण सीधे उपयोग कर सकते हैं। JSON फ़ॉर्मेट डेटा को नेस्टेड ऑब्जेक्ट और ऐरे के रूप में बिना किसी निश्चित स्कीमा के संग्रहीत करता है। CSV डेटा को पंक्तियों और स्तंभों के रूप में संग्रहीत करता है जिसमें एक शीर्षक पंक्ति फ़ील्ड नाम परिभाषित करती है। इसी रूपांतरण की मदद से API डेटा स्प्रेडशीट और डेटाबेस तक पहुँचता है।

CSV (Comma-Separated Values) RFC 4180 द्वारा परिभाषित है। प्रत्येक पंक्ति एक record है, और पंक्ति के भीतर फ़ील्ड एक सीमांकक वर्ण द्वारा अलग होते हैं, जो सामान्यतः अल्पविराम होता है। सीमांकक, दोहरे उद्धरण चिह्न या पंक्ति विराम वाले फ़ील्ड को दोहरे उद्धरण चिह्नों में बंद करना आवश्यक है, और आंतरिक उद्धरण चिह्नों को दोगुना करके escape किया जाता है। यही एस्केपिंग JSON-to-CSV कनवर्टर लिखते समय त्रुटियों का प्रमुख स्रोत है।

जब आपका इनपुट समान कुंजियों वाले ऑब्जेक्ट के एक सपाट ऐरे के रूप में हो, तो रूपांतरण सीधा होता है। प्रत्येक ऑब्जेक्ट एक पंक्ति बनता है और प्रत्येक अद्वितीय कुंजी एक स्तंभ शीर्षक बनती है। नेस्टेड ऑब्जेक्ट और ऐरे के लिए समतलीकरण (flattening) आवश्यक है, और ऑब्जेक्ट में असंगत कुंजियों के लिए अनुपस्थित फ़ील्ड को संभालने की रणनीति चाहिए — सामान्यतः सेल को रिक्त छोड़ा जाता है। एक विश्वसनीय कनवर्टर इन सभी सीमांत परिस्थितियों को स्वचालित रूप से संभालता है।

JSON को CSV में क्यों बदलें?

API JSON लौटाते हैं, लेकिन स्प्रेडशीट, SQL डेटाबेस और BI उपकरण सारणीबद्ध डेटा की अपेक्षा करते हैं। JSON को CSV में बदलना इन प्रणालियों के बीच कस्टम आयात स्क्रिप्ट लिखे बिना डेटा स्थानांतरित करने की सुविधा देता है।

JSON से CSV उपयोग के मामले

CSV डेलिमिटर संदर्भ

डेलिमिटर वर्ण प्रत्येक पंक्ति में फ़ील्ड को अलग करता है। अल्पविराम सबसे सामान्य है, लेकिन विशिष्ट संदर्भों में अन्य डेलिमिटर मानक हैं। गलत डेलिमिटर चुनने से फ़ाइल खोलने पर फ़ील्ड गलत तरीके से मिल या विभाजित हो जाते हैं।

CSV के लिए नेस्टेड JSON फ्लैट करना

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
}

अक्सर पूछे जाने वाले प्रश्न