JSON to CSV

Apa itu Konversi JSON ke CSV?

Konversi JSON ke CSV mengubah data terstruktur dari format JSON menjadi nilai-nilai yang dipisahkan koma, sebuah format tabular yang secara alami dikonsumsi oleh spreadsheet, basis data, dan alat analitik. JSON menyimpan data sebagai objek dan array bersarang tanpa skema yang tetap. CSV menyimpan data sebagai baris dan kolom dengan baris header yang mendefinisikan nama kolom. Konversi inilah yang memungkinkan data dari API masuk ke spreadsheet dan basis data.

CSV (Comma-Separated Values) didefinisikan oleh RFC 4180. Setiap baris adalah satu record, dan kolom dalam sebuah baris dipisahkan oleh karakter pembatas, yang paling umum adalah koma. Kolom yang mengandung pembatas, tanda kutip ganda, atau baris baru harus diapit oleh tanda kutip ganda, dengan tanda kutip di dalamnya di-escape dengan cara menggandakannya. Proses escape inilah yang menjadi sumber utama bug saat menulis konverter JSON-ke-CSV secara manual.

Konversi berjalan lancar ketika input Anda berupa array flat dari objek dengan kunci yang konsisten. Setiap objek menjadi satu baris, dan setiap kunci unik menjadi header kolom. Objek dan array bersarang memerlukan langkah perataan (flattening), dan kunci yang tidak konsisten antar objek membutuhkan strategi untuk menangani kolom yang tidak ada — biasanya dengan membiarkan sel tersebut kosong. Konverter yang andal menangani semua kasus tepi ini secara otomatis.

Mengapa Mengonversi JSON ke CSV?

API mengembalikan JSON, tetapi spreadsheet, basis data SQL, dan alat BI mengharapkan data tabular. Mengonversi JSON ke CSV memungkinkan Anda memindahkan data antar sistem ini tanpa menulis skrip impor kustom.

Kasus Penggunaan JSON ke CSV

Referensi Pembatas CSV

Karakter pembatas memisahkan kolom dalam setiap baris. Koma adalah yang paling umum, tetapi pembatas lain juga standar dalam konteks tertentu. Memilih pembatas yang salah menyebabkan kolom bergabung atau terpecah secara tidak benar saat file dibuka.

Menangani JSON Bersarang dalam CSV

CSV adalah format flat yang tidak memiliki cara alami untuk merepresentasikan objek atau array bersarang. Ketika JSON Anda mengandung struktur bersarang, konverter harus meratakannya menjadi kolom. Ada beberapa strategi, dan pilihan yang tepat bergantung pada bagaimana CSV akan dikonsumsi.

Contoh Kode

Mengonversi JSON ke CSV secara terprogram memerlukan penanganan ekstraksi header, pengapit kolom, dan escape pembatas. Sebagian besar bahasa memiliki dukungan bawaan atau dari pustaka standar untuk penulisan 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
}

Pertanyaan yang Sering Diajukan