JSON を TSV に変換

表形式には本来「入れ子」という概念がありません。JSON の値がオブジェクトや配列を含んでいる場合、この変換は 1 つの葉の値ごとに 1 つの列を作り、そこへ至る経路をドットでつないだ名前を列名にします。配列の添字も経路の一部として扱われます。

例えば `{"user":{"name":"田中","tags":["a","b"]}}` は `user.name`、`user.tags.0`、`user.tags.1` という 3 つの列に平らにされます。元の階層構造を知らないと、この列名だけでは意味がつかみにくくなることもあります。

JSON から TSV、CSV、SQL、INI、XLSX、Parquet へ書き出す場合、すべてこの同じ「平らにする」処理を経ます。逆に JSON、YAML、TOML、XML、NDJSON へ書き出す場合は、階層構造がそのまま保たれます。

つまり、階層を保ったまま別の形式に移したいだけなら TSV は向いていません。表計算ソフトで開きたい、という目的がある場合にだけ意味を持つ変換です。

JSON の配列は要素の個数が値によってまちまちなことがあります。この変換ではその個数の違いがそのまま列の有無に表れ、要素の少ない値の行は該当する列が空欄になります。

結果として、同じ構造のはずのデータでも、行ごとに列の埋まり方が異なる TSV になることがあります。想定より列数が多くなっていないか、書き出し後に確認しておくと安心です。

JSON の数値や真偽値は、TSV の中ではテキストとして書き出されます。この変換自体が新たに型を変えることはなく、JSON にあった値がそのまま文字として並びます。

一方で、TSV や CSV を再び JSON に戻すときには型の推定が働くため、往復させると `007` のような先頭の 0 を持つ文字列が数値に変わってしまうことがあります。識別子を含むデータを扱う場合は注意してください。

列の並び順は、データの中に現れた経路の順序に従います。並び替えを行う機能はなく、元の JSON の構造がそのまま列の並びに反映されます。

複数のオブジェクトでキーの並びが異なる場合、最初に現れた順序が優先され、あとから出てきた新しいキーは末尾に追加されます。

解析と平坦化はブラウザーの中で行われ、限界はメモリーです。データ全体をいったんメモリー上に展開してから書き出すためです。数十メガバイトは普通に通ります。

数百メガバイト規模の JSON を扱う場合は、ブラウザーの変換機ではなく、逐次処理のできるスクリプトのほうが確実です。