JSON を JSONL にフラット化

ネストされた JSON オブジェクトや配列からレコードを抽出し、JSONL(JSON Lines)形式にフラット化します。各レコードが 1 行になります。処理は 100% クライアント側で行われます。

入力 JSON

.json ファイルをここにドロップするか、クリックして選択してください

.json、.txt に対応

出力 JSONL

ネストされた JSON を貼り付けるか、ファイルをドロップすると、JSONL にフラット化されます

JSON のフラット化とは?

JSON のフラット化とは、深くネストされた JSON 構造を、行単位のフラットな形式に変換する処理です。ネストされたオブジェクトのキーはドット表記(例:address.city)に変換されます。また、オブジェクトの配列は展開され、各要素が JSONL 形式の個別のレコードになります。

複雑にネストされた API レスポンスやデータベースのエクスポートデータを、フラットな表形式に変換したい場合に特に便利です。機械学習のトレーニングや CSV への変換、1 行に 1 レコードを格納するストリーミングデータパイプラインなどに利用できます。

配列をフラット化する 2 つの方法 — 出力先に応じて選ぶ

ネストされたオブジェクトは、キーをドットでつなげばフラット化できます。一方、配列では展開方法を選ぶ必要があります。適切な方法は、フラット化したデータの出力先によって変わります。

方法[{"sku":"A"},{"sku":"B"}] の変換結果適した用途
インデックスで展開items.0.sku = A, items.1.sku = B — 1 行のまま、列数が増えます行数を入力と同じに保つ必要があり、配列が短く、要素数の上限も決まっている場合
行に展開items.sku を持つ行が 2 行になります — 行数が増え、列構成は一定です各配列要素が独立したレコードに相当し、SQL や分析処理に渡す場合
JSON 文字列として保持items = "[{\"sku\":\"A\"},...]" — 内容を解釈せず、1 つのセルに格納します配列を今すぐクエリする必要がなく、後で再パースするメタデータとして扱う場合

JSON を JSONL にフラット化する方法

JSON を JSONL にフラット化する処理では、ネストされた構造からレコードを抽出し、各レコードを JSONL の個別の行に変換します。JSON にオブジェクトの配列が含まれている場合は、配列の各要素が 1 行になります。ネストされたオブジェクトのキーは、ドット表記に変換されます。

このツールの処理はすべてブラウザ内で完結し、データがサーバーに送信されることはありません。ネストされた JSON を貼り付けるか、ファイルをドラッグ&ドロップすると、フラット化された JSONL がすぐに表示されます。親階層のフィールドは、各レコードに自動でマージされます。

出力は、各行に余分な空白や改行のない JSON オブジェクトを 1 つずつ格納した、正しい JSONL 形式です。結果をクリップボードにコピーするか、.jsonl ファイルとしてダウンロードすれば、機械学習やデータパイプライン、データベースへのインポートにそのまま利用できます。

変換前と変換後

実際のデータに近い、ネストされたレコードと、配列をインデックスで展開してフラット化した結果を示します。区切り文字の選び方に注意してください。ドットで区切ると、元データに含まれる "config.debug" というキーそのものが、フラット化後のパス config.debug と衝突します。キーにドットが含まれている場合は、区切り文字をアンダースコアに変更してください。

// 変換前 — ネストされたレコード:
{"user": {"id": 7, "address": {"city": "Osaka", "zip": "530-0001"}}, "tags": ["vip", "beta"]}


// 変換後 — ドット区切りでフラット化し、配列をインデックス展開:
{"user.id": 7, "user.address.city": "Osaka", "user.address.zip": "530-0001", "tags.0": "vip", "tags.1": "beta"}

フラット化は、CSV や Excel にエクスポートする前の標準的な前処理です。これらは表形式のため、ネスト構造を表現できません。深くネストされたデータでは、出力の列数が非常に多くなることがあります。ファイル全体を処理する前に、まずサンプルをフラット化し、列数が妥当かどうかを確認してください。

主な用途

API レスポンスの処理
ネストされた API レスポンスを JSONL にフラット化し、データパイプラインでのパースやログ記録、後続の処理をしやすくします。
ETL でのデータ変換
複雑な JSON エクスポートデータからレコードを抽出し、JSONL にフラット化して、データベースやデータウェアハウスに読み込みます。
機械学習用データセットの準備
ネストされた JSON データセットを、OpenAI や Hugging Face などの機械学習プラットフォームでトレーニングに必要な、フラットな JSONL レコードに変換します。
ログの処理と分析
ネストされたメタデータを含む構造化ログファイルを JSONL にフラット化し、grep、jq、Elasticsearch などのツールで分析します。
テストデータの生成
複雑な JSON API のモックレスポンスを個別の JSONL レコードにフラット化し、自動テストスイートのテストフィクスチャとして利用します。
データベースの移行
MongoDB や CouchDB からエクスポートした、ネストされたドキュメント形式の JSON をフラットな JSONL レコードに変換し、PostgreSQL などのリレーショナルデータベースにインポートします。

よくあるエラーと対処法

フラット化できるレコードが見つからない

入力した JSON がプリミティブ値(文字列、数値)や空のオブジェクト、空の配列の場合に発生するエラーです。レコードを抽出するには、オブジェクト、またはオブジェクトの配列が必要です。キーと値のペアを持つオブジェクトが、JSON に少なくとも 1 つ含まれていることを確認してください。

ドット表記のキーが競合する

JSON のトップレベルに "user.name" というキーがあり、さらにネストされた {"user":{"name":"value"}} があると、フラット化後に両方が同じドット表記のキーになります。この場合、ネストされていた値がトップレベルの値を上書きします。フラット化する前に、競合するキーの名前を変更してください。

JSON の循環参照

標準の JSON に循環参照を含めることはできませんが、JSON を生成するツールによっては、循環参照に似た非常に深いネスト構造が生成されることがあります。このツールはある程度の深さまでネストを処理できますが、安全に処理できる範囲を超える構造ではフラット化を停止します。

よくある質問

ネストされたオブジェクトはどのようにフラット化されますか?

ネストされたオブジェクトのキーをドット表記に変換します。例えば、{"user":{"address":{"city":"NYC"}}} は {"user.address.city":"NYC"} になります。これにより、深くネストされたデータに、フラットなキーと値のペアとしてアクセスできます。

JSON 内の配列はどのように処理されますか?

JSON にオブジェクトの配列が含まれている場合は、各オブジェクトが JSONL の個別の行になります。プリミティブ値(文字列、数値)の配列は、フラット化後の出力に JSON 文字列としてシリアライズされます。展開対象となるメインの配列は、ツールが自動で検出します。

フラット化するときのデータは安全に扱われますか?

はい。フラット化の処理はすべて、お使いのブラウザ内でローカルに行われます。データがサーバーに送信されることはありません。JSON の内容が端末の外に出ることもありません。

ネストの深さが異なるデータが混在する JSON もフラット化できますか?

はい。このツールは、どの階層のネストも処理できます。トップレベルのスカラーフィールドは各レコードにマージされ、ネストされたオブジェクトのキーはドット表記に変換されます。オブジェクトの配列のうち、最も要素数の多い配列が JSONL の個別の行に展開されます。

フラット化するとき、null や undefined はどのように処理されますか?

null 値は、フラット化後の出力でも null のまま保持されます。JSON に undefined 型はないため、undefined 値が現れることはありません。空のオブジェクトはフラット化しても何も出力されず、キーも生成されません。空の配列は、空の JSON 配列としてシリアライズされます。

複数の JSON ファイルを一度にフラット化できますか?

現在、このツールで一度に処理できる JSON 入力は 1 つです。複数のファイルをフラット化する場合は、1 つずつ処理してください。一括処理には jq などのコマンドラインツールを使い、結果の目視確認にこのツールを組み合わせる方法もあります。

ネストの深さは何階層まで対応していますか?

実際の JSON データでよく使われる深さのネスト(通常 20 階層以上)に対応しています。コードで固定された深さの上限はありませんが、ネストが極端に深いと、出力されるドット表記のキーが非常に長くなる場合があります。

このツールは通常の JSON から JSONL への変換と、どう違いますか?

通常の JSON から JSONL への変換では、トップレベルの配列の各要素を個別の行に並べます。JSON から JSONL へのフラット化では、それに加えてネストされた構造を展開し、キーをドット表記に変換して、親階層のフィールドを各レコードにマージします。深くネストされた JSON からレコードを抽出したい場合は、フラット化を利用してください。

関連ツールとガイド