テキスト・データ

JSON から CSV

フラットな JSON から CSV の表を作成し、取り込む前に確認しましょう。

このツールの使い方

  1. 1

    フラットなオブジェクトの配列、または単純な値を含む同じ長さの行配列からなる、有効な JSON を貼り付けてください。

  2. 2

    区切りをカンマ、タブ、セミコロンから選び、数式保護を確認して、1 MB、10,000 行、200 列の上限内で変換してください。

  3. 3

    空のセルや数式文字で始まる値を含めて CSV を確認し、コピーまたはダウンロードしてください。

フラットな JSON レコードの配列や、各行が同じ長さの二次元配列を CSV に変換します。入れ子のオブジェクトや配列を黙って平坦化せず、エラーとして扱います。表計算ソフトで開く可能性のある出力向けに、数式保護は標準で有効です。

表に適したデータから始める

フラットなレコードには名前付きのフィールドがあり、氏名、コード、数量など各値が一つのセルに収まります。このレコードの配列は表にできます。一方、長方形の配列は同じ数のセルを持つ行で構成されます。行と列の構造が明確なため、これらの形式に対応しています。

住所のオブジェクトやタグの配列を含むレコードは、入れ子になっています。このツールは入れ子の値を受け付けません。変換前に、どう列へ展開するか決めてください。住所なら市区町村と郵便番号を別のフィールドに分ける必要があり、タグの一覧にも意図した表現方法が必要です。自動で平坦化すると、その判断が見えにくくなることがあります。

例: 在庫リストを書き出す

コード、名前、数量を含むフラットなレコードを考えてみましょう。00127 のような商品コードは JSON 文字列にすると、CSV のテキストでも先頭のゼロが残ります。「マグカップ, 青」のような名前は引用符付きの CSV フィールドに入り、カンマで余分な列ができるのを防ぎます。

結果を表計算ソフトで開く前に、インポート設定でコード列を文字列に指定してください。変換ツールが CSV の文字を保持していても、表計算ソフトはそれを数値として解釈する場合があります。プレビューと表計算ソフトの表示が常に同じだと思わず、インポート後のコードを確認しましょう。

数式保護の仕組みを理解する

表計算ソフトは、特定の先頭文字を数式の開始として解釈することがあります。数式保護は、そのような出力セルを文字列として扱いやすくするため、初期状態で有効になっています。=、+、-、@ などで始まる値を含む場合、特に他の人から受け取ったデータでは、この設定を確認してください。

保護によって、セルの CSV 内での表現が意図的に変わる場合があります。信頼できる後続システムが正確に同じ文字列を必要とする場合は、出力とそのシステムの動作を確認してから保護を無効にしてください。コンマを含む CSV フィールドを引用符で囲む処理とは別のものです。通常の CSV の引用符だけで、数式に対する安全性が保証されるわけではありません。

無効な JSON や不揃いな行を直す

JSON では、プロパティ名と文字列の値を二重引用符で囲む必要があります。コメントや末尾の余分なコンマは有効な JSON ではありません。解析に失敗した場合は、ツールが示した位置を確認し、入力を修正してから試してください。ソースコードからコピーした JavaScript オブジェクトは、有効な JSON テキストとは限りません。

行の配列では、各行のセル数が同じである必要があります。入れ子のレコードでは、先に元のシステムで必要な列を選んでください。エクスポートは 1 MB、10,000 行、200 列以内に収め、CSV インポート後の比較用に元の JSON を残してください。

長い識別子と精度が重要な小数を守る

JSON の数値は変換前に検査されます。JavaScript で表現すると値が変わる数値、安全な整数の範囲外の整数、オーバーフローする値、ゼロに丸められる非ゼロの値は拒否されます。例えば、識別子 1234567890123456789 の全桁を保持するには、引用符で囲んだ JSON 文字列として記述してください。精度が重要な小数も文字列にしましょう。通常の小数や科学的記数法は、この検査で十進数としての値が保たれる場合に受け付けられます。

よくある質問

入れ子のオブジェクトはテキストセルになりますか?

いいえ。入れ子のオブジェクトや配列は受け付けません。列名や値の意味をご自身で管理できるよう、変換前に意図した形でデータを平坦化してください。

CSV は JSON の型を保持しますか?

CSV はテキストフィールドの表であり、JSON の型定義を完全には保持しません。取り込み時に、利用先のアプリが数値、空のセル、その他の値をどう解釈するか確認してください。

データはどこで処理されますか?

入力をアップロードせず、ブラウザー内で変換します。ページを離れる前に結果をダウンロードまたはコピーし、表全体を取り込む前に利用先のアプリでサンプルを確認してください。

参考資料・関連文献