Как объединить данные в n8n через Merge по полю

Соберите две ветки в ноде Merge по общему полю: задайте Matching Fields, выберите Output Type, настройте Include Any Unmatched и проверьте результат.

Когда нужно понять, как объединить данные в n8n через Merge по каналу, выберите Combine → Matching Fields и укажите поле channel в обоих входах. Merge соединяет потоки, когда данные всех потоков доступны [1]. В учебном примере Keep Matches даст одну строку с расходами и заявками по search, а Keep Non-Matches отдельно покажет social и email.

Два входа штатными узлами и структура элементов

В n8n все данные между узлами — массив объектов: каждый элемент оборачивается в объект с ключом json [3]. Поля внутри json — произвольные. Такая структура позволяет Combine сопоставлять сразу два потока [1].

Учебный пример

Подготовьте два входа так же, как это делает справка Merge в своём пошаговом примере: к запускающему узлу подключены две параллельные ветки Code, каждая возвращает через return массив из двух items [1]. Ветку расходов соедините с Input 1, ветку заявок — с Input 2, затем выполните workflow, чтобы оба входа загрузились в Merge [1].

Ветка расходов — расходы по каналам за 1–7 ноября 2026, рубли:

return [
  { json: { channel: "search", spend: 12000 } },
  { json: { channel: "social", spend: 9000 } }
];

Ветка заявок — заявки по каналам за тот же период:

return [
  { json: { channel: "search", leads: 30 } },
  { json: { channel: "email", leads: 12 } }
];

Обёртка { json: {…} } здесь — структура items между узлами, а не строка, которую целиком вставляют в JSON Output узла Set. Ключ channel есть в обеих ветках, значит есть по чему сопоставлять.

Combine → Matching Fields по полю channel

Дальше настройте Merge:

  • Mode → Combine.
  • Combine by → Matching Fields.
  • Fields to Match: в Input 1 Field — channel, в Input 2 Field — channel.

По умолчанию Matching Fields сохраняет совпавшие элементы [1]. Combine работает с двумя входами, поэтому к Merge подключены ровно Input 1 и Input 2 — это важно до версии 1.49.0, где больше входов не поддерживалось [1].

Matching Fields сравнивает значения указанных полей [1]. Перед сопоставлением приведите названия каналов к единому формату: это поможет проверить, какие значения должны образовать пары.

Output Type: Keep Matches и другие варианты

Output Type определяет, что node отдаст [1]:

  • Keep Matches — совпавшие элементы, аналог inner join.
  • Keep Non-Matches — элементы без пары.
  • Keep Everything — совпавшие и несовпавшие вместе, аналог outer join.
  • Enrich Input 1 — все данные Input 1 плюс совпавшие из Input 2, аналог left join.
  • Enrich Input 2 — все данные Input 2 плюс совпавшие из Input 1, аналог right join.

Для контрольного результата выберите Keep Matches. Если нужно сохранить обе строки расходов, включая social без заявок, используйте Enrich Input 1: он оставляет данные Input 1 и добавляет совпавшие данные Input 2 [1].

Отдельно посмотрите на Options → Include Any Unpaired Items: при Combine по Position он сохраняет элементы без пары [1]. Для Matching Fields выбирайте несовпавшие элементы через Output Type → Keep Non-Matches.

Почему не Combine by Position

Combine by Position соединяет элементы по порядку: элемент с индексом 0 из Input 1 идёт с элементом с индексом 0 из Input 2 [1]. Канал при этом не учитывается. В наших входах первая пара случайно совпадёт: search, расход 12000 и 30 заявок. Вторая пара будет ошибочной: расход 9000 канала social соединится с 12 заявками канала email. Выводы из такого отчёта будут содержать чужую пару; чтобы этого не случилось, в Matching Fields явно задаётся ключ сопоставления [1].

Контроль результата: совпавший и несовпавший канал

Учебный пример

При Output Type: Keep Matches и Matching Fields channel в учебном прогоне ожидается один item:

[
  { "json": { "channel": "search", "spend": 12000, "leads": 30 } }
]

Несовпавший канал — social из Input 1 и email из Input 2 — в Keep Matches не выходит. Чтобы увидеть их отдельно:

  1. Скопируйте Merge и поставьте Output Type Keep Non-Matches — получите элементы без пары: social и email.
  2. Поставьте Keep Everything — увидите совпадение search и оба несовпавших элемента в одном результате.

Проверка после прогона:

  • В Keep Matches ровно один item, его channel — search, а spend и leads лежат рядом.
  • В Keep Non-Matches ровно два item: social и email.
  • Если результат отличается от ожидаемого, проверьте данные обоих входов, Combine by, поля сопоставления и Output Type, затем повторите Execute step. По одному числу item причину ошибки определить нельзя.

Что проверить перед продакшеном

  • Проверьте типы ключей: по умолчанию Fuzzy Compare выключен. При включении n8n считает число 3 и строку "3" одинаковыми [1].
  • Если в реальных данных канал приходит кодом или номером, сначала нормализуйте его значения в обеих ветках.
  • Для этого примера проверьте: один канал — одна строка расхода и одна строка заявок. При повторных ключах учитывайте Multiple Matches: Include All Matches выдаёт item для каждого совпадения, а Include First Match Only сохраняет первое и отбрасывает остальные [1].
  • Когда потоки приходят из API, структуру { json: {...} } держите на каждом элементе — Merge ожидает её [3]. Подробнее про форматы обмена данными — в материале про JSON и API.
  • Повторные запуски вебхуками разбирайте отдельно, чтобы не задваивать строки — базовый разбор в статье про повторные запросы и retry.

Порядок применения: две ветки Code с channel → Combine → Matching Fields → Output Type → проверка по числу item. Если после Keep Matches получается одна строка search, а Keep Non-Matches показывает social и email, задача сведена корректно.

Источники

  1. Mergedocs.n8n.io
  2. Understand n8n's data structure | Build | n8n Docsdocs.n8n.io

Валерий Курземнек

Автор метода «Машиночитаемый маркетинг»

Что ещё почитать