application/x-ndjson — ストリーミング用改行区切りJSON
NDJSON(改行区切りJSON)とそのMIMEタイプapplication/x-ndjsonについて、ストリーミング、ログ処理、バルクAPI操作での活用を学びます。
Application Types
詳細な説明
NDJSONとは?
NDJSON(Newline-Delimited JSON)は、JSON Linesとも呼ばれ、各行に有効なJSON値を含み、改行文字(\n)で区切られたフォーマットです。
MIMEタイプ
application/x-ndjson
なぜ標準JSONではないのか?
標準のapplication/jsonはドキュメント全体が単一の有効なJSON構造である必要があります。NDJSONは以下の問題を解決します:
- 各行を到着時に独立して解析
- ペイロード全体をバッファリングする必要なし
- 定数メモリで数百万レコードを処理
主なユースケース
- Elasticsearch Bulk API — バルクインデックスにNDJSONを使用
- ログ集約 — NDJSON形式の構造化ログ
- データパイプライン — マイクロサービス間のストリーミングデータ
- LLM API — トークン単位のストリーミングレスポンス
ユースケース
ストリーミングAPIの構築、大規模データセットの行単位の処理、またはElasticsearchなどバルク操作にNDJSONを使用するシステムとの統合時にapplication/x-ndjsonを使用します。