ファイルを知る、使いこなす。
.jsonl
JSON Linesデータ
データ分析・科学JSONLはUTF-8の各行へ1個ずつJSON値を置く形式です。ログ、データ交換や学習データ等で使われます。ファイル全体を1個のJSON配列として読む形式とは異なり、行ごとの構文と、利用先が求める項目を別々に確認します。
- 主な用途
- 1行ずつ独立したJSON値を記録
- 中身の種類
- テキストデータ
目次・よくある質問・根拠資料を見る
内容の最終確認： · 編集：Kai
開き方・操作手順
使っている環境や目的の項目を開いて、手順を確認してください。
操作名・対応状況はアプリ・OS・版によって異なります。変更する前に原本を残してください。
開けないとき：症状から確認
- Extra data等のエラー：全体を1JSONとして読んでいないか確認します。
- 途中の行だけ失敗：引用符、バックスラッシュと空行を点検します。
- 項目が受け付けられない：JSONLとして正しくても利用先の仕様確認が必要です。
- 大きくて開けない：全件を表計算へ読み込まず、行単位で確認します。
JSONL → JSON配列 / CSV等
- 各行を解析して配列へまとめるか、必要な項目を選んで表形式へ出力します。
- 総行数、構文、必須キー、文字コードと取り扱う個人情報を確認します。
CSVでは入れ子、配列、nullと値の型が同じようには表現されません。
JSONLの正しさと用途の正しさ
各行はオブジェクト以外のJSON値でも構文上は成立しますが、利用先がオブジェクトや特定のキーを要求する場合があります。ファイル形式の検査だけで投入可能と判断しません。
この手順の根拠：JSON Lines project · JSON Lines / IETF · RFC 8259: JSON
具体例：受け渡し前にここを確認
例：messagesを要求するサービス向けなら、1行1JSONを確認した後、messagesの型、必須フィールドと各レコードの内容を検査します。
この手順の根拠：JSON Lines project · JSON Lines / IETF · RFC 8259: JSON
関連形式との違い
| 形式・方法 | 用途と引き継ぐ情報 |
|---|---|
| .jsonl | 1行ずつ独立したJSON値を記録 |
| JSON / CSV | JSONは全体構造、CSVは表向けです。入れ子や型の保存条件を確認します。 |
| JSONL → JSON配列 / CSV等 | CSVでは入れ子、配列、nullと値の型が同じようには表現されません。 |
取り扱いと安全性
ログや学習データには個人情報、APIキー、内部URLが入り得ます。共有前に内容を確認します。
よくある質問
普通のJSONと何が違う？
JSONLは行ごとにJSON値を区切る保存上の約束です。
文字列内に改行を書ける？
文字列の改行は適切にエスケープし、1レコードを物理的な複数行に分けないよう扱います。
空行も1件として使える？
JSON値がない空行はJSON Linesのレコードではありません。利用先の仕様も確認します。
形式の基本情報：正式名称・MIME type・管理団体
- 名称
- JSON Lines Data
- 管理・仕様
- JSON Lines project
- MIME type
- 用途・配信元の指定を確認してください。拡張子だけでMIME typeは確定できません。
公式・一次情報
- プロジェクト公式JSON Lines
UTF-8、1行1JSON値と改行の約束。
JSON Lines project · リンク確認： - 標準仕様RFC 8259: JSON
JSONの構文と文字列・数値のルール。
IETF · リンク確認：