JSONをCSVに変換

JSONから必要なデータを取り出してCSVにする

最初に、JSONのどの部分を表にするかを決めます。JSON全体を変換するなら、「配列のパス」は空欄にします。配列なら要素ごとに1行、1つのオブジェクトなら1行になります。APIの応答の中から必要な配列だけを取り出す場合は、その配列までのキーをresults.itemsのようにドットでつないで指定します。$.results[*]のようなJSONPath式には対応していません。

入れ子のJSONはどの列に入るか

{"results":{"items":[{"id":"001","customer":{"name":"Ada"},"tags":["new","vip"]}]}}

この例では「配列のパス」にresults.itemsを入力します。「入れ子のオブジェクトをドット区切りの列に展開」にチェックを入れ、「レコード内の配列」は「JSONのまま保持」を選んでください。出力の区切り文字をカンマにすると、次のCSVになります。customerの中にあるnameはcustomer.name列に、tagsの配列は1つのセルに入ります。CSVのセル内で引用符を表すため、引用符が2つずつ並んでいます。

id,customer.name,tags
001,Ada,"[""new"",""vip""]"

展開のチェックを外すと、customer全体がcustomer列にJSON文字列として入ります。展開したまま「カンマで連結」を選ぶと、tagsはnew, vipになります。ただし、要素の中にもカンマがある場合は区切りを見分けられなくなるため、後で配列に戻す用途には向きません。展開を無効にしている間は、入れ子の配列もJSON文字列のまま保持します。

項目がない行やnullは空欄になる

列は、読み取り時に項目が初めて現れた順に並びます。途中の行からactiveという項目が増えた場合は列を追加し、それ以前の行は空欄にします。キーがない場合も、値がnullや空文字列の場合も、CSVでは同じ空欄になります。区別が必要なら元のJSONも残してください。真偽値はtrue、falseという文字列で出力します。

数値や文字列だけが並ぶ配列は、valueという1列になります。[[1,2],[3,4]]のような二次元配列も2列には展開せず、各配列を文字列にした2行として読み込みます。また、桁数の多いIDを数値で渡すと、JavaScriptで読み取る際に丸められることがあります。取り込み前のJSONで引用符を付け、文字列にしておいてください。失われた桁を後から復元することはできません。

同じ列名になるキーがあるときは変換を止める

{"customer.name":"literal key","customer":{"name":"nested key"}}

このJSONには、ドットを含むキーcustomer.nameと、customerの中のnameがあります。展開すると両方がcustomer.name列になるため、読み込みを停止します。別々の行に分かれていても同様です。元のキー名を変えるか、展開のチェックを外してから読み込み直してください。列名になるキーが空、または空白だけの場合もエラーになります。読み込みに失敗したときは前のデータを破棄するので、古い結果がそのまま保存されることはありません。

行数と空欄を確認してから保存する

出力の行数が配列の要素数と合っているか、項目が欠けている行でも列がずれていないかを確認します。扱えるのは最大25万件です。それを超える場合はプレビューのみとなり、保存できません。具体的な設定は入れ子のJSONをCSVにする手順とJSONサンプルで試せます。逆方向のCSVからJSONへの変換では、型の判定や空欄の扱いを選べます。受け取ったCSVの列数や引用符を調べるにはCSVチェックツールを使ってください。