JSON to CSV: JSONデータをスプレッドシート形式に変換

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

JSONとCSV形式の理解

変換テクニックに入る前に、両方の形式についてしっかりと理解しましょう。JSON(JavaScript Object Notation)とCSV(Comma-Separated Values)は、データエコシステムにおいて異なる目的を果たしており、それぞれの強みを知ることで効果的に作業できます。

JSONは、人間が読みやすく、機械が解析可能な軽量なデータ交換形式です。複雑なデータ構造を自然に扱えるため、APIやWebサービスの事実上の標準となっています。JSONは、設定ファイルからAPIレスポンス、NoSQLデータベースまで、あらゆる場所で見られます。

典型的なJSON構造は次のようになります:

{
  "users": [
    {
      "id": 1,
      "name": "Sarah Chen",
      "email": "[email protected]",
      "role": "developer",
      "active": true
    },
    {
      "id": 2,
      "name": "Marcus Johnson",
      "email": "[email protected]",
      "role": "designer",
      "active": false
    }
  ]
}

一方、CSVはデータを表形式で表現します—スプレッドシートの行と列を考えてください。各行がレコードで、カンマがそのレコード内のフィールドを区切ります。CSVファイルは、スプレッドシートアプリケーション、データベース、データ分析ツールと普遍的に互換性があります。

同じデータをCSV形式で表すと:

id,name,email,role,active
1,Sarah Chen,[email protected],developer,true
2,Marcus Johnson,[email protected],designer,false

これらの形式の主な違いは、実際に使用するときに明らかになります:

なぜJSONをCSVに変換するのか?

JSONをCSVに変換することは、単なる技術的な演習ではなく、実際のビジネス上の問題を解決します。いつ、なぜ変換するかを理解することで、データワークフローについてより良い決定を下すことができます。

データ分析と可視化

アナリストやデータサイエンティストは、ツールとシームレスに統合できるため、CSVを好むことが多いです。Excel、Googleスプレッドシート、Tableau、Rはすべて、CSVファイルをネイティブに処理します。APIからJSONデータを受け取っても、ピボットテーブル、チャート、統計分析を作成する必要がある場合、CSVがこれらの強力なツールへの橋渡しとなります。

例えば、eコマースAPIから販売データを取得する場合、JSONレスポンスには数百のトランザクションが含まれる可能性があります。CSVに変換することで、Excelに素早くインポートし、サマリーテーブルを作成し、ステークホルダー向けのプレゼンテーション用の可視化を生成できます。

データベースインポート操作

多くのリレーショナルデータベースは、CSVファイル用に最適化された一括インポート機能を提供しています。PostgreSQLのCOPYコマンド、MySQLのLOAD DATA INFILE、および他のデータベースの類似機能は、数百万のCSV行を数秒で処理できます。JSONインポートは可能ですが、より複雑な解析が必要で、速度が遅くなることがよくあります。

システム間でデータを移行する場合や、初期データベースのシーディングを実行する場合、CSV変換によってインポート時間を劇的に短縮できます。

シンプルさと互換性

CSVファイルは普遍的に理解されます。CSVファイルを誰にでもメールで送信でき、特別なソフトウェアなしで開くことができます。これにより、CSVは次のような用途に理想的です:

• 技術者でない関係者とデータを共有する
• 復元が簡単なデータバックアップを作成する
• 規制遵守のためのレポートを生成する
• 数十年間アクセス可能な形式でデータをアーカイブする

パフォーマンスとファイルサイズ

シンプルな構造の大規模データセットの場合、CSVファイルはJSON相当のものよりも大幅に小さくなります。フォーマット文字(括弧、引用符、コロン)の削減により、ファイルサイズが30〜50%小さくなる可能性があります。これは、ネットワーク経由でデータを転送する場合や、大規模なアーカイブを保存する場合に重要です。

レガシーシステムの統合

JSON時代以前に構築された多くのエンタープライズシステムは、依然としてCSV入力を期待しています。JSONをCSVに変換することで、大規模なシステムの書き換えなしに、最新のAPIをレガシーシステムと統合できます。これは、古いシステムが本番環境に残っている金融、医療、製造などの業界で特に一般的です。

シンプルな変換方法

プログラミングの知識を必要としない方法から始めて、JSONをCSVに変換する最も簡単な方法を探りましょう。

スプレッドシートアプリケーションの使用

ExcelとGoogleスプレッドシートの両方で、JSONデータを直接インポートできますが、いくつかの制限があります。この方法は、シンプルでフラットなJSON構造に最適です。

Microsoft Excelの場合:

1. Excelを開き、新しいワークブックを作成します
2. データ → データの取得 → ファイルから → JSONから に移動します
3. JSONファイルを選択します
4. Power Queryエディターを使用してデータを変換します
5. 「閉じて読み込む」をクリックしてインポートします
6. ファイル → 名前を付けて保存 → CSV(カンマ区切り)を使用してCSVとして保存します

Googleスプレッドシートの場合:

1. 新しいスプレッドシートを作成します
2. JSONがオンラインでホストされている場合は、IMPORTDATA()関数を使用します
3. またはJSONをセルに貼り付け、Apps Scriptを使用して解析します
4. ファイル → ダウンロード → カンマ区切り値を使用してCSVとしてダウンロードします

コマンドラインツール

ターミナルに慣れている開発者にとって、コマンドラインツールはコードを書かずに素早く変換できます。jqユーティリティは、JSON操作に特に強力です。

システムにjqをインストールします:

# macOS
brew install jq

# Ubuntu/Debian
sudo apt-get install jq

# Windows(Chocolateyを使用)
choco install jq

シンプルなJSON配列をCSVに変換します:

jq -r '.[] | [.id, .name, .email] | @csv' input.json > output.csv

このコマンドは、各JSONオブジェクトから特定のフィールドを抽出し、CSV行としてフォーマットします。-rフラグは、JSON引用符なしで生の文字列を出力し、@csvは適切なCSVエスケープを処理します。

オンライン変換ツールの使用

オンラインコンバーターは、何もインストールせずにJSONからCSVへの最速のパスを提供します。一度限りの変換や、ソフトウェアをインストールできないマシンで作業している場合に最適です。

探すべき機能

オンラインJSON to CSVコンバーターを選択する際は、これらの機能を優先してください:

• プライバシー: ツールがサーバーにアップロードするのではなく、クライアント側(ブラウザ内)でデータを処理することを確認してください
• サイズ制限: 最大ファイルサイズを確認してください—一部のツールは1MBに制限されていますが、他のツールは100MB以上を処理します
• ネストされたデータの処理: ネストされたオブジェクトと配列をフラット化できますか?
• カスタマイズ: 区切り文字の選択、ヘッダーの含有、フィールド選択のオプション
• プレビュー: ダウンロード前に結果をプレビューする機能

典型的なワークフロー

ほとんどのオンラインコンバーターは、このパターンに従います:

1. JSONテキストを貼り付けるか、JSONファイルをアップロードします
2. ツールがJSON構造を検証して解析します
3. 変換オプションを設定します(区切り文字、ヘッダー、フラット化)
4. CSV出力をプレビューします
5. 変換されたファイルをダウンロードします

プログラミングベースのソリューション

定期的に、または自動化されたワークフローの一部としてJSONをCSVに変換する必要がある場合、プログラミングソリューションは柔軟性と力を提供します。人気のある言語での実装を探りましょう。

Python実装

Pythonの組み込みライブラリにより、JSONからCSVへの変換が簡単になります。一般的なシナリオを処理する堅牢なソリューションは次のとおりです:

import json
import csv

def json_to_csv(json_file, csv_file):
    # JSONデータを読み込む
    with open(json_file, 'r') as f:
        data = json.load(f)
    
    # 単一オブジェクトとオブジェクトの配列の両方を処理
    if isinstance(data, dict):
        data = [data]
    
    # 最初のオブジェクトからヘッダーを抽出
    headers = data[0].keys()
    
    # CSVに書き込む
    with open(csv_file, 'w', newline='', encoding='utf-8') as f:
        writer = csv.DictWriter(f, fieldnames=headers)
        writer.writeheader()
        writer.writerows(data)

# 使用方法
json_to_csv('input.json', 'output.csv')

ネストされたデータを含むより複雑なシナリオの場合、pandasライブラリは強力なツールを提供します:

import pandas as pd

# JSONを読み込み、ネストされた構造を正規化
df = pd.read_json('input.json')

# 必要に応じてネストされた列をフラット化
df = pd.json_normalize(data)

# CSVにエクスポート
df.to_csv('output.csv', index=False)

JavaScript/Node.js実装

JavaScript開発者にとって、Node.jsはいくつかのアプローチを提供します。人気のあるjson2csvライブラリを使用したソリューションは次のとおりです:

const { parse } = require('json2csv');
const fs = require('fs');

// JSONファイルを読み込む
const jsonData = JSON.parse(fs.readFileSync('input.json', 'utf8'));

// CSVに変換
const csv = parse(jsonData);

// CSVファイルを書き込む
fs.writeFileSync('output.csv', csv);

外部ライブラリなしでカスタム制御する場合:

const fs = require('fs');

function jsonToCsv(jsonData) {
    const array = Array.isArray(jsonData) ? jsonData : [jsonData];
    const headers = Object.keys(array[0]);
    
    const csvRows = [
        headers.join(','),
        ...array.map(row => 
            headers.map(header => 
                JSON.stringify(row[header] ?? '')
            ).join(',')
        )
    ];
    
    return csvRows.join('\n');
}

const data = JSON.parse(fs.readFileSync('input.json', 'utf8'));
const csv = jsonToCsv(data);
fs.writeFileSync('output.csv', csv);

その他の言語ソリューション