JSON Lines（.jsonl・.ndjson）ファイルの開き方と変換

1行に1つのJSON値を保存するテキスト形式で、レコード、ログ、メッセージを1件ずつ処理する用途に使います。各行にはオブジェクト、配列、スカラー値を記述でき、nullも有効です。空行はJSON Linesの有効なレコードではありません。

UTF-8対応のテキストエディターのファイルを開く操作から.jsonlを選びます。各行が独立したJSON値です。データを処理する場合は行単位で読むJSONパーサーを使ってください。単一のJSON文書を想定するパーサーでは複数レコードがエラーになることがあります。

UTF-8対応のエディターを標準テキストのモードで使います。各レコードは1行に収めます。ターミナルではUnixのテキスト処理ツールやシェルのパイプで行を扱えますが、JSONとしての解析は各行に対して個別に行います。

スマートフォン内の対象ファイルにアクセスでき、UTF-8を読めるテキストエディターを選び、そのアプリから.ndjsonを開きます。ファイルへのアクセス方法と扱えるサイズはアプリによって異なり、すべてのモバイルエディターでの対応は保証されません。

JSON Linesは空行を認めません。NDJSONパーサーは動作を文書化したうえで空行を無視でき、その設定を利用者が変更できるようにすることが推奨されるため、ツールによって結果が異なります。未完成のJSONや複数行に分かれたレコードも確認してください。

レコードを行単位で読み取り、個別に処理するならJSON Linesが適しています。受け取り側が単一のJSON文書を求めるなら、通常のJSON配列を使います。複数のJSON値を改行で並べても、単一の有効なJSON文書にはなりません。

各行をJSON値として解析し、順序を保って1つの配列内へカンマ区切りで出力します。これは形式の構造に基づく変換方法です。.jsonlを.jsonへ変更するだけでは、複数レコードをJSON配列に変換できません。

入れ子のオブジェクト、配列、フィールドが異なるレコードをCSVの列へどう対応させるか確認します。重複キーと大きな整数・高精度小数も要確認です。解析時に最後の重複値だけが残ったり、ツールの精度を超える数値が変化したりする場合があります。

正しいJSON構文には代入や関数呼び出しがありません。ただし、信頼できないテキストにevalなどを使うとコード実行のリスクが生じます。JSONパーサーを使ってください。解析に成功しても、内容が信頼できるとは限りません。

元の文字コードを確認し、正しくデコードしたコピーをBOMなしのUTF-8で保存します。JSON Linesではこの文字コードが必要です。以前の読み込みで文字が置換されている場合、文字コードの指定を変えるだけでは元の文字を復元できません。

参照仕様には、すべての閲覧ツールに共通する上限は示されていません。パーサーはテキストサイズ、入れ子の深さ、文字列長を制限できます。対になっていないUnicodeサロゲートは、予測できない動作や実行時エラーの原因にもなります。