JSONL

JSONL（JSON Lines）は NDJSON と等価である。1 行に 1 つの JSON オブジェクトを置く、同じ形式の別名である。

目的

ストリーミング JSON 処理の標準形式を提供する。NDJSON と同義である。

メカニズム

各行は \n で区切られた有効な JSON 値である。NDJSON との唯一の違いは、JSONL が 1 行 1 オブジェクト（配列やスカラーではない）を強調することだが、実際には両者は互換的に使われる。

ユースケース

ログファイル
データパイプラインのストリーム
ページネーション API レスポンス
データベースダンプ

例

入力

{"id":1}
{"id":2}

Output

Two JSON objects, one per line

Same as NDJSON

よくあるエラー

Confusing JSONL with a JSON array: JSONL has no outer []; each line is independent

関連用語

NDJSON（改行区切りJSON）は1行に1つの独立したJSONオブジェクトを格納する形式であり、大規模データセットのストリーミング処理に適する。

JSON（JavaScript Object Notation）は、JavaScript のオブジェクトリテラルに基づく軽量なデータ交換形式である。キー・バリューペアと配列を使う。

CSV（comma-separated values）は、フィールドをカンマで区切る表形式のデータ形式である。RFC 4180 が標準を定義し、データの入出力に広く使われる。

関連ツール

JSONL フォーマッター

Jsonl Format — 純クライアントサイドツール。プライバシーファースト、サーバー往復なし。

JSONL バリデーター

Jsonl Validate — 純クライアントサイドツール。プライバシーファースト、サーバー往復なし。

References