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

CSVの件数が合わない|空行と重複

CSVの件数が合わないを表したイメージ
記事の内容を表したイメージ(AI生成)

CSVの件数が合わないときは、削除を始める前に「何を1件と数えたか」を揃えます。テキストの行数、CSVとして読み取ったレコード数、取り込みに成功した件数は同じとは限りません。

以下では架空の8件を使い、改行・空欄・重複を区別します。実ファイルは原本を残し、コピーで確認してください。

まず三つの数を分ける

表は横にスクロールできます

数える対象意味ずれる例
テキストの行数改行で区切った物理的な行引用符で囲んだ備考に改行がある
CSVのレコード数引用符と区切りを解釈した行。ここではヘッダーを除く全列空欄のレコードも含まれる
登録成功件数受入先が実際に登録した数必須項目エラー、重複判定、既存データの更新

CSVでは、引用符内の改行やカンマは同じフィールドの内容になります。ファイル末尾に一つ改行があること自体は、空レコードが増えた証拠ではありません。これはRFC 4180のCSV形式の説明でも区別されています。実際の受入先には独自仕様があるため、その取り込みログと突き合わせます。

8件のファイルを調べる

件数・重複の確認用CSVをダウンロード。UTF-8 BOM付き、3列(id・name・note)、ヘッダー1行です。実在の個人情報は含みません。CSVチェックでも確認できます。

次の「番号」はヘッダーを除くCSVレコードの順番です。テキストエディタの行番号とは異なります。

表は横にスクロールできます

番号id内容確認する点
11001Sample A / received4と全列一致
2空欄3列とも空文字CSV上では ,, と書かれた1件
31002note内に1か所の改行改行を含むが1件
41001Sample A / received1と全列一致
51003noteに red,blue引用符内のカンマは列の区切りではない
61002noteが revised3とIDが同じで内容が異なる
7半角スペース3個他の2列も半角スペース1個ずつ空文字ではない
81004noteに said "OK"引用符のエスケープを含む

このファイルを、空白を自動で取り除かずCSVとして解析した期待値は次のとおりです。

表は横にスクロールできます

確認項目期待値
ヘッダー込みの物理行数10行
ヘッダーを除くレコード数8件
全列が空文字のレコード1件(番号2)
全列が半角スペースのみのレコード1件(番号7)
上記2種類を除いたレコード6件
全列一致の重複グループ1組(番号1・4)
同じグループで先頭1件を除いた余分な件数1件
空・空白のみのIDを除いたID重複グループ2組(1001・1002)
空・空白のみのIDを除いた異なるIDの数4個

6件から全列一致の重複1件を除けば5件ですが、それが登録すべき件数だとはまだ決まりません。ID 1002の2件を別の記録として扱うか、同じ対象の更新として扱うかは、受入先と業務の仕様で決めます。

Excelで見るときは元の列を上書きしない

CSVは文字列として取り込む方法で読み込みます。取り込み時に空行削除などの変換を加えず、練習ファイルのヘッダーが1行目、8件が2〜9行目に並ぶことを先に確認してください。以下の式はその配置を前提にします。実ファイルでは範囲をデータに合わせます。

D列でIDの重複候補を数える

D1を「ID件数」とし、D2へ次の式を入れ、D9までコピーします。A列には入力しません。

=IF(LEN(TRIM(A2))=0,"",COUNTIF($A$2:$A$9,A2))

この練習データでは1001と1002の行が2、1003と1004の行が1になります。空欄・半角スペースだけのIDは表示を空にします。COUNTIFは大文字小文字を区別せず、条件の * や ? をワイルドカードとして扱うため、任意の文字列IDを厳密に比較する式としてはそのまま使えません。MicrosoftのCOUNTIF説明も確認してください。

E列で全列空欄の候補を見る

E2へ次の式を入れ、E9までコピーします。

=COUNTA(A2:C2)

全列が本当に空の番号2は0ですが、スペース入りの番号7は3になります。COUNTAはスペースのほか、数式が返す空文字 "" も数えます。A列だけが空でも、B・C列に記録があれば行全体が空とはいえません。MicrosoftのCOUNTA説明がこの区別の基準です。

F列で半角スペースだけの行も候補にする

F2へ次の式を入れ、F9までコピーします。

=SUMPRODUCT(--(LEN(TRIM(A2:C2))>0))

この練習ファイルでは番号2・7の両方が0になります。TRIMで処理するのは通常の半角スペースです。全角スペースや改行など、あらゆる空白文字を除ける式ではありません。また空白が業務上意味を持つ列もあります。0の行を見つけても、元データを確認するまで削除しません。

=COUNTA(A2:A9) はこの例では7です。スペースだけのIDも数えるので、有効なレコード数6とは一致しません。ヘッダーを含まない範囲にさらに「−1」を付ける必要もありません。

削除や統合は候補を確認してから

全列が一致していても、同内容の取引が実際に2回あった可能性は残ります。「重複の削除」を使う前に、元システムの記録番号・日時や出力条件を照合します。IDだけ同じで内容が違う場合も、新しい方を機械的に残すとは決めません。

コピーしたファイルで、対象のレコード番号、変更理由、変更前後の件数を記録します。不要な作業列D〜Fを出力対象から外し、指定の文字コード・列順で別名保存します。フィルターで非表示にする操作と、CSVから対象を取り除く操作は同じではないので、保存後のファイルを再確認してください。

なお、Ctrl+Endの移動先には書式設定だけのセルが影響することがあります。最終データ行や件数の根拠にはしません。

受入先の結果と照合する

確認後も件数が合わない場合は、取り込みログから「新規登録」「既存データの更新」「失敗」「スキップ」を分けます。例えば送信5件のうち新規3件・更新1件・失敗1件なら、一覧が3件しか増えないこと自体は矛盾ではありません。この数字は説明用の架空例です。

ヘッダーの重複混入、必須項目、文字数、日付形式、IDの重複規則を失敗ログと照合します。CSV取り込み前のチェックリストで受入仕様を整理し、CSVの引用符や区切りから確認したい場合はCSVの基本に進んでください。

この記事の確認用ファイル

架空データの記入例や、手元で確認するための素材です。

参考資料

2026年11月9日、Microsoft公式資料とRFC 4180を照合し、件数式、空欄判定、元のID列を上書きする説明を修正しました。練習データは当サイト作成の架空例です。Pythonのcsvモジュールで8件・3列、引用符内改行、空欄・重複の期待値を確認しました。Excel実機での関数実行・画面操作、受入先システムでの登録結果は未検証です。本文の作成・改訂にはAIを使用しています。

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

記事一覧へ