CSVからJSONへのオンラインツールの使い方は？3ステップで完了する変換とよくある質問
CSVからJSONへのオンラインツールの使い方は簡単です。CSVテキストをツールページに貼り付けるかアップロードし、区切り文字と先頭行がヘッダーかどうかを確認し、変換をクリックしてJSON結果をコピーまたはダウンロードします。処理はすべてブラウザ上でローカルに完結し、ファイルがサーバーにアップロードされることはありません。ソフトのインストールもコードの記述も不要で、以下の3ステップに従うだけです。
この記事では、CSVからJSONへの変換とは何か、変換時にフィールド型をどう扱うか、大きなファイルやスマートフォンでの注意点を説明します。すぐに結果を得たい場合は、最初のセクションの3ステップをご覧ください。
3ステップで完了するCSVからJSONへの変換
ステップ1：CSVデータを準備してインポートする
CSVはカンマで区切られたプレーンテキストの表で、通常は最初の行が列名で、以降の各行が1件のレコードです。インポート前に3点を確認してください。
- ファイルの文字コードはUTF-8を推奨します。中国語が文字化けするのを防ぎます。
- 先頭行が列名かデータかによって、「先頭行をヘッダーとする」にチェックを入れるかが決まります。
- 区切り文字がカンマ、セミコロン、タブのどれかを確認します。間違えると行全体が1つのフィールドに詰め込まれます。
テキストを直接貼り付けることも、ローカルファイルを選択することもできます。ツールはブラウザ上でローカルに読み取るため、貼り付けとアップロードのどちらもデータをネットワーク経由で送信する必要はありません。
ステップ2：変換オプションを設定する
このステップで出力されるJSONの形が決まります。一般的なオプションは3つあります。
- 配列かオブジェクトか：配列は
[{...},{...}]を出力し、APIが返すリストに適しています。先頭列をキーとしてオブジェクトを出力すると、IDによる高速検索に適しています。 - 型推論：有効にすると
123は数値になり、trueはブール値になり、空値はnullになります。無効にするとすべて文字列として保持されます。 - ネストされたフィールド：列名を
user.nameのようなドット付き形式にすると、ネスト構造を生成できます。
型推論は慎重に扱ってください。注文番号、郵便番号、0で始まる番号などは、数値として扱われると先頭のゼロが失われます。このようなフィールドは文字列のままにすることをお勧めします。
ステップ3：プレビューしてJSONをエクスポートする
変換結果は出力ボックスにリアルタイムで表示されます。まず最初の数件のレコードを確認し、フィールド名、階層、型が正しいことを確かめてから、コピーまたは.jsonファイルをダウンロードします。結果が正しくない場合は、ほとんどが区切り文字かヘッダー設定の問題です。元に戻して再変換すればよく、副作用はありません。
エクスポートしたJSONは、コードに貼り付けてテストデータとしてそのまま使えますし、静的データファイルとしてデプロイすることもできます。
CSVからJSONへの変換とは
CSVからJSONへの変換とは何か？一言で説明すると、行と列で構成された二次元表のテキストを、波括弧と角括弧で階層関係を記述するJSONデータに書き換えることです。CSVは人間が読み、表計算ソフトが処理するのに適しており、JSONはプログラムが読み取るのに適しています。両者は同じデータを記述しています。
この変換を理解する鍵はマッピング関係にあります。CSVの各行はJSON配列内の1つのオブジェクトに対応し、CSVの各列名はオブジェクト内の1つのキーに対応し、セルの内容はキーの値に対応します。つまり、CSVからJSONへの変換は本質的に構造の再編成であり、内容の書き換えではありません。
構造の再編成であるからこそ、変換前にCSV自体が整っていることを保証する必要があります。列数が一致している、余分な空行がない、引用符が対になっていることです。元データに問題があれば、変換結果にも必ず問題があります。
CSVからJSONへの変換とJSONからCSVへの変換の違い
CSVからJSONへの変換とJSONからCSVへの変換の違いは、情報密度の方向性が異なる点にあります。前者はフラットな表を階層を持つ構造に昇格させ、後者はネスト構造を二次元表に平坦化します。
JSON方向へ変換する場合、ネスト階層を自由に増やせ、1つのオブジェクト内に配列を入れることも問題なく、表現力が高いです。CSV方向へ変換する場合、ネストされた配列やオブジェクトはまず平坦化する必要があり、そうしないと1つのセルに文字列として詰め込むしかなく、後で解析するのが難しくなります。
実務ではこの2つの方向はしばしばペアで現れます。まずCSVからJSONへ変換して表データをプログラムに渡し、プログラムが処理した後にCSVへ戻して業務担当者に見せます。どちらの方向を選ぶかは、次にこのデータを誰が消費するかによって決まります。
CSVからJSONへの大きなファイル変換が失敗した場合
CSVからJSONへの大きなファイル変換が失敗する最も一般的な原因は、ブラウザのメモリが一杯になることです。次に、一度にレンダリングするデータ量が多すぎてページがフリーズすることが挙げられます。これは変換ロジックの誤りではなく、ブラウザという実行環境自体に上限があるためです。
以下の順序で確認できます。
- まずファイルサイズを確認します。数十万行以上のCSVは、純粋なフロントエンド処理では上限に達しやすいです。
- ファイルを分割します。行数ごとにいくつかの小さなファイルに切り、個別に変換してから結果を統合します。
- リアルタイムプレビューをオフにし、変換とダウンロードのみを行い、レンダリング負荷を減らします。
- 非常に長いセルや異常な文字がないか確認します。それらは解析を遅くします。
- 超大容量ファイルにはデスクトップスクリプトの使用に切り替えます。ブラウザはこの規模向けに設計されていません。
なお、ローカルで動作するオンラインツールはプライバシー面でより安全ですが、ブラウザの制約を受け、処理能力は無限ではありません。CSVからJSONへの大きなファイル変換が失敗した場合は、まず分割してから変換するのが通常最も効果的です。
スマートフォンでCSVからJSONへ変換する方法
スマートフォンでもCSVからJSONへの変換は十分可能です。考え方はパソコンと同じです。スマートフォンのブラウザでツールページを開き、CSVテキストを貼り付けるかファイルマネージャーからファイルを選択し、オプションを設定して結果をコピーします。
スマートフォンには事前に知っておくべき2つの実際的な制限があります。1つは画面が小さいため、長いJSONを行ごとに確認するのが難しいことです。変換だけ行い、別の場所にコピーしてから確認することをお勧めします。もう1つは、一部のスマートフォンブラウザではローカルファイルの読み取りサポートが一貫していないことです。ファイル選択が反応しない場合は、テキスト貼り付け方式に切り替えてください。
また、スマートフォンはパソコンよりメモリが厳しく、大きなファイルはスマートフォンで失敗しやすいです。スマートフォンでのCSVからJSONへの変換は、数百行以内の小さなファイルの処理に適しており、大量のタスクはパソコンに任せましょう。
APIデバッグ時にCSVからJSONへの変換をどう使うか
APIデバッグでCSVからJSONへの変換が典型的に使われる場面は、APIがJSONリクエストボディを必要とし、手元のテストデータが表から来ている場合です。手でJSONを打つのは遅く、カンマの抜けも起きやすいため、変換ツールで生成する方がはるかに信頼できます。
方法は、テストケースをCSVに整理し、列名をAPIのフィールド名にし、変換後に配列形式のリクエストボディを直接得るというものです。大量のデータを作成する場合は、表で数十行をコピーしてから変換すれば、手書きよりずっと速いです。
デバッグ時には2点に注意してください。APIがフィールド型に敏感な場合は、型推論をオフにし、すべて文字列として出力してから手動で調整します。フィールド名にネスト階層がある場合は、ドット付きの列名でネスト構造を生成します。こうして得られたJSONはデバッグツールに直接貼り付けられ、形式を何度も修正する時間を省けます。
よくある質問
変換後に中国語が文字化けしたらどうすればよいですか
まずCSVファイル自体の文字コードがUTF-8であることを確認してください。多くの表計算ソフトはデフォルトでローカル文字コードをエクスポートするため、中国語が異常表示されます。テキストエディタでUTF-8として保存し直してから変換すれば、通常は解決します。
数字の前の0が消えたらどうすればよいですか
これは型推論が番号を数値と見なしたためです。型推論をオフにし、すべての値を文字列のままにすれば、先頭のゼロが保持されます。注文番号、社員番号、郵便番号などのフィールドはこのように処理することをお勧めします。
変換結果に空のオブジェクトが1つ余分にあります
ほとんどはCSVの末尾に空行があるためです。末尾の余分な空行を削除してから変換すれば、配列に空のオブジェクトは現れません。列数が一致しない行も同様の問題を引き起こすので、各行のカンマの数を確認してください。
データはサーバーにアップロードされますか
ブラウザ上でローカルに動作するツールはデータをアップロードしません。解析と変換はすべてあなたのデバイス上で完結します。これが機密性の高いテストデータを扱う際にローカルツールを優先する理由です。
一度に何行変換できますか
統一された基準はなく、あなたのデバイスとブラウザによります。数万行以内なら通常は比較的スムーズです。それより大きなファイルは分割処理をお勧めします。具体的な上限はデバイスのメモリとブラウザの実装に関係し、実際にはあなたのテスト結果に基づきます。
まとめ
CSVからJSONへのオンラインツールの使い方は、3ステップを覚えれば十分です。データをインポートし、オプションを設定し、プレビューしてエクスポートします。変換自体は複雑ではありません。結果に本当に影響するのは、区切り文字、ヘッダー、型推論といった設定項目です。大きなファイルで失敗したら分割し、スマートフォンでは小さなファイルを処理すればよく、APIデバッグ時にはリクエストボディを一括生成するのが最も手軽です。必要ならオンラインツール一覧を直接開き、CSVからJSONへのツールを見つけて操作を始めてください。