メインコンテンツへスキップ
見出し画像

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の転記を自動化したい方へ。入力ファイルの揺れや確認方法から、ツナギシステムズにご相談いただけます。

    https://tsunagisystems.com/

    出典・確認範囲

    n8n公式「Extract From File」:対応する操作、Input Binary Field、CSV読み込み時の注意点を参照しました。

    https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.extractfromfile/

    資料確認日:2026年11月16日。公式資料に基づく解説です。この記事の例は架空データであり、筆者によるn8n実機検証は未実施です。設定名や表示は利用中のバージョンで確認してください。

     
     
    n8nで、毎日の手作業を少しずつ自動化。初心者向けの使い方、ツール比較、つまずきの解決策を届けます。運営:TsunagiSystems。導入・構築のご相談はこちら。https://tsunagisystems.com/

    あなたへのおすすめ