JSONLとは?JSON Lines形式を徹底解説
構文から具体例、用途、ベストプラクティスまで、JSON Linesの基本をまとめて解説します。
JSONLとは?
JSONL(JSON Lines)は、Newline Delimited JSON(NDJSON)とも呼ばれるテキストベースのデータ形式です。各行に有効なJSON値を1つずつ記述し、改行文字で区切ります。通常のJSONではデータ全体を1つの配列やオブジェクトにまとめますが、JSONLでは1行に1レコードを格納します。
このシンプルな構造により、JSONLはストリーミングやログの記録、大規模なデータセットの処理に適しています。ファイル全体をメモリに読み込まずに、各行を個別に読み込み、パースして処理できます。
JSONLは、OpenAIのファインチューニング用データセットや、BigQuery、Apache Spark、ログ管理システムなど、大量のデータを扱うツールやプラットフォームでの採用を通じて広まりました。
JSONLの構文ルール
JSONLの基本的なルールは次のとおりです。
- 各行には、有効なJSON値(オブジェクト、配列、文字列、数値、真偽値、nullのいずれか)を記述します
- 行の区切りには改行文字(\n)を使います
- 行と行の間にカンマなどの区切り文字は付けません
- ファイルの文字エンコーディングにはUTF-8を使います
- ファイル末尾の改行は省略できます
- ほとんどのパーサーは空行を無視します
{"name":"Alice","age":30,"city":"New York"}
{"name":"Bob","age":25,"city":"London"}
{"name":"Charlie","age":35,"city":"Tokyo"}補足:各行が、それだけで完結したJSONオブジェクトになっています。行と行の間にカンマはなく、全体を配列で囲む必要もありません。
JSONLの記述例
{"id":1,"name":"Alice","email":"[email protected]"}
{"id":2,"name":"Bob","email":"[email protected]"}
{"id":3,"name":"Charlie","email":"[email protected]"}{"user":{"name":"Alice","age":30},"scores":[95,87,92]}
{"user":{"name":"Bob","age":25},"scores":[88,91,76]}JSONLでは、すべての行を同じ型にそろえる必要はありません。各行が有効なJSONであれば記述できます。
{"event":"login","user":"alice","timestamp":"2026-01-15T10:30:00Z"}
{"event":"purchase","user":"alice","amount":29.99,"items":["book","pen"]}
{"event":"logout","user":"alice","timestamp":"2026-01-15T11:45:00Z"}JSONLの代表的な用途の1つが、OpenAIのファインチューニング用データセットです。
{"messages":[{"role":"system","content":"You are a helpful assistant."},{"role":"user","content":"What is JSONL?"},{"role":"assistant","content":"JSONL is a text format where each line is a valid JSON value."}]}
{"messages":[{"role":"system","content":"You are a helpful assistant."},{"role":"user","content":"How do I read a JSONL file?"},{"role":"assistant","content":"Read the file line by line, parsing each line as JSON."}]}JSONLファイルの読み込み方法
JSONLファイルは、テキストを1行ずつ処理できるツールで読み込めます。ここでは、よく使われる方法を紹介します。
Unixの標準ツールでJSONLファイルの内容を確認できます。
# 最初の5行を表示
head -n 5 data.jsonl
# 総行数(レコード数)をカウント
wc -l data.jsonl
# jqで各行を整形表示
cat data.jsonl | jq .
# フィールド値でフィルタリング
cat data.jsonl | jq 'select(.age > 30)'Pythonでは、標準ライブラリのjsonモジュールでJSONLを扱えます。
import json
with open('data.jsonl', 'r') as f:
for line in f:
record = json.loads(line)
print(record['name'])Node.jsでは、次のようにJSONLファイルを1行ずつ読み込めます。
import { createReadStream } from 'fs';
import { createInterface } from 'readline';
const rl = createInterface({
input: createReadStream('data.jsonl')
});
for await (const line of rl) {
const record = JSON.parse(line);
console.log(record.name);
}JSONLファイルの作成方法
JSONLファイルは、1行に1つずつJSON値を書き込むだけで作成できます。
import json
records = [
{"name": "Alice", "age": 30},
{"name": "Bob", "age": 25},
{"name": "Charlie", "age": 35},
]
with open('output.jsonl', 'w') as f:
for record in records:
f.write(json.dumps(record) + '\n')import { writeFileSync } from 'fs';
const records = [
{ name: 'Alice', age: 30 },
{ name: 'Bob', age: 25 },
{ name: 'Charlie', age: 35 },
];
const jsonl = records
.map(r => JSON.stringify(r))
.join('\n');
writeFileSync('output.jsonl', jsonl + '\n');JSONLにコメントを追加できますか?
いいえ。JSONLの仕様ではコメントをサポートしていません。JSONLファイルの各行は有効なJSON値である必要があり、JSON自体にもコメントの構文はありません。
データにメタデータや注釈を添えたい場合は、一般に次のような方法が使われます。
- 1JSONオブジェクトにメタデータ用のフィールドを追加します:{"_comment": "テストデータ", "name": "Alice"}
- 2JSONLファイルとは別に、メタデータ用のファイルを用意します
- 3ファイルの先頭行にメタデータを記述します:{"_meta": {"version": "1.0", "created": "2026-01-15"}}
「コメント」用のフィールドも通常のデータとしてパースされる点に注意してください。JSONLファイルを読み込むアプリケーション側で、メタデータのフィールドを無視するように設計する必要があります。
JSONL vs JSON
大きな違いはデータの構造です。JSONではデータ全体を1つの値にまとめますが、JSONLでは1行に1つずつ値を格納します。
[
{"name": "Alice", "age": 30},
{"name": "Bob", "age": 25}
]{"name":"Alice","age":30}
{"name":"Bob","age":25}- JSONをパースするには全体をメモリに読み込む必要がありますが、JSONLは1行ずつ読み込めます
- JSONは要素をカンマで区切り、JSONLは改行で区切ります
- JSONは設定ファイルやAPIに、JSONLは大規模なデータセットやストリーミングに適しています
- JSONにデータを追記するにはファイル全体を書き換える必要がありますが、JSONLは新しい行を追加するだけで済みます
詳しい比較はこちらのガイドをご覧ください: JSON vs JSONL guide.
主な用途
機械学習とAI
最もよく使われる用途JSONLは、機械学習の学習データに使われる標準的な形式です。OpenAIやHugging FaceなどのAIプラットフォームでは、ファインチューニング用データセットにJSONLを採用しています。各学習サンプルが1行で完結しているため、シャッフルやサンプリング、ストリーミングを効率よく行えます。
ログファイルとイベントストリーム
JSONLELK stack、Datadog、CloudWatchなどの構造化ログシステムは、ログをJSONL形式で出力します。各ログエントリが1行のJSONになるため、新しいエントリの追記やリアルタイムでのログ処理が容易です。
ビッグデータ処理
JSONLApache Spark、BigQuery、AWS Athenaなどのツールは、JSONLを標準でサポートしています。行単位でデータを扱えるため、分散システムでの並列処理が可能です。各ワーカーが、割り当てられた複数の行をそれぞれ独立して処理できます。
ストリーミングAPI
JSONL大量の結果を返すAPIでは、JSONLによるストリーミングがよく使われます。クライアントはレスポンス全体を待つ必要がなく、結果を受信した時点ですぐに処理を開始できます。
JSONLファイルの拡張子
JSONLファイルでは、一般に次の拡張子が使われます。
3つの拡張子はすべて同じ形式を含んでいます——1行に1つのJSON値。JSONLのMIMEタイプはapplication/jsonlまたはapplication/x-ndjsonです。
無料のJSONLツールを試す
JSONLの構文チェック、形式の変換、ファイルの閲覧を、すべてブラウザ内で行えます。
最大 1GB の JSONL ファイルを、ブラウザですぐに表示・編集できます。ストリーミング、シンタックスハイライト、リアルタイム検証に対応した無料の JSONL ファイルビューアです。アップロードもユーザー登録も不要。データはお使いのデバイス内で処理されます。
JSONL ファイルを 1 行ずつ検証します。構文エラーや文字エンコーディング、形式の問題をすぐに検出できます。
JSONL ファイルに適切なインデントを付けて、読みやすく整形できます。デバッグやデータのレビューがしやすくなります。
JSON と JSONL の形式を詳しく比較します。それぞれの使いどころやメリット・デメリット、相互に変換する方法を解説します。
JSONL ファイルの扱い方を順を追って学べるチュートリアルです。Python、JavaScript、コマンドラインツールを使った JSONL データの読み書きと処理方法を解説します。