JSON → CSV

JSON → CSVとは

JSON → CSVは構造化されたJSONデータを、表形式で閲覧・処理しやすいCSVファイルに変換する機能です。APIレスポンス、設定データ、JSON配列などを表形式に整理する場合に適しており、変換前にデータソース、フィールド、ネストされたデータの処理方法を選択できます。

JSON → CSVで対応するデータ構造

最も一般的な入力は、複数のオブジェクトからなるJSON配列です。たとえば[{\"name\":\"Tom\",\"age\":18},{\"name\":\"Jack\",\"age\":20}]のようなデータです。各オブジェクトを1行に変換し、オブジェクトのフィールドをCSVの列に変換します。

JSONの外側がオブジェクトの場合も、データ構造に応じてトップレベルのデータを選択したり、JSONPathで実際に変換する配列を指定したりできます。たとえば$.data.listを指定すれば、APIでよく使われる{\"data\":{\"list\":[...]}}のような構造から直接リストを抽出できます。

3つのデータソース指定方法

自動認識では入力JSONの構造から適切なデータソースを選択します。トップレベルデータではJSONの最上位にあるオブジェクトや配列を直接変換します。JSONPathでは$.data.listのように変換対象の位置を手動で指定できます。JSONファイルに複数のフィールドがあり、その中の特定の配列だけをエクスポートしたい場合は、JSONPath方式が便利です。

JSONフィールドをどう処理するか

フィールドは自動モードまたは完全フィールドモードで処理できます。自動モードでは実際のデータからCSVに適した列を生成し、完全フィールドモードでは変換対象の範囲に登場するフィールドを保持します。オブジェクトごとにフィールドが異なる場合、フィールド処理方法によって最終的なCSVのヘッダーと空欄の位置が変わります。

ネストされたオブジェクトをCSVに変換する方法

JSONのネストされたオブジェクトは、そのまま通常の表形式の列として扱えないため、2つの処理方法を用意しています。JSONとして保持すると、ネストされたオブジェクトを1つのJSON値としてセルに書き込みます。列に展開すると、ネストされたフィールドを独立した列に変換でき、表計算ソフトやデータ分析ツールでの後処理に適しています。

たとえば{\"user\":{\"name\":\"Tom\",\"age\":18}}のuserオブジェクトは、1つのJSONセルとして保持することも、user.name、user.ageのようなフィールドに展開することもできます。

配列をCSVに変換する方法

配列はJSON文字列としてセルに保持することも、行単位で展開することもできます。JSONとして保持する方法は元の構造を維持したい場合に適しており、行単位で展開する方法は配列自体が1件ずつ処理したいデータを表している場合に適しています。どちらを選ぶかは、後続処理でJSON構造を保持したいか、表形式で配列要素を1行ずつ確認したいかによって決まります。

ローカルJSONファイルをCSVに変換する方法

ファイルアップロードタブに切り替え、.jsonファイルをページにドラッグするか、ファイル選択から指定できます。ファイルはブラウザ内で直接読み込まれ、1ファイルあたりの上限は10 MBです。ファイル読み込み後、データソース、フィールド、ネストされたオブジェクト、配列の処理方法を選択してから変換できます。

JSON → CSV変換後の使い方

変換が完了すると、CSVのプレビューと完全なテキスト結果が表示され、直接コピーまたはCSVファイルとしてダウンロードできます。生成したCSVはExcel、表計算ソフト、データベースインポートツール、その他のデータ処理プログラムで開いて利用できます。

JSON → CSVでよくある問題

変換結果が空の場合は、まずJSON自体が有効か確認し、データソースが実際にレコードを含む配列を指しているか確認してください。JSONデータがネストされたオブジェクト内にある場合は、$.data.listのようなJSONPathを試してください。生成された列が期待どおりでない場合は、ネストされたオブジェクトと配列の処理方法、および入力オブジェクト間でフィールドが一致しているかを確認してください。

このツールの処理方式

JSONの解析、フィールド整理、ネストされたデータの処理、CSV生成はすべてブラウザ内で行われ、入力内容はサーバーにアップロードされません。第三者サービスに送信したくないAPIデータ、設定ファイル、ローカルJSONファイルなどの処理に適しています。