はじめに
実際の自動化ワークフローでは、データは決して一直線に流れるとは限りません。CRM から顧客レコードを1つのブランチで取得し、別のブランチで API から最近の注文を引き出し、それら2つのストリームを統合して downstream に渡す前に統合したいことがあります。これこそが Merge ノードが処理することです。
Merge ノードは Input 1 と Input 2 の2つの独立した入力ブランチを受け取り、選択した戦略に従ってアイテムを結合します。マージモードを誤ると、表面的には結合しているように見えても出力が期待通りでないデータのバグの原因となることが最も一般的です。前もってモードの違いを理解しておくと、その後のデバッグが大幅に楽になります。
Four Merge Modes
N8n の Merge ノードには4つのモードが存在します:Append、Combine by Position、Combine by Key、Multiplex。それぞれが、2つのブランチからのアイテムが互いにどのように関連するべきかという異なる問いに答えます。
Append は単純に両方のリストを連結します。Input 1 の各アイテムを先頭に、続いて Input 2 の各アイテムを配置します。結合は行われません。独立した2つのブランチを持ち、1つのフラットなリストを作成したい場合、例えば2つのメールアドレスリストを1つのキャンペーン送信に結合する場合に適しています。
Combine by Position(以前は Merge by Index と呼ばれていました)は、リスト内の順序に従ってアイテムをペアリングします。Input 1 のアイテム0は Input 2 のアイテム0と結合し、アイテム1はアイテム1と結合します。両方のアイテムのフィールドは1つのオブジェクトにマージされます。リストの長さが異なる場合、デフォルトで短いリストが出力数を決定します。
Combine by Key は、共通のフィールド値を使用して2つのブランチのアイテムを照合します。SQL のJOIN のように、各入力でキー フィールドを指定します(フィールド名は異なる場合があります)。n8n は値が一致するペアを見つけます。
Multiplexは入力1と入力2のアイテムのすべての組み合わせ、すなわちデカルト積を出力します。入力1が3アイテム、入力2が4アイテムの場合、Multiplexは12アイテムを出力します。これはほとんどの場合望まれるものではありませんが、すべての製品をすべてのディスカウント階層と組み合わせるといった組み合わせを生成するには有用です。
実用例:Keyによる結合
HTTPリクエストノードが1つのブランチで顧客プロファイルを返すとします:
そして別のHTTPリクエストが別のブランチで注文合計を返すとします:
アイテムは異なる順序であり、同じ顧客識別子のためのフィールド名も異なります。MergeノードをKeyによる結合に設定すると、Input 1のKey FieldをcustomerId、Input 2のKey Fieldをidとして構成します。N8nは順序に関係なくC001をC001、C002をC002と照合し、次のように出力します:
Input 1に対応するがInput 2に対応するアイテムがないものはデフォルトで削除されます。Output Typeオプションでこの動作を変更し、Input 1、Input 2、または両方の未照合アイテムを保持するように選択できます — SQLのLEFT、RIGHT、またはFULL OUTERジョインに相当します。
Combine by Positionの例
Combine by Positionは、2つのブランチが常に同じ数のアイテムを同じ順序で生成することを前提にする場合に適しています。典型的なケースはリストを分割し、並列で2つの異なるAPIを介して各アイテムをエンリッチし、それからエンリッチされた結果を再結合することです。
Input 1がベースのユーザーレコードを保持し、Input 2がスコアリングサービスのスコアを保持する場合:
Combine by Positionはインデックスでこれらを結合して次のようになります。
このリストを50人のユーザーで2つのブランチに分けて実行した場合、順序が保持される限りすべての50アイテムが正しく結合されます — これは両方のブランチがSplit in BatchesやSplitOutノードの同じ開始点から始まる場合、通常そうなるためです。
共通のミス
最も頻繁なミスは、2つの分岐が異なる速度でアイテムを処理したりフィルタリングを適用したりしている場合に、Combine by Position を使用するとリストが同期を外してしまうことです。マージは間違ったアイテムを silently ペアにします。順序が異なる可能性がある場合は、代わりに Combine by Key を使用してください。
別の問題は、両方の分岐が実行を完了する前に Merge ノードをトリガーしてしまうことです。n8n では Merge ノードは入力の両方が到着するまで自動的に待機しますが、これは同じ上流ノードから派生した場合にのみ正しく機能します。関連性のないトリガーパスを Merge ノードに接続して同期を期待すると、動作は未定義となり、しばしば重複実行が生じます。
最後に、フィールド名の衝突に注意してください。2つのアイテムが同じフィールド名を共有して結合すると、デフォルトでは Input 2 の値が Input 1 の値を上書きします。両方の値を保持する必要がある場合は、マージ前に Set ノードで upstream 側の衝突するフィールド名を変更してください。
Summary
Merge ノードは n8n におけるマルチブランチ・ワークフローの backbone です。Append はリストを積み重ね、Combine by Position は順序でアイテムをペア付け、Combine by Key は共通のフィールド値でアイテムを結合、Multiplex はすべての組み合わせを生成します。鍵となる決定は、常に2つのデータストリームが構造的な関連を持つかどうかです—もし持つなら信頼性のために Combine by Key を使用してください。順序が保証され、長さが等しい場合は Combine by Position の方が単純です。この選択を正しくすることで、微妙なデータ整合性バグの全クラスを防げます。
レッスンのチェックポイント
学んだ内容を復習し、回答へのフィードバックを受けましょう。