作業メモ
JSON / CSV / ID 変換の使い分け
JSON / CSV の変換と、ID の生成・読み取りは別の作業です。まず JSON / CSV、次に ID を分けます。
ページ更新日:
整形・相互変換・ID処理を分ける
文字列をきれいにしたいのか、形式を変えたいのか、識別子を扱いたいのかで開くページが変わります。
JSON整形と CSV 変換は別作業
見やすくするだけなら整形、表データへ渡すなら JSON / CSV 変換を使います。
ID は生成と読み取りを混ぜない
新しい UUID / ULID が必要なのか、既存値の時刻や形式を見たいのかを先に決めます。
次にやること
1. JSON を整えるか、形式を変えるかを分ける
JSON の見やすさ確認と CSV 変換は別の作業として扱います。
2. ID を新しく作るか、既存値を読むかで分ける
生成系とデコード系を混同しないように入口を分けます。
3. 形式と文字列のどちらを触るかを見直す
構造ではなく生テキストの整形が主目的なら、別カテゴリへ戻ります。
- データ変換・開発カテゴリ
構造化データ系の周辺ツールを広く見たいときに戻ります。
- 文章・テキストカテゴリ
改行や空白など、生テキスト側を見たいとき。
詰まりやすい場面
- JSON を見やすくしたいのか、CSV と相互変換したいのかで迷うとき
- UUID / ULID を新規発行したいのか、既存値を読み取りたいのか曖昧なとき
- テキスト整形ではなく構造や識別子の確認から始めたいとき
具体例と判断基準
よくある失敗例
ネストJSONをそのままCSVへ平坦化する
配列・入れ子・nullの扱いを決めずに変換すると列や行の意味が失われます。
IDの先頭ゼロを数値として落とす
`00123` は識別子なら文字列のまま保ち、表計算ソフトへ渡す前後で確認します。
生成・検証・読解を同じ作業と考える
新しいIDが必要か、形式が正しいか、埋め込み時刻を読むかで選ぶツールが違います。
入力・作業サンプル
形の確認例
`[{"id":"001","tags":["a","b"],"note":null}]` について、1行の単位、tagsの表現、nullの出力を決めます。
判断表
構文確認→JSON整形、値抽出→JSONPath/JMESPath、表変換→JSON/CSV変換、ID生成→UUID生成、種類と構造→UUID/ULID plus、ULID1件の時刻→ULID専用。
before
『JSONをCSVにしたい』だけで、配列位置、null、文字コード、ID型、戻し変換条件が未定。
after
目的を変換/検証/抽出へ分類し、行の単位、列の型、null・欠落、leading zero、文字コード、lossless条件を表にする。
この順番で見る理由
先にデータの形と失ってはいけない情報を決めると、変換後に復元不能な変更を防げるためです。ID作業はデータ変換とは別に目的を分類します。
迷ったときの判断基準
losslessを優先
先頭ゼロ、nullと欠落、配列順、数値精度を戻せない場合は変換せず元形式を保管し、派生ファイルとしてCSVを作ります。
CSVを選ぶ条件
1行の単位と列が固定され、人が表として確認・受け渡しする必要がある場合に選びます。
JSONを選ぶ条件
入れ子・配列・型を保つ必要があり、受け手がJSONを扱える場合に選びます。
関連ツールを使う流れ
- 検証: JSON整形またはCSV崩れ確認で入力の構造を確認します。
- 保全: 先頭ゼロと文字コードの条件を決め、原本を別に保管します。
- 変換・再検証: 変換後を逆方向へ戻すか、件数・キー・代表値で一致確認します。
形式変換は情報を失う場合があります。原本を残し、戻し変換または代表値照合を行ってください。
作業を止めて確認する条件
- 1行の単位を決められない
- 配列・null・先頭ゼロの出力規則がない
- 変換先が要求する文字コードや列型が不明
ツールを使わない判断
受け渡し仕様がJSON Schemaや固定CSV仕様として提供されている場合は、その仕様と専用バリデータを正本にし、汎用変換はサンプル確認にだけ使います。
対象外: 任意の入れ子構造の完全自動平坦化、スキーマ設計、IDの真正性・一意性保証。
最終チェックリスト
- 変換・検証・抽出・ID作業のどれかを分類した
- 行単位、列型、null、配列、leading zeroを決めた
- 原本を保持し、件数・キー・代表値を変換後に照合した
- 文字コードと取り込み先仕様を確認した
まず開くツール
各段階で最初に開くものだけを並べています。
必要なら見るページ
用語や周辺ツールが必要なときだけ使います。
- データ変換・開発カテゴリ
JSON / CSV / SQL / ID の周辺ツールも見たいとき。