著者: Jerry Fan

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を使います
  • ファイル末尾の改行は省略できます
  • ほとんどのパーサーは空行を無視します
正しいJSONLファイルの例
{"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のファインチューニング用データセットです。

PopularOpenAIのファインチューニング用フォーマット
{"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を扱えます。

Python
import json


with open('data.jsonl', 'r') as f:
    for line in f:
        record = json.loads(line)
        print(record['name'])

Node.jsでは、次のようにJSONLファイルを1行ずつ読み込めます。

JavaScript / Node.js
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.coで最大1GBのJSONLファイルを開いて閲覧できます。ファイルのアップロードは不要で、すべての処理がブラウザ内で完結します。

JSONLファイルの作成方法

JSONLファイルは、1行に1つずつJSON値を書き込むだけで作成できます。

Python
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')
JavaScript / Node.js
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つずつ値を格納します。

JSON通常のJSON
[
  {"name": "Alice", "age": 30},
  {"name": "Bob", "age": 25}
]
JSONLJSONL (JSON Lines)
{"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行で完結しているため、シャッフルやサンプリング、ストリーミングを効率よく行えます。

ログファイルとイベントストリーム

JSONL

ELK stack、Datadog、CloudWatchなどの構造化ログシステムは、ログをJSONL形式で出力します。各ログエントリが1行のJSONになるため、新しいエントリの追記やリアルタイムでのログ処理が容易です。

ビッグデータ処理

JSONL

Apache Spark、BigQuery、AWS Athenaなどのツールは、JSONLを標準でサポートしています。行単位でデータを扱えるため、分散システムでの並列処理が可能です。各ワーカーが、割り当てられた複数の行をそれぞれ独立して処理できます。

ストリーミングAPI

JSONL

大量の結果を返すAPIでは、JSONLによるストリーミングがよく使われます。クライアントはレスポンス全体を待つ必要がなく、結果を受信した時点ですぐに処理を開始できます。

JSONLファイルの拡張子

JSONLファイルでは、一般に次の拡張子が使われます。

.jsonlJSONLの標準的な拡張子で、最も広く使われています
.ndjsonNewline Delimited JSONの略称です。名前が異なるだけで、技術的には同じ形式です
.json一部のツールはJSONLを.json拡張子で出力するため、混同することがあります

3つの拡張子はすべて同じ形式を含んでいます——1行に1つのJSON値。JSONLのMIMEタイプはapplication/jsonlまたはapplication/x-ndjsonです。

JSONLビューアを試す

最大1GBのJSONLファイルをブラウザで開き、そのまま閲覧・編集できます。アップロードは不要で、プライバシーは100%守られます。

よくある質問

参考資料