Chuyển JSON sang CSV

Chuyển đổi JSON sang CSV là gì?

Chuyển đổi JSON sang CSV biến đổi dữ liệu có cấu trúc từ định dạng JSON thành các giá trị phân cách bằng dấu phẩy — định dạng bảng mà các bảng tính, cơ sở dữ liệu và công cụ phân tích sử dụng trực tiếp. JSON lưu trữ dữ liệu dưới dạng các đối tượng và mảng lồng nhau không có schema cố định. CSV lưu trữ dữ liệu dưới dạng hàng và cột với hàng tiêu đề xác định tên trường. Việc chuyển đổi này là cách dữ liệu API được đưa vào bảng tính và cơ sở dữ liệu.

CSV (Comma-Separated Values) được định nghĩa bởi RFC 4180. Mỗi dòng là một bản ghi, và các trường trong một dòng được phân cách bằng ký tự dấu phân cách, thường nhất là dấu phẩy. Các trường chứa dấu phân cách, dấu ngoặc kép hoặc ngắt dòng phải được đặt trong dấu ngoặc kép, với các dấu ngoặc kép bên trong được thoát bằng cách nhân đôi chúng. Việc thoát ký tự này là nguồn gốc chính của lỗi khi tự viết bộ chuyển đổi JSON sang CSV.

Việc chuyển đổi rất đơn giản khi đầu vào là một mảng phẳng các đối tượng có key nhất quán. Mỗi đối tượng trở thành một hàng, và mỗi key duy nhất trở thành tiêu đề cột. Các đối tượng và mảng lồng nhau cần bước làm phẳng, và các key không nhất quán giữa các đối tượng cần chiến lược xử lý trường thiếu — thường để ô trống. Một bộ chuyển đổi đáng tin cậy xử lý tất cả các trường hợp ngoại lệ này tự động.

Tại sao cần chuyển đổi JSON sang CSV?

API trả về JSON, nhưng bảng tính, cơ sở dữ liệu SQL và công cụ BI cần dữ liệu dạng bảng. Chuyển đổi JSON sang CSV giúp bạn di chuyển dữ liệu giữa các hệ thống này mà không cần viết script nhập tùy chỉnh.

Các trường hợp sử dụng JSON sang CSV

Tham chiếu dấu phân cách CSV

Ký tự dấu phân cách tách các trường trong mỗi hàng. Dấu phẩy là phổ biến nhất, nhưng các dấu phân cách khác là tiêu chuẩn trong các ngữ cảnh cụ thể. Chọn sai dấu phân cách khiến các trường bị gộp hoặc tách sai khi mở file.

Xử lý JSON lồng nhau trong CSV

CSV là định dạng phẳng, không có cách biểu diễn trực tiếp các đối tượng hoặc mảng lồng nhau. Khi JSON chứa các cấu trúc lồng nhau, bộ chuyển đổi phải làm phẳng chúng thành các cột. Có nhiều chiến lược khác nhau, và lựa chọn phù hợp phụ thuộc vào cách CSV sẽ được sử dụng.

Ví dụ mã nguồn

Chuyển đổi JSON sang CSV theo lập trình cần xử lý trích xuất tiêu đề, trích dẫn trường và thoát dấu phân cách. Hầu hết các ngôn ngữ đều có hỗ trợ tích hợp sẵn hoặc trong thư viện chuẩn để ghi 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
}

Câu hỏi thường gặp