
CSVが読めない? n8nのExtract From Fileで入口と列を確かめる
CSVを受け取れたのに、次のノードで列が見つからない。そんなところで止まっていませんか?
ファイルが届くことと、その中身を使える形にすることは別の確認です。今回は、n8nのExtract From FileでCSVを読むとき、最初に見る場所を整理します。
この記事でわかることは、入力ファイルの項目名の合わせ方、CSVを読み取る操作の選び方、出力で確かめたい三つの点です。例はすべて架空です。
結論:入力の名前と、出力の中身を一組で見る
Extract From Fileは、バイナリ形式で届いたファイルをJSONとして扱える形へ変換するノードです。CSVなら操作にExtract From CSVを選びます。設定が終わっても、成功表示だけで完了にしないことが大切です。
入力側では「どの項目にファイルが入っているか」。出力側では「何件になり、どの列に何が入ったか」。この二つを照合しましょう。

1. ファイル名と、Binaryの項目名を区別する
たとえば受け取ったファイル名がorders.csvでも、n8nのBinary側でそのファイルを持つ項目名がdataなら、Input Binary Fieldに指定するのはdataです。ファイル名をそのまま入力する欄ではありません。
公式資料では、この入力欄の既定値はdataです。ただし、前段のノードが別の項目名で渡す場合もあります。既定値を信じて進めず、前段の出力にファイルが実際に存在するか、その項目名が何かを確認してください。
ファイルがない状態なら、まず取得側を確認します。項目名の変更だけで取得失敗を直そうとすると、原因を見失いやすくなります。
2. 小さなCSVで、期待する結果を先に書く
最初は本物の顧客一覧ではなく、架空の二行を用意します。列はorder_id、product、quantity。データはA001・ノート・2と、A002・ペン・1の二件です。先頭行は列名として使う想定にします。
この例で確認したいのは「二件ともある」「列名が三つに分かれる」「A001の数量が2に対応する」の三点です。実際の出力がこの想定と違ったら、そのまま次の更新処理へ進めません。
利用中の画面でヘッダー行の扱いを確認し、出力された項目名を見てから後続ノードの参照を作ります。ここでは具体的な出力形式を実機で確認していないため、画面のキー名や値の型まで断定しません。
3. 一列に固まる、途中からずれるときの見方
元ファイルがセミコロンやタブ区切りなのに、カンマ区切りとして読まれていないでしょうか。公式資料では、区切り文字の不一致によって、エラーが出ず一列になる場合が説明されています。
また、値の中にカンマや改行を含める場合は、CSVとして正しく引用符で囲む必要があります。引用符の閉じ忘れなどで、複数行が一つに見えたり、列の対応が崩れたりすることがあります。
まず元ファイルの該当行と出力を並べ、どこから違うかを探します。読み取りの条件をむやみに緩めるより、出力元の区切り方や引用符を直せるか確認する、という順番がおすすめです。
4. 転記につなぐ前の確認メモを残す
確認メモには、使ったサンプル、入力の項目名、想定した件数、実際の件数、列名と値の対応を残します。今回は手順の説明であり、n8n上で実行した結果は記録していません。
二行の正常例を確認できたら、次は空欄を含む行や、値にカンマが入る行を加えます。読めた件数だけでなく、どのIDにどの値が付いたかも見ましょう。元データの意味が保たれていると確認してから、表への転記などを接続します。
まとめ:受け取れた、読めた、使えるを分ける
CSV取り込みでは、ファイルの受け取り、構造の読み取り、業務で使う値の確認を順に進めます。入口の項目名と出力の中身を一組で記録すると、どこを見直すべきか説明しやすくなります。
毎月届くCSVの転記を自動化したい方へ。入力ファイルの揺れや確認方法から、ツナギシステムズにご相談いただけます。
出典・確認範囲
n8n公式「Extract From File」:対応する操作、Input Binary Field、CSV読み込み時の注意点を参照しました。
https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.extractfromfile/
資料確認日:2026年11月16日。公式資料に基づく解説です。この記事の例は架空データであり、筆者によるn8n実機検証は未実施です。設定名や表示は利用中のバージョンで確認してください。