Chuyển đổi CSV sang YAML

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

Chuyển đổi CSV sang YAML biến dữ liệu dạng bảng phân cách bằng dấu phẩy thành định dạng YAML (YAML Ain't Markup Language). Mỗi hàng của tệp CSV trở thành một phần tử trong một chuỗi YAML, và mỗi tiêu đề cột ánh xạ thành một khóa trong một ánh xạ YAML. Kết quả là một tài liệu dễ đọc dựa trên thụt lề mà các công cụ cấu hình và pipeline dữ liệu có thể phân tích trực tiếp mà không cần tệp schema bổ sung.

YAML được đề xuất lần đầu vào năm 2001 và đạt đến đặc tả hiện tại (YAML 1.2) vào năm 2009. Đây là định dạng cấu hình mặc định cho các manifest Kubernetes, tệp Docker Compose, playbook Ansible, workflow GitHub Actions và nhiều hệ thống CI/CD. Khi dữ liệu nguồn của bạn nằm trong bảng tính hoặc bản xuất cơ sở dữ liệu, việc chuyển đổi CSV sang YAML là cách nhanh nhất để tạo các mục cấu hình, dữ liệu seed fixture, hoặc đầu vào kiểm thử cho các hệ thống này.

Một công cụ chuyển đổi CSV sang YAML đúng chuẩn phải xử lý các quy tắc phân tích RFC 4180: các trường được trích dẫn chứa dấu phẩy hoặc ký tự xuống dòng, dấu ngoặc kép được thoát, và các dấu phân cách khác nhau. Về phía YAML, các chuỗi trông giống boolean (yes, no, true, false), số, hoặc null phải được trích dẫn để ngăn bộ phân tích YAML chuyển đổi chúng thành các kiểu dữ liệu không mong muốn. Công cụ cũng cần xử lý nội dung Unicode và tạo đầu ra UTF-8 hợp lệ, vì YAML 1.2 yêu cầu UTF-8 là mã hóa mặc định.

Tại sao nên dùng công cụ chuyển CSV sang YAML?

Viết tay YAML từ dữ liệu bảng tính rất tẻ nhạt và dễ mắc lỗi. Một thụt lề sai chỗ hoặc một ký tự đặc biệt không được trích dẫn sẽ tạo ra YAML không hợp lệ làm hỏng quá trình triển khai cấu hình hoặc nhập dữ liệu. Công cụ chuyển đổi này phân tích các trường CSV, ánh xạ tiêu đề thành khóa, và tạo đầu ra YAML được thụt lề và trích dẫn đúng chuẩn.

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

Tham khảo ánh xạ CSV sang YAML

Mỗi thành phần cấu trúc của tệp CSV có một đối tượng tương ứng trực tiếp trong YAML.

So sánh CSV và YAML

CSV là định dạng phẳng phân cách bằng ký tự, không có thông tin kiểu dữ liệu hay phân cấp. YAML là tập cha của JSON sử dụng thụt lề để lồng nhau, hỗ trợ nhiều kiểu dữ liệu và cho phép chú thích. Sự lựa chọn phụ thuộc vào những gì công cụ đầu cuối của bạn yêu cầu.

Ví dụ mã

Các ví dụ thực tế trong Node.js, Python, Go và các công cụ CLI. Mỗi ví dụ đọc hàng tiêu đề CSV làm khóa YAML, ánh xạ mỗi hàng dữ liệu thành một phần tử chuỗi, và xử lý việc trích dẫn cho các giá trị không rõ kiểu.

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

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