3つのステップでJSONをCSVに変換
- JSONデータを追加します。オブジェクトまたは配列を貼り付けるか、サポートされている
.jsonファイルをアップロードします。 - 変換ルールを選択します。レコード配列、区切り文字、ヘッダーの動作、ネストされたデータのオプションを選択します。
- 確認してエクスポートします。テーブルのプレビューを確認し、CSVテキストをコピーするか、
.csvファイルをダウンロードします。
このツールが受け入れるJSON構造
オブジェクトの配列
オブジェクトの配列は、各オブジェクトが1行になるため、CSVの最も明確なソースです。
[
{"id": 1, "name": "Ada"},
{"id": 2, "name": "Lin"}
]キーが列になり、オブジェクトが行になります。
単一のオブジェクト
単一のフラットなオブジェクトは1つのCSV行になります。オブジェクトにレコードのネストされた配列が含まれている場合、ツールはその配列をレコードソースとして選択できます。
{
"results": [
{"id": 1, "status": "active"},
{"id": 2, "status": "paused"}
],
"count": 2
}resultsを選択すると2行が作成されます。ラッパー値countは3番目のレコードにはなりません。
異なるキーを持つオブジェクト
実際のJSON配列には、常に同一のオブジェクトが含まれているとは限りません。コンバーターは、選択したレコード全体でキーの和集合を構築します。
[
{"id": 1, "email": "[email protected]"},
{"id": 2, "phone": "555-0100"}
]CSVにはid、email、phoneの列が含まれ、レコードにそのキーがない場合は空の値になります。
ネストされたJSONのフラット化
ネストされたオブジェクトは、通常のCSV列に直接収めることはできません。このツールは、基本的なオブジェクトパスを列名にフラット化します。
{
"user": {
"name": "Ada",
"address": {
"city": "London"
}
}
}推奨される列:
user.name
user.address.cityオプションパネルには、ネストされたオブジェクトのフラット化のオン/オフ、パス区切り文字、最大フラット化深度、最大深度に達した後の動作が含まれます。
配列の書き方の選択
1つのCSVセルは繰り返される構造化レコードを自然に表現できないため、配列には意図的な出力ルールが必要です。
- プリミティブ値を結合:
["red","blue"]はred, blueになります。 - JSONのまま保持: 完全な配列テキストを引用符で囲まれた1つのセルに保持します。
- 空にする: 明示的なユーザー選択としてのみ利用可能で、黙ってデフォルトになることはありません。
CSV出力オプション
区切り文字
カンマ、セミコロン、タブ、パイプ、またはサポートされているカスタムの単一文字を選択します。選択した区切り文字は、ヘッダーとすべての行に一貫して適用されます。
ヘッダー行
デフォルトの出力には列名が含まれます。トグルでヘッダーを削除して、生の行のみを受け入れるシステムに対応できます。
引用符
区切り文字、引用符、または改行を含むCSV値は正しく引用符で囲まれます。引用符で囲まれたフィールド内のリテラル引用符はエスケープされます。
- 最小限の引用符
- すべてのフィールドを引用符で囲む
- 行末
- スプレッドシート互換性のために必要な場合にUTF-8 BOMを含める
空およびnull値
null、欠落キー、空文字列の表現方法を選択します: 空のセル、リテラルnull、またはカスタムプレースホルダー。プレビューでダウンロード前に違いを確認できます。
生成されたCSVのプレビュー
プレビューには、検出されたレコード数、生成された列数、選択されたレコードパス、一貫性のないオブジェクト形状やネストされた配列に関する警告、および最初にレンダリングされた行のテーブルビューが表示されます。引用符を検査する必要がある場合は、生のCSV出力も利用できます。
一般的なJSONからCSVへの問題
出力が1行のみ
選択したJSON値がレコード配列ではなく単一のオブジェクトである可能性があります。レコードを含むネストされた配列を選択してください。
ネストされたフィールドが欠落している
フラット化を有効にするか、「ネストされた値をJSONとして保持」を選択してください。ツールは、値が設定されたフラット化深度を超えた場合に警告します。
一部の行に空白のセルがある
JSONオブジェクトに異なるキーまたは欠落値が含まれています。CSVでは共有の列セットが必要なため、欠落値は空のセルまたは選択したプレースホルダーになります。
配列がExcelで読み取れない
配列戦略を変更してください。単純なタグの場合はプリミティブ値を結合し、構造が重要な場合は元の配列をコンパクトなJSONとして保持します。
アクセント文字が正しく表示されない
UTF-8互換の設定でダウンロードし、正しいエンコーディングでファイルを開いてください。BOMオプションが存在する場合、バイトプレフィックスのみが変更され、コンテンツは再エンコードされません。
JSONからCSVへのFAQ
このコンバーターはネストされたJSONを処理できますか？
はい、オプションパネルで実装されているフラット化動作に対応しています。ネストされたオブジェクトのキーはパスベースの列にできます。ネストされた配列には別の配列戦略が必要です。
CSVヘッダーはどのように作成されますか？
コンバーターは、選択したレコード全体で見つかったキーからヘッダーを構築します。レコードに異なるキーがある場合、それらのキーの和集合が完全なヘッダーセットになります。
JSON配列はどうなりますか？
プリミティブ配列は結合するか、JSONテキストとして保持できます。オブジェクトの配列は、使用できないテキストに結合されるのではなく、JSONとして保持されます。
数値とブール値は保持されますか？
それらのテキスト表現がCSVに書き込まれます。CSV自体はJSONタイプを保持しないため、ダウンストリームのソフトウェアが各セルの解釈方法を決定します。
JSONはアップロードされますか？
いいえ — 貼り付けたデータは完全にブラウザで処理されます。ブラウザの処理制限を超えるファイルはオプションのサーバーフォールバックとして提供され、同意なしにアップロードされることはありません。
CSVからJSONに戻すことはできますか？
はい。CSVからJSONへのコンバーターを使用し、ファイルに一致するヘッダーと型検出オプションを選択してください。