CSVの列ずれを直す：カンマ・引用符・セル内改行を架空データで確認

CSVを読み込んだら、商品名が隣の列へずれたり、1件のメモが複数行になったりすることがあります。最初に確認したいのは、文字コードよりも「区切り文字」と「引用符」です。ここでは架空データを使い、壊れる例と直す例を比べます。

カンマを含む商品名は引用符で囲む

見出しが3列なのに、次のデータ行には区切りとして解釈されるカンマが3個あります。

商品コード,商品名,数量
0012,ノート,青,2

商品名を「ノート,青」という1つの値として扱いたい場合は、次のようにダブルクォートで囲みます。

商品コード,商品名,数量
0012,"ノート,青",2

当工房で作成したCSV点検処理では、前者は4列、後者は3列として読み取れることを確認しました。見出しと列数が合わない場合、余った値を勝手に捨てずに確認対象とします。

セルの中の引用符は2つ重ねる

商品名に引用符そのものを入れるときは、外側を引用符で囲み、内部の引用符を重ねます。

商品コード,商品名,数量
0012,"ノート""青""",2

この例の2列目は、ノート"青"という文字列です。行を単純にカンマで分割するだけでは、引用された値を正しく扱えません。

セル内改行と、データ行の終わりを分ける

メモ欄に改行を含める場合も引用符で囲みます。引用符の内側の改行までデータ件数に数えると、実際より多く見えることがあります。当工房の処理では引用符内の改行を保持し、次のレコードの元行番号も確認しています。

修正する前のチェックリスト

  1. 元ファイルを別に保管する。
  2. 取り込み先がカンマ・タブ・セミコロンのどれを求めるか確認する。
  3. 見出しと各行の列数を比べる。
  4. 引用符の閉じ忘れがないか調べる。
  5. 修正後のファイルを再読込して、件数と文字を確認する。

前後の空白は値の一部である場合があります。列ずれの対策として、空白や引用符を一律に削除する方法は避けましょう。

検証範囲と参考資料

この記事は架空データと独自のCSV処理による検証に基づきます。すべての販売管理サービスへの取込を確認したものではありません。各サービスが指定する書式がある場合は、その仕様を優先してください。

参考：RFC 4180・CSV形式の説明。カンマ・改行・引用符の扱いを確認するために参照しました。

こつこつ実務工房は、AIを制作補助に使用し、例と計算を検証して公開しています。実際に確認した範囲と未検証の範囲を区別します。この記事にはアフィリエイトリンクはありません。

 

コメント

コメントを投稿

このブログの人気の投稿

CSVの差分比較で「全部変わった」と出たら：行順・比較キー・重複を確認する

更新前と更新後のCSVを比較すると、ほとんどの行に差分が出ることがあります。最初に確かめたいのは、比較結果が何を基準に行を対応付けたかです。同じ行番号同士を比較していると、並べ替えだけでも大量の違いが現れます。 この記事では、架空の商品在庫CSVを使い、並び順の違いと値の変更を分けて確認します。実際の顧客情報や取引データは使っていません。 4行すべてが違って見える例 次のCSVは、1行目が列名で、その下に4件のデータがあります。商品コードは先頭ゼロを含む文字列として扱います。 変更前： 商品コード,商品名,数量 00101,方眼ノート,12 00102,角形封筒,4 00103,紙クリップ,7 00104,無地カード,2 変更後： 商品コード,商品名,数量 00104,無地カード,2 00102,角形封筒,6 00101,方眼ノート,12 00105,仕切り紙,3 同じ位置のデータ行同士を比べると、4行とも内容が違います。しかし、商品コードを目印に同じ商品同士を対応付けると、確認対象は次のように整理できます。 商品コード 確認結果 内容 00101 値の変更なし 並び位置は変わったが、商品名と数量は同じ 00102 値の変更あり 数量が4から6へ変わった 00103 変更前だけに存在 変更後のCSVには含まれていない 00104 値の変更なし 並び位置は変わったが、商品名と数量は同じ 00105 変更後だけに存在 変更前のCSVには含まれていない この例は「追加1件・削除1件・値の変更1件・値の変更なし2件」です。追加と削除は、比較した2つのファイルに含まれるかどうかを表しています。元のシステムで新規登録や削除が行われたとまでは、このCSVだけでは判断できません。抽出条件が変わった可能性も確認します。 件数を確かめるなら、変更前は「削除1＋変更1＋変更なし2＝4件」、変更後は「追加1＋変更1＋変更なし2＝4件」と整理できます。前後とも4件だから更新内容が同じ、とはいえません。 比較キーを選ぶ前に確かめること この例では商品コードを比較キーにしました。ただし、実際のCSVでも商品コード1列でよいとは限りません。同じ商品が倉庫ごとに1行ずつある表なら、商品コードだけでは行を特定できません。 最初に、前後のファイルが同じ対象・同じ抽出条件のもの...
続きを読む

CSVの商品コード「00123」を守る：先頭ゼロが消えた場所を切り分ける

商品コード「00123」が「123」に見えるとき、元のCSVからゼロが消えたのか、開いたアプリが数値として解釈したのかを分けて確認します。慌てて上書きせず、元ファイルを残すのが最初の一手です。 まず、どこで変わったかを確認する 以下は架空の商品一覧です。商品コードは計算用の数量ではなく、照合用の識別子として扱います。 商品コード,商品名,数量 00123,ノート,2 01230,封筒,10 元のCSVをテキストエディタで開き、00123と書かれていれば、少なくとも元ファイルにはゼロが残っています。表計算で123と見えた場合は、取込時の型変換を疑います。元のCSV自体が123になっていた場合は、表示設定を変えるだけでは元の桁数は分かりません。 数量とコードを同じ「数値」にしない 数量2と10は合計できますが、00123を123へ変えると、別のコードとの区別を失う場合があります。当工房では、項目の用途を先に決める方法を勧めています。「計算する列」「照合する列」「自由記入の列」を短いメモにすると、取り込み設定を決めやすくなります。 Excelは取り込む段階で文字列として扱う Microsoftの公式案内では、先頭ゼロを残す方法として、テキスト／CSVからの取り込みで対象列をテキスト型にする方法が説明されています。単純にCSVを開く場合と取り込み操作では結果が異なることがあります。使用するExcelの版に合う手順を確認してください。 Power Queryを使う場合も、数値へ変換してゼロが落ちた後に文字列へ変えるだけでは元に戻りません。適用したステップを確認し、コードが数値へ変換される前の段階から扱いを見直します。 参考： Microsoft公式：先頭ゼロと大きな数値の保持 。この記事ではExcel実機での操作検証は行っていません。 桁を補う前に、元データと照合する 「全部5桁だからゼロを足す」と決めつけるのは避けます。コードには桁数が異なる体系が混在している場合があります。受領元の仕様に5桁固定と明記され、元の一覧と照合できる場合にだけ補正し、補正した行を記録します。 受け渡し時に残す確認メモ 商品コード列は文字列として扱う 元ファイルの00123と01230を取り込み結果で照合した 数量列は2と10のままであることを確認した 保存したCSVをテキストで開き直し、ゼロが残...
続きを読む

CSVを提出する前に残す確認メモ：件数・変更点・未確認を短く記録する

提出したCSVについて「どこを直しましたか」と聞かれたとき、作業内容を思い出すところから始めると、確認に時間がかかります。短い確認記録を一緒に残しておけば、修正の意図と次に調べる場所を伝えやすくなります。 ここでは、架空の小さな商品一覧を例に、提出前の確認メモを作ります。法定帳簿や監査証跡の要件を定めるものではなく、日常の受け渡しのための作業例です。 「処理したこと」と「確認したこと」を分ける 空白を削除するボタンを押したことと、商品名の意図した空白だけが変わったことは別です。メモには処理の名前だけでなく、処理後に照合した項目を書きます。「整形済み」「確認OK」だけでは、別の人が確認範囲を判断できません。 受領・作業・提出のファイルを区別する 受け取った元ファイルを保管し、コピーを作業用にします。提出するファイルには日付と版を付け、メモにも同じ名前を書きます。ファイル名のルールは取引先の指定を優先してください。差し替え時には、古い提出物を黙って上書きするより、版と変更理由を記録すると追いやすくなります。 架空の記入例 対象：20260909_商品一覧_提出用_v02.csv 元データ：受領_商品一覧.csv 作業：商品名の前後空白を1セル修正 件数：データ2行 → 2行（見出しを除く） 列：商品コード・商品名・数量の3列 残したもの：商品コード00123、01230の先頭ゼロ 重複：同一文字列の行はなし 保存後：日本語・列数・数量を開き直して照合 未確認：相手先システムへの実際の取り込み 次の確認：担当者がテスト環境で取り込む この数字は説明のための架空例です。実際の作業では、処理結果から数えた値に置き換えます。CSVのセル内に改行がある場合、テキストの行数とデータ件数は一致しないことがあります。見出しを含めるかどうかも明記します。 提出前に確認する4点 対象： メモに書いたファイルと、実際に添付するファイルが同じか。 構造： 列名・列順・データ件数が想定と合うか。 意味： コード、数量、日付など、重要な値を元データと照合したか。 保存後： 画面だけでなく保存ファイルを開き直したか。提出先への取込はどこまで試したか。 同じファイルかを比べたいとき 添付やコピーの前後で同一性を確認する補助手段として、ファイルのハッシュ値を比較する方法があります。PowerShellの...
続きを読む