แปลง CSV เป็น YAML

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

การแปลง CSV เป็น YAML คือกระบวนการเปลี่ยนข้อมูลตารางที่คั่นด้วยจุลภาคให้กลายเป็นรูปแบบ YAML (YAML Ain't Markup Language) แต่ละแถวของไฟล์ CSV จะกลายเป็น entry ใน YAML sequence และแต่ละหัวคอลัมน์จะถูก map เป็น key ใน YAML mapping ผลลัพธ์คือเอกสารที่มนุษย์อ่านได้โดยอาศัยการย่อหน้า ซึ่งเครื่องมือ configuration และ data pipeline สามารถ parse ได้โดยตรงโดยไม่ต้องมีไฟล์ schema เพิ่มเติม

YAML ถูกเสนอครั้งแรกในปี 2001 และบรรลุข้อกำหนดฉบับปัจจุบัน (YAML 1.2) ในปี 2009 รูปแบบนี้เป็น configuration format หลักสำหรับ Kubernetes manifests, Docker Compose files, Ansible playbooks, GitHub Actions workflows และระบบ CI/CD จำนวนมาก เมื่อข้อมูลต้นทางอยู่ใน spreadsheet หรือการส่งออกจากฐานข้อมูล การแปลง CSV เป็น YAML คือวิธีที่เร็วที่สุดในการสร้าง config entries, seed data fixtures หรือ test inputs สำหรับระบบเหล่านี้

เครื่องมือแปลง CSV เป็น YAML ที่ถูกต้องต้องรองรับกฎการ parse ตาม RFC 4180 ได้แก่ ฟิลด์ที่ใส่เครื่องหมายคำพูดซึ่งมีจุลภาคหรือขึ้นบรรทัดใหม่ เครื่องหมายคำพูดคู่ที่ escape แล้ว และตัวคั่นที่หลากหลาย ในส่วนของ YAML ต้องทำการใส่เครื่องหมายคำพูดกับสตริงที่มีลักษณะคล้าย boolean (yes, no, true, false) ตัวเลข หรือ null เพื่อป้องกัน YAML parser จากการแปลงประเภทที่ไม่ต้องการ นอกจากนี้ยังต้องรองรับเนื้อหา Unicode และสร้างผลลัพธ์ UTF-8 ที่ถูกต้อง เนื่องจาก YAML 1.2 กำหนดให้ UTF-8 เป็น encoding เริ่มต้น

ทำไมต้องใช้เครื่องมือแปลง CSV เป็น YAML?

การเขียน YAML ด้วยมือจากข้อมูล spreadsheet เป็นงานที่น่าเบื่อและเกิดข้อผิดพลาดได้ง่าย การย่อหน้าที่ผิดพลาดหรืออักขระพิเศษที่ไม่ได้ใส่เครื่องหมายคำพูดจะทำให้ YAML ไม่ถูกต้องและทำให้ config deployments หรือการนำเข้าข้อมูลล้มเหลว เครื่องมือนี้ parse ฟิลด์ CSV, map หัวคอลัมน์เป็น key และสร้าง YAML output ที่มีการย่อหน้าและเครื่องหมายคำพูดที่ถูกต้อง

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

ตารางอ้างอิงการ mapping CSV เป็น YAML

แต่ละองค์ประกอบโครงสร้างของไฟล์ CSV มีส่วนที่สอดคล้องกันใน YAML โดยตรง

CSV เทียบกับ YAML

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

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

ตัวอย่างการทำงานใน Node.js, Python, Go และ CLI tools แต่ละตัวอย่างจะอ่านแถวหัวคอลัมน์ของ CSV เป็น YAML keys, map แต่ละแถวข้อมูลเป็น sequence entry และจัดการการใส่เครื่องหมายคำพูดสำหรับค่าที่มีความกำกวมทางประเภทข้อมูล

import { parse } from 'csv-parse/sync'
import { stringify } from 'yaml'

const csv = `name,age,city
Alice,30,Berlin
Bob,25,"New York"`

const records = parse(csv, { columns: true, skip_empty_lines: true })
console.log(stringify(records))
// → - name: Alice
// →   age: "30"
// →   city: Berlin
// → - name: Bob
// →   age: "25"
// →   city: New York

// Vanilla JS (no dependencies)
function csvToYaml(csv) {
  const [headerLine, ...dataLines] = csv.trim().split('\n')
  const headers = headerLine.split(',')
  return dataLines.map(line => {
    const values = line.split(',')
    return headers.map((h, i) => `  ${h}: ${values[i] || ''}`).join('\n')
  }).map(block => `- ${block.trimStart()}`).join('\n')
}

import csv, io, yaml

csv_string = """name,age,city
Alice,30,Berlin
Bob,25,New York"""

reader = csv.DictReader(io.StringIO(csv_string))
data = list(reader)

# default_flow_style=False produces block-style YAML
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
# → - age: '30'
# →   city: Berlin
# →   name: Alice
# → - age: '25'
# →   city: New York
# →   name: Bob

# Preserve insertion order with sort_keys=False (Python 3.7+)
# To type-cast numbers: data = [{k: int(v) if v.isdigit() else v ...}]

package main

import (
	"encoding/csv"
	"fmt"
	"gopkg.in/yaml.v3"
	"strings"
)

func main() {
	input := "name,age,city
Alice,30,Berlin
Bob,25,New York"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()
	headers := records[0]

	var data []map[string]string
	for _, row := range records[1:] {
		entry := make(map[string]string)
		for i, h := range headers {
			entry[h] = row[i]
		}
		data = append(data, entry)
	}

	out, _ := yaml.Marshal(data)
	fmt.Println(string(out))
	// → - age: "30"
	// →   city: Berlin
	// →   name: Alice
	// → - age: "25"
	// →   city: New York
	// →   name: Bob
}

# Using yq (https://github.com/mikefarah/yq)
# yq reads CSV with --input-format=csv
yq --input-format=csv --output-format=yaml '.' data.csv

# Using Miller (mlr) — converts between CSV, JSON, YAML, and more
mlr --icsv --oyaml cat data.csv

# Python one-liner for quick conversion
python3 -c "
import csv, sys, yaml
data = list(csv.DictReader(sys.stdin))
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
" < data.csv

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