Skip to content

合并节点#

使用 Merge 节点可以在所有数据流的数据都可用时，合并来自多个流的数据。

0.194.0 版本重大变更

n8n 团队在 0.194.0 版本中全面改进了此节点。本文档反映的是该节点的最新版本。如果您使用的是旧版 n8n，可以查看此文档的历史版本。

1.49.0 版本次要变更

n8n 1.49.0 版本新增了支持两个以上输入的功能。旧版本仅支持最多两个输入。如果您运行的是旧版本并希望在这些版本中合并多个输入，请使用代码节点。

模式 > SQL 查询功能也是在 n8n 1.49.0 版本中添加的，旧版本不可用。

节点参数#

您可以通过选择模式来指定 Merge 节点应如何合并来自不同数据流的数据：

追加(Append)#

保留所有输入的数据。选择输入数量来依次输出每个输入的项目。节点会等待所有连接的输入执行完毕。

追加模式示例输入和输出。左侧是两个独立的数据源，一个包含项目 A、B、C，另一个包含 D、E、F。最终数据源合并两者并列出 A、B、C、D、E、F。
追加模式的输入和输出

组合(Combine)#

合并两个输入的数据。在组合方式中选择一个选项来决定如何合并输入数据。

字段匹配#

通过字段值比较项目。在待匹配字段中输入您想要比较的字段。

n8n 的默认行为是保留匹配项。您可以通过输出类型设置来改变这一行为：

  • 保留匹配项：合并匹配的项目。类似于内连接(inner join)。
  • 保留非匹配项：合并不匹配的项目。
  • 保留所有项：合并匹配的项目并包含不匹配的项目。类似于全外连接(outer join)。
  • 增强输入1：保留输入1的所有数据，并添加输入2的匹配数据。类似于左连接(left join)。
  • 增强输入2：保留输入2的所有数据，并添加输入1的匹配数据。类似于右连接(right join)。
字段匹配模式的输入输出示例。左侧是两个独立数据源，最终数据源通过匹配字段合并这些数据源
字段匹配模式的输入输出

位置匹配#

根据项目顺序进行合并。输入1中索引0的项目将与输入2中索引0的项目合并，依此类推。

位置匹配模式的输入输出示例。左侧是两个独立数据源，最终数据源通过索引位置合并这些数据源
位置匹配模式的输入输出

全组合模式#

输出所有可能的项目组合，同时合并同名字段。

全组合模式的输入输出示例。左侧是两个独立数据源，最终数据源通过所有可能组合合并这些数据源
全组合模式的输入输出

合并模式选项#

当通过 模式 > 合并 方式合并数据时，您可以设置以下 选项：

  • 冲突处理：选择当数据流冲突或存在子字段时的合并方式。详情请参阅冲突处理。
  • 模糊比较：是否在比较字段时容忍类型差异（启用）或严格比较（禁用，默认）。例如启用时，n8n 会将 "3" 和 3 视为相同值。
  • 禁用点表示法：阻止在字段名中使用 parent.child 形式访问子字段。
  • 多重匹配：选择 n8n 在比较数据流时如何处理多个匹配项。
    • 包含所有匹配项：如果存在多个匹配项，则输出多个条目，每个匹配项对应一个条目。
    • 仅包含首个匹配项：保留每个匹配项的第一个条目，丢弃其余多个匹配项。
  • 包含未配对项：选择在按位置合并时是否保留未配对项。默认行为是排除没有匹配项的条目。
冲突处理#

如果在同一索引位置的多项数据中存在同名字段，就会发生字段冲突。例如，如果输入1和输入2中的所有项目都有一个名为 language 的字段，这些字段就会发生冲突。默认情况下，n8n 会优先处理输入2，这意味着如果 language 在输入2中有值，n8n 在合并项目时会使用该值。

您可以通过选择 选项 > 冲突处理 来更改此行为：

  • 当字段值冲突时：选择要优先处理的输入源，或选择 始终在字段名后添加输入编号 来保留所有字段和值，同时在字段名后附加输入编号以显示其来源。
  • 嵌套字段合并
    • 深度合并：合并项目所有层级的属性，包括嵌套对象。当处理复杂的嵌套数据结构时，这能确保合并所有层级的嵌套属性。
    • 浅层合并：仅合并项目顶层的属性，不合并嵌套对象。适用于扁平数据结构或只需合并顶层属性而无需考虑嵌套属性的情况。

SQL 查询#

编写自定义 SQL 查询来合并数据。

示例： 

1
SELECT * FROM input1 LEFT JOIN input2 ON input1.name = input2.id

来自先前节点的数据可作为表使用，您可以在 SQL 查询中按顺序将它们引用为 input1、input2、input3 等。完整支持的 SQL 语句列表请参考 AlaSQL GitHub 页面。

选择分支#

选择要保留的输入。此选项始终会等待两个输入的数据都可用。您可以选择 输出：

  • 输入1数据
  • 输入2数据
  • 单个空条目

该节点会输出所选输入的数据，不做任何修改。

模板与示例#

Browse 合并节点 integration templates, or search all templates

合并数量不等的数据流#

传入 Merge 节点 Input 1 的数据项将优先处理。例如，如果 Merge 节点在 Input 1 收到 5 项数据，在 Input 2 收到 10 项数据，则只会处理 5 项数据。Input 2 中剩余的 5 项数据将不会被处理。

使用 If 和 Merge 节点的分支执行#

/// 信息 | 0.236.0 及以下版本 n8n 在 1.0 版本中移除了此执行行为。本节适用于使用 v0 (旧版) 工作流执行顺序的工作流。默认情况下，这包括所有在 1.0 版本之前构建的工作流。您可以在工作流设置中更改执行顺序。 /// 如果在包含 If 节点的工作流中添加 Merge 节点，可能会导致 If 节点的两个输出数据流都被执行。

一个数据流会触发 Merge 节点，然后 Merge 节点会去执行另一个数据流。

例如，在下方的截图中有一个包含 Edit Fields 节点、If 节点和 Merge 节点的工作流。If 节点的标准行为是只执行一个数据流（在截图中是 true 输出）。但由于 Merge 节点的存在，即使 If 节点没有向 false 数据流发送任何数据，两个数据流都会被执行。

工作流截图。该工作流包含一个 Edit Fields 节点，后接一个 If 节点，最后是一个 Merge 节点。

动手实践：分步示例#

创建一个包含示例输入数据的工作流来体验 Merge 节点的功能。

使用 Code 节点设置示例数据#

  1. 在画布上添加一个 Code 节点并连接到 Start 节点
  2. 在 JavaScript Code 字段粘贴以下代码片段： 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
    return [
  {
    json: {
      name: 'Stefan',
      language: 'de',
    }
  },
  {
    json: {
      name: 'Jim',
      language: 'en',
    }
  },
  {
    json: {
      name: 'Hans',
      language: 'de',
    }
  }
];
  3. 添加第二个 Code 节点，并连接到 Start 节点
  4. 在 JavaScript Code 字段粘贴以下代码片段： 
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
    return [
	  {
    json: {
      greeting: 'Hello',
      language: 'en',
    }
  },
  {
    json: {
      greeting: 'Hallo',
      language: 'de',
    }
  }
];

尝试不同的合并模式#

添加 Merge 节点。将第一个 Code 节点连接到 Input 1，第二个 Code 节点连接到 Input 2。运行工作流将数据加载到 Merge 节点中。

最终的工作流应如下所示：

View template details

现在尝试 Mode 中的不同选项，观察它们如何影响输出数据。

追加模式#

选择 Mode（模式） > Append（追加），然后选择 Execute step（执行步骤）。

表格视图中的输出结果应如下所示：

name language greeting
Stefan de
Jim en
Hans de
en Hello
de Hallo

通过匹配字段合并#

您可以合并这两个数据输入，使每个人都能获得对应语言的正确问候语。

  1. 选择 Mode（模式） > Combine（合并）
  2. 选择 Combine by（合并方式） > Matching Fields（匹配字段）
  3. 在 Input 1 Field（输入1字段） 和 Input 2 Field（输入2字段） 中都输入 language。这会告诉 n8n 通过匹配每个数据集中的 language 字段值来合并数据
  4. 选择 Execute step（执行步骤）

表格视图中的输出结果应如下所示：

name language greeting
Stefan de Hallo
Jim en Hello
Hans de Hallo

通过位置合并#

选择 Mode（模式） > Combine（合并），Combine by（合并方式） > Position（位置），然后选择 Execute step（执行步骤）。

表格视图中的输出结果应如下所示：

name language greeting
Stefan en Hello
Jim de Hallo
保留未匹配项#

如果您想保留所有项目，请选择 Add Option（添加选项） > Include Any Unpaired Items（包含未匹配项），然后开启 Include Any Unpaired Items（包含未匹配项）。

表格视图中的输出结果应如下所示：

name language greeting
Stefan en Hello
Jim de Hallo
Hans de

按所有可能组合合并#

选择 模式 > 合并，合并方式 > 所有可能组合，然后选择 执行步骤。

表格视图中的输出应如下所示：

name language greeting
Stefan en Hello
Stefan de Hallo
Jim en Hello
Jim de Hallo
Hans en Hello
Hans de Hallo