JSON থেকে CSV

JSON থেকে CSV রূপান্তর কী?

JSON থেকে CSV রূপান্তর হলো JSON ফরম্যাটের কাঠামোবদ্ধ ডেটাকে কমা-বিভাজিত মান (comma-separated values) রূপে রূপান্তরিত করা — একটি সারণী ফরম্যাট যা স্প্রেডশিট, ডেটাবেজ ও বিশ্লেষণ টুলগুলো সরাসরি ব্যবহার করতে পারে। JSON ডেটা সংরক্ষণ করে নেস্টেড অবজেক্ট ও অ্যারে হিসেবে, নির্দিষ্ট কোনো স্কিমা ছাড়া। CSV ডেটা সংরক্ষণ করে সারি ও কলামে, হেডার সারিতে ফিল্ডের নাম থাকে। API ডেটা স্প্রেডশিট ও ডেটাবেজে পৌঁছানোর পথ হলো এই রূপান্তর।

CSV (Comma-Separated Values) RFC 4180 দ্বারা সংজ্ঞায়িত। প্রতিটি লাইন একটি রেকর্ড, এবং একটি লাইনের মধ্যে ফিল্ডগুলো একটি ডিলিমিটার অক্ষর দ্বারা পৃথক করা হয়, সাধারণত কমা। ডিলিমিটার, দ্বৈত উদ্ধৃতি বা লাইন বিরতিযুক্ত ফিল্ডগুলো দ্বৈত উদ্ধৃতিতে আবদ্ধ করতে হবে, ভেতরের উদ্ধৃতিগুলো দ্বিগুণ করে এস্কেপ করতে হবে। হাতে JSON-থেকে-CSV কনভার্টার লেখার সময় এই এস্কেপিং প্রধান বাগের উৎস।

একই কী সহ একটি সমতল অবজেক্ট অ্যারে ইনপুট হলে রূপান্তর সহজ। প্রতিটি অবজেক্ট একটি সারি হয়, প্রতিটি অনন্য কী একটি কলাম হেডার হয়। নেস্টেড অবজেক্ট ও অ্যারের জন্য সমতলকরণ প্রয়োজন, এবং অবজেক্টজুড়ে অসামঞ্জস্যপূর্ণ কীগুলোর জন্য অনুপস্থিত ফিল্ড পরিচালনার কৌশল দরকার — সাধারণত কক্ষটি খালি রাখা হয়। একটি নির্ভরযোগ্য কনভার্টার এই সমস্ত প্রান্তিক ক্ষেত্র স্বয়ংক্রিয়ভাবে পরিচালনা করে।

কেন 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
}

প্রায়শই জিজ্ঞাসিত প্রশ্ন