JSON から CSV への変換とオンライン表へのインポートの違いを一言で言えば、JSON から CSV への変換はネストされたキーと値の構造を「平坦化」して二次元の表にするのに対し、オンライン表へのインポートは既存の表ファイルをブラウザに読み込むだけで、構造変換は行いません。前者はデータ構造の不一致を解決し、後者はデータの移動を解決します。この境界線を理解すれば、どちらの機能を使うべきかが分かり、JSON をインポートする際に何度もエラーが出ることもなくなります。
両者が実際に何をしているか
まず二つの概念を明確にします。JSON は波括弧と角括弧でデータを整理するテキスト形式で、フィールドは何層にもネストできます。CSV はカンマで区切られたプレーンテキストの表で、行と列しかなく、階層はありません。
JSON から CSV への変換 の動作は変換です。JSON を読み込み、ネスト階層を列名に展開し、平坦な表を出力します。オンライン表へのインポート の動作は読み取りです。すでに CSV、TSV、または類似の表ファイルがあり、ツールはそれを解析して表示またはプレビューするだけです。
一方は構造を変え、もう一方は構造を変えません。これが核心的な違いです。
- 入力が異なる：前者は JSON を入力し、後者は表ファイルを入力する
- 出力が異なる：前者は新しい CSV を生成し、後者は通常表示のみを行う
- 難点が異なる：前者はネストされたフィールドをどう平坦化するかが難しく、後者はエンコーディングと区切り文字の認識が難しい
- 失敗の現れ方が異なる：前者はフィールドの欠落や列名の重複がよく起こり、後者は文字化けや列ずれがよく起こる
JSON から CSV への変換と表インポートの違い：三つの判断基準
自分がどちらの道を取るべきか知るには、三点を見れば十分です。
第一に、元データが JSON かどうか。 API から取得したレスポンス内容で、波括弧や角括弧が含まれているなら変換の場面です。ファイルをダブルクリックして開くと整った行と列ならインポートの場面です。
第二に、階層情報を保持したいかどうか。 表インポートは階層を自然に扱いません。表ファイルにはそもそも階層がないからです。JSON から CSV への変換では、必ず一度取捨選択が必要です。ネストされたオブジェクトを複数列に展開するか、それともテキストとしてシリアライズしてセルに詰め込むかです。
第三に、下流が何を求めているか。 下流が表計算ソフトで開けるファイルを求めているなら変換です。下流がブラウザで内容をちらっと見たいだけならインポートで十分です。
JSON から CSV への変換と表インポートの違いを理解する鍵は、「ファイルを読むこと」と「構造を変えること」を一つのこととして混同しないことです。多くのエラーは間違った入口を使うことから生じます。
JSON から CSV への変換方法：ステップごとの操作
以下は汎用的な流れで、ブラウザ上でローカルに動作するツールに適用でき、データはサーバーにアップロードされません。
- データを準備します。JSON を配列形式、つまり最外層が
[ {...}, {...} ]になるように整理します。最外層が単一のオブジェクトなら、まず手動で配列に包みます。 - フィールド集合を確認します。各オブジェクトが同じキーを持っているか確認します。キーが一致しない場合、欠落したキーは対応する行で空になります。
- 区切り文字を選択します。デフォルトのカンマで問題ありません。フィールド内容自体に大量のカンマが含まれる場合は、セミコロンやタブに変更します。
- ヘッダーオプションをチェックします。有効にすると最初の行にキー名が書き込まれ、後で表計算ソフトでフィルタリングしやすくなります。
- ネストを処理します。ネストされたオブジェクトに対して、複数列への展開を選ぶか、ドットで連結して
親.子形式の列名にします。 - 変換を実行し、先頭行を確認します。列数が期待通りか、末尾に余分な空列がないかを重点的に見ます。
- 結果をダウンロードします。問題ないことを確認してから保存し、何度も上書きするのを避けます。
この流れをブラウザで直接行いたい場合は、JSON から CSV への変換ツール を開いて試してみてください。
JSON から CSV への変換で中国語が文字化けする場合の解決方法
中国語の文字化けはほとんどがエンコーディング段階で発生し、変換ロジックの問題ではありません。
よくある原因は、出力ファイルがバイト順マークなしの UTF-8 で書き出され、一部の表計算ソフトが開く際にデフォルトでローカルエンコーディングとして解析するため、中国語が疑問符や四角になることです。解決策は二つあります。一つはエクスポート時にバイト順マーク付きの UTF-8 を選ぶこと。もう一つは先に表計算ソフトを開き、「テキストからインポート」で手動で UTF-8 エンコーディングを指定することです。
もう一つのケースは、元の JSON 自体が文字化けしている場合で、データが転送または保存の段階で既に破損しており、変換ツールでは復元できません。JSON から CSV への変換で中国語が文字化けする場合は、まず元ファイルが正常か確認し、次にエクスポートエンコーディングを確認してください。
JSON から CSV への変換で大きなファイルが固まる場合の対処法
大きなファイルが固まる根本原因は通常、ブラウザのシングルスレッド解析とメモリ使用量の高さです。
順番に試せます。まずメモリを消費している他のタブを閉じます。次に元ファイルをレコード数ごとにいくつかの小さなファイルに分割して分割変換します。そしてリアルタイムプレビューをオフにし、最終エクスポートのみを残します。毎回数万件を処理すると明らかに遅くなるなら、分割する方がより確実な方法です。
注意すべきは、ブラウザでローカルに動作するということは処理能力があなたのデバイスに制限されるということで、超大ファイルはコマンドラインツールで処理する方が適しています。JSON から CSV への変換で大きなファイルが固まる時は、ページを何度も更新して再試行しないでください。それではメモリ使用量がさらに高くなるだけです。
スマホで JSON から CSV への変換はできるか
できますが、操作方法はデスクトップとは異なります。
スマホのブラウザのファイル選択は通常、ローカルファイルとダウンロードディレクトリを読み取れ、変換自体はページ内で完了し、ネットワークに依存しません。制限されるのは画面スペースです。幅の広い表では列名が全部見えず、ネスト構造を展開すると行を間違えやすくなります。スマホでは変換とダウンロードだけを行い、列構造の確認はパソコンで行うことをお勧めします。
スマホで JSON から CSV への変換を行う際は、レスポンシブレイアウトのツールページを優先し、変換中にアプリを切り替えないようにしてください。一部のシステムではそれによりページが回収されます。
API デバッグでの JSON から CSV への変換の用途
API をデバッグする時、レスポンスボディは多くの場合、大きなネストされた JSON で、フィールドの分布や空値の割合を肉眼で見るのは困難です。
それを CSV に変換すれば、表で直接並べ替え、フィルタリング、集計ができ、あるフィールドがすべて空かどうか、あるレコードにフィールドが欠けているかどうかを素早く発見できます。これが API デバッグでの JSON から CSV への変換の最も一般的な用途です。
操作としては、レスポンス内容をコピーしてツールに貼り付けるだけで、先にファイルとして保存する必要はありません。API が返すのがページングデータの可能性があることに注意し、変換前に完全なデータセットを取得しているか確認してください。
よくある質問
JSON から CSV への変換でデータは失われますか
失われますが、通常は規則的な欠落です。ネスト階層が平坦化されると、深い構造はセルにシリアライズするしかありません。配列の長さが一致しない場合、短い行は空で埋められます。変換前にどのフィールドを必ず保持するか確認してください。
変換後の列の順序はカスタマイズできますか
多くのツールは最初に出現したキーの順序で列を生成します。順序を固定したい場合は、元の JSON でキーの並びを統一するか、変換後に表計算ソフトで列順を調整します。
一度に何件のレコードを処理できますか
統一された上限はなく、あなたのデバイスのメモリとブラウザの実装に依存します。数千から数万件は通常可能で、それ以上は分割をお勧めします。
データはサーバーにアップロードされますか
ツールの実装に依存します。ブラウザでローカルに動作するツールはページ内で解析とエクスポートを完了し、データはデバイスから出ません。使用前にページに明確な説明があるか確認してください。
配列フィールドはどうなりますか
通常はテキストとしてシリアライズされてセルに入るか、インデックスごとに複数列に展開されます。どちらにも利点と欠点があり、下流の要件に応じて選択します。
まとめ
最初の問いに戻ります。JSON から CSV への変換とオンライン表へのインポートの違いは、前者は構造変換を行い、後者はファイル読み取りのみを行うことです。入口を間違えると「インポートは成功したがフィールドが全部おかしい」という状況になります。判断方法は簡単で、元データが JSON かどうか、下流が平坦な表を必要とするかどうかを見ます。JSON から CSV への変換と表インポートの違いをはっきり理解し、さらに オンラインツール一覧 の他の変換機能を組み合わせれば、ほとんどのデータ整理作業はブラウザで完了できます。