データフォーマットチートシート：JSON、XML、YAML、CSV、TOML

2026年3月31日 · 12分で読めます

データフォーマットを理解する

データフォーマットは現代技術の基盤であり、システム、アプリケーション、サービスが効果的に通信できるようにする普遍的な言語として機能します。Webアプリケーションの構築、サーバーの設定、ビジネスデータの分析など、適切なフォーマットを選択することで、スムーズなワークフローと保守の悪夢の違いが生まれます。

各データフォーマットは特定の使用例を念頭に設計されており、その強みを理解することで情報に基づいた決定を下すことができます。JSONはWeb APIを支配し、XMLはエンタープライズシステムを動かし、YAMLは設定管理を簡素化し、CSVは表形式データの定番であり続け、TOMLは現代のアプリケーションに人間に優しい設定ファイルをもたらします。

これらのフォーマット間の主な違いは、構文、可読性、解析の複雑さ、エコシステムのサポートにあります。機械効率を優先するものもあれば、人間の可読性に焦点を当てるものもあります。複雑なネストされた構造をサポートするものもあれば、フラットな表形式データの表現に優れているものもあります。

JSON：遍在するデータフォーマット

JSON（JavaScript Object Notation）は、Web上のデータ交換の事実上の標準となっています。軽量な構文、JavaScriptのネイティブサポート、言語に依存しない性質により、REST API、設定ファイル、MongoDBなどのNoSQLデータベースでのデータストレージの第一選択肢となっています。

このフォーマットは、ネストされたオブジェクトと配列をサポートするシンプルなキーと値の構造を使用します。人間が読みやすく、機械が解析可能であり、優れたバランスを保っているため、事実上すべてのプログラミング言語とプラットフォームで広く採用されています。

実用例と使用法

{
  "user": {
    "id": 12345,
    "name": "John Doe",
    "email": "[email protected]",
    "preferences": {
      "theme": "dark",
      "notifications": true
    }
  },
  "roles": ["admin", "user", "moderator"],
  "active": true,
  "lastLogin": "2026-03-31T10:30:00Z"
}

JSONはいくつかの一般的なシナリオで優れています：

• RESTful API：ほぼすべての現代のWeb APIがリクエストとレスポンスのペイロードにJSONを使用
• AJAX操作：ページのリロードなしでデータを動的に取得および更新
• 設定ファイル：npmなどのパッケージマネージャーがプロジェクト設定にpackage.jsonを使用
• NoSQLデータベース：MongoDBはJSON風のフォーマット（BSON）でドキュメントを保存
• データ交換：異なるプログラミング言語とシステム間でデータを移動

JSONの強みと制限

強み：

• 最小限の構文オーバーヘッドで非常に軽量
• JavaScriptでのネイティブサポートと、すべての主要言語での優れたライブラリサポート
• 高速な解析とシリアル化のパフォーマンス
• 検証、フォーマット、変換のための広範なツールエコシステム
• コンパクトでありながら人間が読みやすい

制限：

• コメントのサポートなし（一部のパーサーは拡張として許可）
• 限られたデータ型（ネイティブの日付、バイナリ、未定義型なし）
• 厳格な構文要件（末尾のカンマはエラーを引き起こす）
• 組み込みのスキーマ検証なし（JSON Schemaなどの外部ツールが必要）

XML：詳細で構造化された通信

XML（eXtensible Markup Language）は、何十年もの間、エンタープライズデータ交換の基盤となってきました。JSONと比較すると冗長に見えるかもしれませんが、XMLの豊富な機能セット（名前空間、スキーマ、変換機能を含む）は、複雑なドキュメント指向アプリケーションに不可欠です。

XMLは、厳格な検証、複雑な階層構造、混合コンテンツ（埋め込みマークアップを含むテキスト）を必要とするシナリオで輝きます。金融、医療、政府などの業界では、規制遵守と標準化されたデータ交換のためにXMLを義務付けることがよくあります。

実用例と使用法

<?xml version="1.0" encoding="UTF-8"?>
<user id="12345">
  <name>John Doe</name>
  <email>[email protected]</email>
  <preferences>
    <theme>dark</theme>
    <notifications enabled="true"/>
  </preferences>
  <roles>
    <role>admin</role>
    <role>user</role>
    <role>moderator</role>
  </roles>
  <active>true</active>
  <lastLogin>2026-03-31T10:30:00Z</lastLogin>
</user>

一般的なXMLの使用例には以下が含まれます：

• SOAP Webサービス：正式な契約とWS-*標準を必要とするエンタープライズAPI
• 設定ファイル：Mavenのpom.xml、SpringのapplicationContext.xml
• ドキュメントフォーマット：Microsoft Officeファイル（.docx、.xlsx）はXMLを含むZIPアーカイブ
• RSS/Atomフィード：ブログやニュースサイトのシンジケーションフォーマット
• SVGグラフィックス：スケーラブルベクターグラフィックスはXMLを使用して図形とスタイルを定義
• データ交換標準：医療のHL7、金融デリバティブのFpML

XMLの強みと制限

強み：

• XSD（XML Schema Definition）による強力なスキーマ検証
• 名前の競合を避けるための名前空間のサポート
• XSLTによる豊富な変換機能
• 混合コンテンツ（埋め込みマークアップを含むテキスト）に優れている
• 属性と要素が柔軟なデータモデリングを提供
• 成熟したツールと広範なエンタープライズ採用

制限：

• 冗長な構文によりファイルサイズと解析オーバーヘッドが増加
• JSONやYAMLと比較して書き込みと読み取りがより複雑
• 複雑さのため解析パフォーマンスが遅い
• 高度な機能の学習曲線が急
• 現代のWeb開発での人気が低下

YAML：簡単になった設定

YAML（YAML Ain't Markup Language）は、人間の可読性を最優先に設計されました。そのクリーンなインデントベースの構文により、DevOpsツール、CI/CDパイプライン、現代のアプリケーションフレームワークの設定ファイルとして好まれる選択肢となっています。

JSONの厳格な構文とは異なり、YAMLはコメントを許可し、単一ファイル内の複数のドキュメントをサポートし、括弧や中括弧の代わりに空白を構造に使用します。これにより、特に複雑な設定の場合、YAMLファイルの作成と保守が容易になります。

実用例と使用法

user:
  id: 12345
  name: John Doe
  email: [email protected]
  preferences:
    theme: dark
    notifications: true
  roles:
    - admin
    - user
    - moderator
  active: true
  lastLogin: 2026-03-31T10:30:00Z

# データベース設定
database:
  host: localhost
  port: 5432
  credentials:
    username: dbuser
    password: !secret db_password

YAMLは以下の標準的な選択肢です：

• Docker Compose：docker-compose.ymlでマルチコンテナアプリケーションを定義
• Kubernetes：クラスターリソース、デプロイメント、サービスを宣言
• CI/CDパイプライン：GitHub Actions、GitLab CI、CircleCI設定
• Ansibleプレイブック：インフラストラクチャの自動化と設定管理
• アプリケーション設定：Spring Bootのapplication.yml、Ruby on Rails設定
• OpenAPI仕様：Swagger/OpenAPIでREST APIを文書化

YAMLの強みと制限

強み：

• 最小限の構文ノイズで優れた人間の可読性
• コメントのネイティブサポート（JSONとは異なる）
• 再利用性のためのアンカーとエイリアスを含む複雑なデータ型をサポート
• ---で区切られた単一ファイル内の複数のドキュメント
• 複数行文字列などの機能でJSONよりも表現力豊か
• JSONのスーパーセット（有効なJSONは有効なYAML）

制限：

• 空白の感度が微妙なエラーにつながる可能性
• タブ対スペースの問題（スペースのみが許可される）
• JSONよりも複雑な解析
• 安全でない読み込みによるセキュリティ上の懸念（任意のコードを実行できる）
• 異なるパーサー間での実装の不一致
• インデント要件のためプログラムで生成するのが難しい

CSV：簡単なデータ管理

CSV（Comma-Separated Values）は、表形式データの最もシンプルで普遍的なフォーマットです。そのわかりやすい構造（カンマで区切られた値のデータ行）により、データベース、スプレッドシート、データ分析ツール間の橋渡しとなっています。

その