n8nでデータ処理（CSV/JSON/API連携）

はじめに

この記事は「n8n学習シリーズ」のSTEP 05（データ）です。ファイルとHTTP APIから入ってきたデータを、集計・変換・フィルタする典型パターンを学びます。

学習の目標

CSV/JSONをアイテム列に展開し、必要列だけ残せる
HTTP Requestノードで認証ヘッダとページネーションの考え方を説明できる
欠損や型ゆれに耐えるミニバリデーションを入れられる

前提知識

STEP 03〜04（ノードと最小フロー）
RESTのGET/POSTとJSONのキー構造を辞書レベルで理解していること

用語ミニ辞典

ページネーション: 大量データを複数リクエストに分割して取得する方式
スキーマ: 期待するキー名・型・必須／任意
バッチ: まとめて処理する単位（件数／時間窓）

ステップバイステップで進める

取り込み元（ファイルアップロード、定期取得URL、S3等）を1つに絞る
Spreadsheet／Extract From Fileなどで行に分解し、ヘッダ名を確認する
SetまたはCodeで型整形（日付パース、数値へのキャスト）を入れる
HTTP Requestで外部APIへ送る場合はレート制限とタイムアウトを設定する
失敗行を別ストアに逃がすか、エラー通知へ渡す分岐を用意する

ミニ課題

10行のCSV（名前・数量・単価）を用意し、総額列を追加してから、8000円以上のみ次ノードへ通すフローを組んでください。欠損行は errors 配列に溜める設計メモも書きます。

理解度チェックリスト

[ ] 入力行と出力行の対応が追える
[ ] APIの401/429が起きたときの行動方針がある
[ ] 一時ファイルやキャッシュの扱いを説明できる

よくある落とし穴

文字コードと区切り: Shift-JISやタブ区切りでパースが静かに失敗する
巨大JSON: メモリとログが膨らみ実行が不安定になる
本番データを検証フローへ: 誤送信や誤更新の原因になる

もう一歩掘り下げる

データ処理は観測可能性が生命線です。サンプル件数・処理時間・失敗件数を通知やメトリクスに載せると、夜間バッチでも安心です。冪等性（同じ入力で二重実行しても壊れないか）も、API連携では早めに検討してください。

学びを固める（追補）

データ連携は「正しい1件」より壊れた1件の扱いが運用品質を決めます。ページネーションや429は実装の必須話題なので、公式ドキュメントのレート制限を読み、スリープや分割件数を最初から入れておくと夜間ジョブが安定します。

シナリオ演習（20分）

APIレスポンスを擬似JSONで用意し、欠損キー・型不一致を混ぜます。どのキーを必須検証にするかリスト化し、失敗行の通知文面を草案します。

今日の振り返り（3問）

文字コードと区切り文字は確認したか。
再実行時の冪等性は意識できているか。
一時ファイルやキャッシュの寿命は決まっているか。

深読みメモ（現場向け）

CSVは文字コードとクォートで静かに壊れます。取り込み時にヘッダー行の正規化（前後空白削除、重複回避）を入れると下流が楽です。APIの429は「待てば直る」ではなく設計問題のサインでもあり、バッチ分割と指数バックオフをセットが実戦解です。データ検証は全部を厳密にしないでよく、ビジネスクリティカル列だけ必須に絞ると運用が続きます。

自習リフレクション（読了後5分）

手元のCSVサンプルで文字コードをfileコマンドやエディタ表示で確認し、n8n側の設定と一致させます。APIの429を意図的に起こしにくいので、公式のレート記載をコピペしてメモしてください。欠損行の扱いをビジネスオーナーに1問確認し、回答をRunbookに残します。

クイック参照（紙に写す用）

文字コードと区切りを最初に確認。429は分割＋バックオフ。スキーマは重要列だけ必須。件数ログを毎回。冪等性を疑う。ページネーションは公式に従う。失敗行を別ストアへ。

読了後の一行メモ

この回の学びを140字以内で要約し、翌週の業務で一度だけ実践してみてください。音声メモに3分解説を録音し、未来の自分への手紙として残すと抜けが見えます。勉強会に使う場合はチェックリストを印刷して自己採点してから終えると定着します。公式ドキュメント・料金・UIは更新されるため、手順と数値は必ず最新情報で再確認してください。改善アクションは1つに絞ると実行率がもっとも高くなります。

連載を順に進めるときは「前章のチェックリストが緑になるまで次へ進まない」ペースが安全です。分からない用語はその場で検索せず、一度記録だけして後で3語に圧縮すると記憶に残ります。業務と学習の境目で迷ったら、公開情報とダミーデータだけで試すセーフティゾーンを先に決めてから触れてください。

次にやること

STEP 06でAIノードを挟み、整形後テキストを生成する
外部APIのスキーマ変更検知（契約テスト的なサンプル）を1本入れる

ツール情報

公式サイト: n8n
ツール概要: HTTPとファイル系ノードの組み合わせでETL風処理を構築しやすい

権利表記

n8nは各社の商標または登録商標です。本記事は公式提供ではなく、一般的な情報提供を目的としています。

画像クレジット

サムネイル画像はUnsplashのライセンスに基づき使用しています。

お問い合わせ

AIツールの導入・活用支援のご相談はお気軽にどうぞ

📞 090-6262-3842