Python で JSON を CSV に変換する方法

import json
import csv

# サンプル JSON データ — 注文オブジェクトの配列
json_string = """
[
  {"order_id": "ord_91a3", "product": "Wireless Keyboard", "quantity": 2, "unit_price": 74.99},
  {"order_id": "ord_b7f2", "product": "USB-C Hub", "quantity": 1, "unit_price": 34.50},
  {"order_id": "ord_c4e8", "product": "Monitor Stand", "quantity": 3, "unit_price": 29.95}
]
"""

records = json.loads(json_string)

with open("orders.csv", "w", newline="", encoding="utf-8") as csvfile:
    writer = csv.DictWriter(csvfile, fieldnames=records[0].keys())
    writer.writeheader()
    writer.writerows(records)

# orders.csv:
# order_id,product,quantity,unit_price
# ord_91a3,Wireless Keyboard,2,74.99
# ord_b7f2,USB-C Hub,1,34.50
# ord_c4e8,Monitor Stand,3,29.95

import json
import csv

with open("server_metrics.json", encoding="utf-8") as jf:
    metrics = json.load(jf)  # ファイルオブジェクトには json.load() を使用

# 明示的な fieldnames で列の順序を制御
columns = ["timestamp", "hostname", "cpu_percent", "memory_mb", "disk_io_ops"]

with open("server_metrics.csv", "w", newline="", encoding="utf-8") as cf:
    writer = csv.DictWriter(cf, fieldnames=columns, extrasaction="ignore")
    writer.writeheader()
    writer.writerows(metrics)

# 指定した5列だけが、その順序通りに出力される

import json
import csv
from datetime import datetime, timezone
from decimal import Decimal
from uuid import UUID

# Python 型を持つ解析済み API レスポンスをシミュレート
transactions = [
    {
        "txn_id": UUID("a1b2c3d4-e5f6-7890-abcd-ef1234567890"),
        "created_at": datetime(2026, 3, 15, 9, 30, 0, tzinfo=timezone.utc),
        "amount": Decimal("1249.99"),
        "currency": "USD",
        "merchant": "CloudHost Inc.",
    },
    {
        "txn_id": UUID("b2c3d4e5-f6a7-8901-bcde-f12345678901"),
        "created_at": datetime(2026, 3, 15, 14, 12, 0, tzinfo=timezone.utc),
        "amount": Decimal("87.50"),
        "currency": "EUR",
        "merchant": "DataSync GmbH",
    },
]

def prepare_row(record: dict) -> dict:
    """非文字列型を CSV に適した文字列に変換する。"""
    return {
        "txn_id": str(record["txn_id"]),
        "created_at": record["created_at"].isoformat(),
        "amount": f"{record['amount']:.2f}",
        "currency": record["currency"],
        "merchant": record["merchant"],
    }

with open("transactions.csv", "w", newline="", encoding="utf-8") as f:
    writer = csv.DictWriter(f, fieldnames=["txn_id", "created_at", "amount", "currency", "merchant"])
    writer.writeheader()
    for txn in transactions:
        writer.writerow(prepare_row(txn))

# transactions.csv:
# txn_id,created_at,amount,currency,merchant
# a1b2c3d4-e5f6-7890-abcd-ef1234567890,2026-03-15T09:30:00+00:00,1249.99,USD,CloudHost Inc.
# b2c3d4e5-f6a7-8901-bcde-f12345678901,2026-03-15T14:12:00+00:00,87.50,EUR,DataSync GmbH

import pandas as pd

# JSON 配列を直接 DataFrame に読み込む
df = pd.read_json("warehouse_inventory.json")

# CSV に書き込む — index=False で自動生成の行番号を防ぐ
df.to_csv("warehouse_inventory.csv", index=False)

# 以上。2行だけ。pandas は列の型を自動推論する。

import json
import pandas as pd

api_response = """
[
  {
    "order_id": "ord_91a3",
    "placed_at": "2026-03-15T09:30:00Z",
    "customer": {
      "name": "Sarah Chen",
      "email": "s.chen@example.com",
      "tier": "premium"
    },
    "shipping": {
      "method": "express",
      "address": {
        "city": "Portland",
        "state": "OR",
        "zip": "97201"
      }
    },
    "total": 299.95
  },
  {
    "order_id": "ord_b7f2",
    "placed_at": "2026-03-15T14:12:00Z",
    "customer": {
      "name": "James Park",
      "email": "j.park@example.com",
      "tier": "standard"
    },
    "shipping": {
      "method": "standard",
      "address": {
        "city": "Austin",
        "state": "TX",
        "zip": "73301"
      }
    },
    "total": 87.50
  }
]
"""

orders = json.loads(api_response)

# json_normalize はネストされた dict をフラット化 — sep で区切り文字を制御
df = pd.json_normalize(orders, sep="_")
df.to_csv("flat_orders.csv", index=False)

# 結果の列:
# order_id, placed_at, customer_name, customer_email, customer_tier,
# shipping_method, shipping_address_city, shipping_address_state,
# shipping_address_zip, total

import pandas as pd

df = pd.read_json("telemetry_events.json")

# 明示的なエンコーディングと欠損値の処理を含む TSV 出力
df.to_csv(
    "telemetry_events.tsv",
    sep="\t",
    index=False,
    encoding="utf-8",
    na_rep="NULL",
    columns=["event_id", "timestamp", "source", "severity", "message"],
)

# シェルスクリプトでパイプするために stdout に書き込む
print(df.to_csv(index=False))

# 文字列として返す（ファイルは書き込まれない）
csv_string = df.to_csv(index=False)
print(len(csv_string), "文字")

import json
import csv
import sys

def json_file_to_csv(input_path: str, output_path: str) -> int:
    """オブジェクトの配列を含む JSON ファイルを CSV に変換する。
    書き込んだ行数を返す。
    """
    try:
        with open(input_path, encoding="utf-8") as jf:
            data = json.load(jf)
    except FileNotFoundError:
        print(f"エラー: {input_path} が見つかりません", file=sys.stderr)
        return 0
    except json.JSONDecodeError as exc:
        print(f"エラー: {input_path} の JSON が不正です: {exc.msg} ({exc.lineno} 行目)", file=sys.stderr)
        return 0

    if not isinstance(data, list) or not data:
        print(f"エラー: {input_path} に空でない JSON 配列が必要です", file=sys.stderr)
        return 0

    # 全レコードのユニークなキーを収集 — スキーマが一致しない場合に対応
    all_keys: list[str] = []
    seen: set[str] = set()
    for record in data:
        for key in record:
            if key not in seen:
                all_keys.append(key)
                seen.add(key)

    with open(output_path, "w", newline="", encoding="utf-8") as cf:
        writer = csv.DictWriter(cf, fieldnames=all_keys, restval="", extrasaction="ignore")
        writer.writeheader()
        writer.writerows(data)

    return len(data)

rows = json_file_to_csv("deploy_logs.json", "deploy_logs.csv")
print(f"{rows} 行を deploy_logs.csv に書き込みました")

import json
import csv
import urllib.request
import urllib.error

def api_response_to_csv(url: str, output_path: str) -> int:
    """REST API エンドポイントから JSON を取得して CSV として書き込む。"""
    try:
        req = urllib.request.Request(url, headers={"Accept": "application/json"})
        with urllib.request.urlopen(req, timeout=30) as resp:
            if resp.status != 200:
                print(f"エラー: API がステータス {resp.status} を返しました")
                return 0
            body = resp.read().decode("utf-8")
    except urllib.error.URLError as exc:
        print(f"エラー: {url} に到達できません: {exc.reason}")
        return 0

    try:
        records = json.loads(body)
    except json.JSONDecodeError as exc:
        print(f"エラー: API が不正な JSON を返しました: {exc.msg}")
        return 0

    if not isinstance(records, list) or not records:
        print("エラー: API から空でない JSON 配列を期待しています")
        return 0

    with open(output_path, "w", newline="", encoding="utf-8") as cf:
        writer = csv.DictWriter(cf, fieldnames=records[0].keys())
        writer.writeheader()
        writer.writerows(records)

    return len(records)

rows = api_response_to_csv(
    "https://api.internal.example.com/v2/deployments?status=completed",
    "completed_deployments.csv",
)
print(f"{rows} 件のデプロイメントを CSV にエクスポートしました")

# Python ワンライナー: stdin から JSON を読み込み、stdout に CSV を書き込む
cat orders.json | python3 -c "
import json, csv, sys
data = json.load(sys.stdin)
w = csv.DictWriter(sys.stdout, fieldnames=data[0].keys())
w.writeheader()
w.writerows(data)
"

# 出力をファイルに保存
cat orders.json | python3 -c "
import json, csv, sys
data = json.load(sys.stdin)
w = csv.DictWriter(sys.stdout, fieldnames=data[0].keys())
w.writeheader()
w.writerows(data)
" > orders.csv

# json2csv.py として保存して実行: python3 json2csv.py input.json -o output.csv
python3 -c "
import json, csv, argparse, sys

parser = argparse.ArgumentParser(description='JSON 配列を CSV に変換する')
parser.add_argument('input', help='JSON ファイルのパス')
parser.add_argument('-o', '--output', default=None, help='出力 CSV パス（デフォルト: stdout）')
parser.add_argument('-d', '--delimiter', default=',', help='CSV デリミタ')
args = parser.parse_args()

with open(args.input) as f:
    data = json.load(f)

out = open(args.output, 'w', newline='') if args.output else sys.stdout
writer = csv.DictWriter(out, fieldnames=data[0].keys(), delimiter=args.delimiter)
writer.writeheader()
writer.writerows(data)
if args.output:
    out.close()
    print(f'{len(data)} 行を {args.output} に書き込みました', file=sys.stderr)
" "$@"

# csvkit のインストール: pip install csvkit

# jq でフィールドを選択・整形し、in2csv が CSV フォーマットを処理する
cat api_response.json | jq '[.[] | {id: .order_id, customer: .customer.name, total}]' | in2csv -f json > orders.csv

# Miller (mlr) も JSON から CSV への別の選択肢
mlr --json2csv cat orders.json > orders.csv

pip install pyarrow

import pandas as pd

# pyarrow エンジンで JSON を読み込む（大きなファイルの高速パース）
df = pd.read_json("sensor_readings.json", engine="pyarrow")

# to_csv にはエンジンパラメータがないが、読み込みと書き込みの間の
# DataFrame 操作は pyarrow の列指向レイアウトから恩恵を受ける
df.to_csv("sensor_readings.csv", index=False)

# 本当に大きなエクスポートには、CSV の代わりに Parquet への書き込みを検討する
# — バイナリフォーマット、5〜10倍小さく、型を保持する
df.to_parquet("sensor_readings.parquet", engine="pyarrow")

pip install rich

import json
from rich.console import Console
from rich.table import Table

json_string = """
[
  {"hostname": "web-prod-1", "cpu_percent": 72.3, "memory_mb": 3840, "uptime_hours": 720},
  {"hostname": "web-prod-2", "cpu_percent": 45.1, "memory_mb": 2560, "uptime_hours": 168},
  {"hostname": "db-replica-1", "cpu_percent": 91.7, "memory_mb": 7680, "uptime_hours": 2160}
]
"""

records = json.loads(json_string)
console = Console()

table = Table(title="サーバーメトリクスのプレビュー", show_lines=True)
for key in records[0]:
    table.add_column(key, style="cyan" if key == "hostname" else "white")

for row in records:
    table.add_row(*[str(v) for v in row.values()])

console.print(table)
# ターミナルに罫線付きのカラーハイライトテーブルを描画する

pip install ijson

import ijson
import csv

def stream_json_to_csv(json_path: str, csv_path: str) -> int:
    """大きな JSON 配列をすべてメモリに読み込まずに CSV に変換する。"""
    with open(json_path, "rb") as jf, open(csv_path, "w", newline="", encoding="utf-8") as cf:
        # ijson.items はトップレベル配列の各要素を1つずつ yield する
        records = ijson.items(jf, "item")

        first_record = next(records)
        fieldnames = list(first_record.keys())

        writer = csv.DictWriter(cf, fieldnames=fieldnames)
        writer.writeheader()
        writer.writerow(first_record)

        count = 1
        for record in records:
            writer.writerow(record)
            count += 1

    return count

rows = stream_json_to_csv("clickstream_2026_03.json", "clickstream_2026_03.csv")
print(f"{rows} レコードを CSV にストリーミングしました")

import json
import csv

def ndjson_to_csv(ndjson_path: str, csv_path: str) -> int:
    """改行区切り JSON ファイルを1行ずつ CSV に変換する。"""
    with open(ndjson_path, encoding="utf-8") as nf:
        first_line = nf.readline()
        first_record = json.loads(first_line)
        fieldnames = list(first_record.keys())

        with open(csv_path, "w", newline="", encoding="utf-8") as cf:
            writer = csv.DictWriter(cf, fieldnames=fieldnames)
            writer.writeheader()
            writer.writerow(first_record)

            count = 1
            for line in nf:
                line = line.strip()
                if not line:
                    continue
                try:
                    record = json.loads(line)
                    writer.writerow(record)
                    count += 1
                except json.JSONDecodeError:
                    continue  # 不正な行はスキップ

    return count

rows = ndjson_to_csv("access_log.ndjson", "access_log.csv")
print(f"{rows} 件のログエントリを CSV に変換しました")