データ移行約5分で読めます

CSVの取り込み前の確認|列の順番と見出し

CSVの取り込み前の確認を表したイメージ
記事の内容を表したイメージ(AI生成)

CSVを取り込もうとしたら「列がずれた」「見出しが認識されない」という状況は、取り込み先のシステムが列の順番や見出し名を厳密に照合しているために起きます。ファイルを開いたときに値が正しく並んでいるように見えても、列の順番と見出し名のどちらか一方でも取り込み先の期待と違えば、データは別の列に入るか、エラーで止まります。

この記事では、取り込みを始める前に「列の順番」と「見出し行」の何をどの順で確認するかを整理します。見た目ではなく、取り込み先のテンプレートや仕様と照合する作業が中心です。特に、ファイルを目視で確認したつもりでも見落としやすいポイントを重点的に扱います。


取り込みが失敗する原因の多くは「順番」か「名前」のずれです

CSVの取り込みには大きく二つの方式があります。一つは列の順番で対応づける方式、もう一つは見出し名で対応づける方式です。どちらの方式かによって、事前に確認すべき点が変わります。

順番方式では、1列目が何という名前であっても「1列目の値を○○フィールドに入れる」と決まっています。見出し行を1行目のデータとして読んでしまうシステムもあります。見出し名方式では、列の順番が違っていても「"氏名"という列を探してその値を使う」ように動くため、見出し名の表記が一字でも違うと対応づけに失敗します。

どちらの方式かは、取り込み先のマニュアルや設定画面に「ヘッダー行あり/なし」「列の並び順に従う」などの記載で確認できます。画面の表示は版や設定により異なりますので、公式のヘルプで確認してください。


作業を始める前にファイルのコピーを残してください

確認作業でファイルを編集する場合があります。元のCSVは必ずコピーしてから作業を始め、元ファイルに上書きしないようにしてください。個人情報(氏名・住所・連絡先など)が含まれる名簿は、外部のWebサービスや生成AIにそのまま貼り付けず、社内のルールに従って扱ってください。


確認1:取り込み先が求める列の定義を先に手元に置く

CSVファイルを開く前に、取り込み先が指定する「列の定義」を確認します。多くのシステムはサンプルCSVかテンプレートファイルを配布しています。ない場合は、マニュアルの「インポート仕様」「フィールド一覧」に記載があります。

確認すべき内容は次の三点です。

  • 列の数と順番:何列目に何を入れるか。固定されているか、変えられるか。
  • 見出し行の有無:1行目を見出しとして読むか、データとして読むか。
  • 見出し名の表記:スペース、大文字・小文字、全角・半角の区別があるか。

この定義を手元に置いた状態で、次の手順に進みます。


確認2:ファイルの列の順番と見出し名を定義と照合する

テキストエディタかスプレッドシートで1行目を確認する

CSVをExcelやGoogleスプレッドシートで直接開くと、文字コードや区切り文字の設定によって列がひとつながりに見えることがあります。まずテキストエディタでファイルを開き、1行目の生のテキストを確認するのが確実です。

1行目の例(架空の例です):

氏名,ふりがな,メールアドレス,電話番号,登録日

この状態で、取り込み先の定義と1列ずつ照合します。

照合で確認すべき細かい点

目視だけでは見落としやすいポイントを以下に挙げます。

  • スペースの混入:氏名 と 氏名(先頭にスペース)は別の文字列として扱われます。見た目ではほぼ判別できません。
  • 全角・半角の違い:ID と ID、No. と No. のような全角・半角混在は見出し名の不一致になります。
  • 改行コードの混入:セルの中に改行が入っていると、1行が複数行に分割されて列数がずれます。テキストエディタで確認するとわかりやすいです。
  • BOM(バイト順マーク):Windowsで作成したUTF-8のCSVには先頭にBOMが付く場合があります。取り込み先によってはBOMを見出し名の一部として読み、先頭列の見出しだけが認識されないことがあります。

迷いやすい例外:見出し行があるのに「ヘッダーなし」で取り込んでしまう場合

架空の例です。取り込み先の設定で「ヘッダー行なし」を選んだまま、見出し行ありのCSVを取り込むと、「氏名・ふりがな・メールアドレス・電話番号・登録日」という文字列がデータの1件目として登録されます。システムがエラーを出さない場合、データを確認するまで気づかないことがあります。取り込み後に最初の1件を必ず目視で確認する習慣が有効です。


確認3:列数が定義と一致しているか数える

見出し名が合っていても、列数が定義と違う場合があります。途中の列が一つ欠けていると、それ以降の列が全体的に一つずれます。

列数を確認する簡単な方法として、スプレッドシートの場合はCOUNTA関数が使えます。

ExcelおよびGoogleスプレッドシート共通(見出し行が1行目の場合):

=COUNTA(1:1)

1行目にある値の入ったセルの数を返します。この数が取り込み先の定義の列数と一致しているか確認してください。

空白の列が途中に混入している場合、COUNTAは空白を数えないため、目視で確認するか、1行目全体を選択して列数をステータスバーで確認する方法もあります。


確認4:全データ行の列数が1行目と揃っているか確認する

見出し行の列数が正しくても、データ行の一部で列数がずれている場合があります。カンマを含む値がダブルクォートで囲まれていないと、区切り文字として誤認されて列が増えます。

スプレッドシートに取り込んだ状態で確認する場合、B列に各行の列数を出すとずれた行が見つけやすくなります。

ExcelおよびGoogleスプレッドシート(A列に全データが1セルに入っている場合):

=LEN(A2)-LEN(SUBSTITUTE(A2,",",""))+1

この数式はA2のカンマの数+1を返します(カンマ区切りの場合)。列数が違う行を見つけたら、その行のCSVの値を確認してください。ダブルクォートで囲まれていないカンマが含まれていないか確認します。


確認5:取り込みは少量のデータで先にテストする

確認が終わったら、全件をいきなり取り込まず、最初は数行だけのテスト用CSVで取り込みを試します。

テスト用のCSVには、通常の行に加えて次の行を一つ含めると有効です。

  • 値が空白の列がある行(必須項目の空白エラーを確認するため)
  • 値にカンマや改行を含む行(区切り文字の誤認識を確認するため)

テスト後に、取り込まれた結果が意図した列に入っているかを1列ずつ照合してから、本番のデータを取り込んでください。


次の行動

取り込み先のテンプレートかマニュアルを手元に出し、「列の順番と見出し行の扱い」の仕様を確認するところから始めてください。次に、テキストエディタでCSVの1行目を開き、仕様と1列ずつ照合します。照合が終わったら、数行のテスト用ファイルで取り込みを試してから本番データに進むと、やり直しのリスクを減らせます。

参考資料

この記事の本文はAI(Claude)が執筆しました。画面の表示や操作名は、アプリの版や設定によって異なります。実際の操作の前に元のファイルを複製し、公式のヘルプで最新の情報を確認してください。

記事の誤り・ファイルの不具合を知らせる · 修正記録

記事一覧へ