CSV ヘッダー確認ツール

CSVヘッダーとは？

CSVヘッダーとは、CSVファイルの1行目に配置される各列の名前です。列名、項目名、フィールド名とも呼ばれます。例えば name,age,city なら、name・age・cityがヘッダーです。業務システムやSaaSへCSVを取り込む際は、この名前を使って各データの意味や取込先を判断することがあります。このツールではCSVの1行目をヘッダーとして確認します。

今回修正するヘッダー

customer_id,name,name, status,
0001,ヤマダタロウ,山田太郎,ACTIVE,

この例には、先頭のUTF-8 BOM、nameの重複、 statusの先頭空白、末尾の空列があります。取込先の仕様が次の4列なら、修正結果はこうなります。

customer_id,name_kana,name,status
0001,ヤマダタロウ,山田太郎,ACTIVE

CSVヘッダーが原因で取り込めない主なケース

CSVが読み込めない、CSVアップロードエラーやインポートエラーになる場合、データ内容だけでなく1行目のヘッダーと各recordの項目数を確認すると原因を絞り込めます。

検出結果を確認してヘッダーを修正する手順

1. 原本と取り込み先の仕様書を用意し、CSVを選択してBOM、列名と列数を確認します。
2. 今回の例では、CSV 列名変換・マッピングで2列目の name を name_kana、4列目の status を status に変更します。データの値や列順は変わりません。
3. 5列目が仕様上不要なことを確認し、CSV 列抽出で先頭4列を残します。ヘッダーと全データ行から同じ列を除きます。
4. 取り込み先がBOMなしを要求する場合だけ、UTF-8 BOM 追加・削除でBOMを削除します。BOM操作は文字コード変換ではありません。
5. 修正後のファイルを再チェックし、正式な列名・列順、必須値や日付形式を仕様と照合してから、少量のデータで取り込みを試します。

BOMは画面上で見えないため、コード例だけでなくツールのBOM表示も確認してください。1列目だけ見つからない場合も、BOMだけでなく誤字や要求される列名を確認します。

CSVヘッダーが重複している場合

name,age,name のようにCSV列名が重複すると、2つのnameを一意に識別できません。CSVからJSONへ変換する処理では同じ項目が上書きされる可能性があり、データベースや業務システムではCSV形式エラーとして拒否される場合があります。完全に同じ名前はエラー、大文字・小文字や外側の空白だけが違う名前は似たヘッダーとして警告します。

CSVヘッダーが空欄の場合

name,,city では2列目に項目名がありません。CSVの構造上は空欄を含められますが、取込先がすべての列名を必須としている場合はエラーになります。CSV列名が空欄、または空白文字だけの場合をアップロード前に確認できます。

CSVヘッダーの前後にスペースがある場合

" name" や "name " は、画面ではnameとほぼ同じに見えても異なる文字列です。半角スペースだけでなく、日本語データに混ざりやすい全角スペースもmapping不一致の原因になる場合があります。本ツールでは前後の空白、全角スペース、タブ、NBSP、ゼロ幅スペースなどを別々に知らせます。

UTF-8 BOMがCSVヘッダーに影響する場合

UTF-8 BOMはファイル先頭の EF BB BF というbyte列です。通常はparserが適切に処理しますが、一部のプログラムでは1列目が「name」のように見え、期待したnameと異なる列として扱われる場合があります。このツールでは先頭BOMを列名から除外して状態を表示します。追加・削除が必要な場合はUTF-8 BOM 追加・削除ツールを利用できます。

CSVのヘッダーとデータ行の列数が合わない場合

ヘッダーが name,age,city の3列なのにデータが Taro,20 の2列なら項目数が一致しません。カンマ不足、区切り文字の違い、引用符の不整合、データ欠損、CSV出力処理の不具合などが原因として考えられます。本ツールはquoted newlineを1つのfieldとして解析し、列数がおかしいrecordを「データ行」の番号で最大20件表示します。区切り文字が違う場合はCSV 区切り文字変換ツールも確認してください。

Excelで編集したCSVのヘッダーを確認する理由

Excelで保存したCSVでは、選択した保存形式や環境によって文字コード、BOM、区切り文字などが変わる場合があります。また、入力時に前後の空白や列のずれを見落とす可能性もあります。Excelが必ずCSVを壊すわけではありませんが、別システムへ渡す前に文字コードとヘッダーを確認するとトラブルを減らせます。文字コードが不明な場合は文字コード判定ツールを利用できます。

CSVをシステムへ取り込む前に確認したい項目

• ヘッダー名は仕様書と一致しているか
• 列名が重複していないか
• 空欄や空白だけの項目名がないか
• 前後に半角・全角スペースがないか
• ヘッダーとデータ行の列数が一致しているか
• 文字コードと区切り文字は正しいか
• 取込先が必要とするBOMの状態か

自動検出できることと判断できないこと

ツールは同じ文字列の重複、空欄、前後空白、BOMの有無を機械的に検出できます。しかし、2つ目のnameがname_kanaなのか、別の氏名欄なのかはデータと業務仕様を見なければ決められません。

そのため、重複名へ自動で_2を付けるだけでは安全とは限りません。取込先の正式な列名へ合わせます。列名を変更する必要がある場合も、対応関係を確認してから処理してください。

FAQ

CSVのヘッダーが重複していると問題になりますか？

システムによっては同じ列名を正しく識別できず、CSVの取り込みやJSON変換で問題になる場合があります。

CSVヘッダーが空欄でも使えますか？

CSV自体には空欄を含められますが、取り込み先によってはエラーになります。

CSVの列数が合わない原因は何ですか？

区切り文字の不足、引用符の不整合、データ欠損などが主な原因です。

CSVの1行目は必ずヘッダーですか？

いいえ。ヘッダーのないCSVもあります。このツールでは1行目をヘッダーとして確認します。

CSVヘッダーのスペースは問題になりますか？

見た目が同じでも異なる列名になるため、システム取込時に問題になる場合があります。

全角スペースも確認できますか？

はい。ヘッダーに含まれる全角スペースを確認します。

UTF-8 BOMはヘッダーに影響しますか？

通常は適切に処理されますが、一部のprogramではBOMが1列目の文字として扱われる場合があります。

CSVのデータ内容はサーバーに送信されますか？

いいえ。ファイルはブラウザ上だけで処理します。

CSVの列名だけ確認できますか？

はい。ヘッダー一覧と各列の状態を確認できます。ファイル内容を自動修正することはありません。

CSVの項目数が違う行も確認できますか？

はい。ヘッダー列数と一致しないデータ行を検出し、先頭20件を表示します。