NDJSON を XLSX に変換

アプリケーションのログや API のイベント記録が NDJSON 形式で出力されることがあります。1 行ずつ独立した JSON のままでは表計算ソフトで集計できないため、この変換で表に変えます。

NDJSON の各行は独立した JSON なので、この変換はその行ごとに読み取り、それぞれを表の 1 行として書き出します。行によって持っているキーが違っていても、それぞれの行が持つ値がその行の列に反映されます。

各行の JSON がオブジェクトの中にオブジェクトを持つような入れ子構造の場合、この変換は `event.user.id` のようにドットでつないだ列名に平坦化します。表形式の XLSX には、もともと入れ子を表す仕組みがないためです。

配列も同様に、要素の位置を示す番号がパスの一部として列名に組み込まれます。

この変換が作る XLSX は常に 1 枚のシートで、シート名は元のファイル名から作られ、31 文字を超える場合は切り詰められます。書式や列幅の装飾は付かず、値がそのまま並ぶ簡素な表になります。

ログのように行ごとに持っているキーが違う NDJSON でも、この変換は特定の行にないキーを空欄として扱い、処理を止めません。表全体では、すべての行に現れたキーの和集合が列として並びます。

同じ列の中に数値と文字列が混在している場合、この変換器はその列全体を文字列として書き出します。ログの値の型が行によってばらついていると、この現象が起こりやすくなります。

いったん XLSX に変換したファイルを再び NDJSON に戻しても、列として平坦化する前の入れ子構造がそのまま復元されるわけではありません。

複数の NDJSON ファイルを一度に置いても、順番に処理されて ZIP にまとめて返ってきます。行数の多いログファイルほど処理に時間がかかりますが、実際の制約は端末の空きメモリーです。