แปลง JSON เป็น CSV

การแปลง JSON เป็น CSV คืออะไร?

การแปลง JSON เป็น CSV คือการเปลี่ยนข้อมูลที่มีโครงสร้างจากรูปแบบ JSON ให้เป็นค่าที่คั่นด้วยจุลภาค ซึ่งเป็นรูปแบบตารางที่ spreadsheet ฐานข้อมูล และเครื่องมือวิเคราะห์ข้อมูลรองรับโดยตรง JSON เก็บข้อมูลเป็นออบเจกต์และอาร์เรย์ที่ซ้อนกันโดยไม่มี schema ตายตัว ส่วน CSV เก็บข้อมูลเป็นแถวและคอลัมน์พร้อมแถวส่วนหัวที่กำหนดชื่อฟิลด์ การแปลงนี้คือสะพานเชื่อมข้อมูล API สู่ spreadsheet และฐานข้อมูล

CSV (Comma-Separated Values) ถูกกำหนดโดย RFC 4180 แต่ละบรรทัดคือหนึ่งระเบียน และฟิลด์ภายในบรรทัดถูกคั่นด้วยอักขระตัวคั่น ซึ่งส่วนใหญ่มักเป็นจุลภาค ฟิลด์ที่มีตัวคั่น เครื่องหมายอัญประกาศคู่ หรือการขึ้นบรรทัดใหม่ต้องถูกครอบด้วยเครื่องหมายอัญประกาศคู่ โดยอัญประกาศภายในต้อง escape ด้วยการซ้ำ การ escape นี้เป็นต้นเหตุหลักของบั๊กเมื่อเขียนตัวแปลง JSON เป็น CSV เอง

การแปลงทำได้ง่ายเมื่ออินพุตเป็น array แบบแบนของออบเจกต์ที่มี key สม่ำเสมอ แต่ละออบเจกต์กลายเป็นหนึ่งแถว และ key ที่ไม่ซ้ำกันแต่ละตัวกลายเป็นส่วนหัวของคอลัมน์ ออบเจกต์และอาร์เรย์ที่ซ้อนกันต้องการขั้นตอนการแผ่ข้อมูล และ key ที่ไม่สม่ำเสมอต้องมีกลยุทธ์สำหรับฟิลด์ที่ขาดหายไป ซึ่งโดยทั่วไปจะปล่อยเซลล์ว่าง ตัวแปลงที่เชื่อถือได้จัดการกรณีพิเศษเหล่านี้ทั้งหมดโดยอัตโนมัติ

ทำไมต้องแปลง JSON เป็น CSV?

API ส่งข้อมูลกลับมาเป็น JSON แต่ spreadsheet ฐานข้อมูล SQL และเครื่องมือ BI คาดหวังข้อมูลแบบตาราง การแปลง JSON เป็น CSV ช่วยให้คุณเคลื่อนย้ายข้อมูลระหว่างระบบเหล่านี้โดยไม่ต้องเขียนสคริปต์นำเข้าเอง

กรณีการใช้งานแปลง JSON เป็น CSV

อ้างอิงตัวคั่น CSV

อักขระตัวคั่นแยกฟิลด์ภายในแต่ละแถว จุลภาคเป็นตัวคั่นที่พบมากที่สุด แต่ตัวคั่นอื่นเป็นมาตรฐานในบริบทเฉพาะ การเลือกตัวคั่นผิดทำให้ฟิลด์ถูกรวมหรือแยกผิดพลาดเมื่อเปิดไฟล์

การจัดการ JSON ที่ซ้อนกันใน CSV

CSV เป็นรูปแบบแบนที่ไม่มีวิธีแทนออบเจกต์หรืออาร์เรย์ที่ซ้อนกันโดยตรง เมื่อ JSON ของคุณมีโครงสร้างซ้อนกัน ตัวแปลงต้องแผ่ข้อมูลออกเป็นคอลัมน์ มีกลยุทธ์หลายวิธี และการเลือกที่เหมาะสมขึ้นอยู่กับว่าจะนำ CSV ไปใช้อย่างไร

ตัวอย่างโค้ด

การแปลง JSON เป็น CSV ด้วยโปรแกรมต้องจัดการการดึงส่วนหัว การครอบฟิลด์ด้วยอัญประกาศ และการ escape ตัวคั่น ภาษาส่วนใหญ่มีการรองรับในตัวหรือใน standard library สำหรับการเขียน 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
}

คำถามที่พบบ่อย