跳到主要内容

去重节点#

使用去重节点可识别并删除以下重复项：

  • 单次执行中所有字段或字段子集完全相同的条目
  • 与历史执行记录相同或已被历史条目覆盖的条目

通过对比历史执行数据，去重节点能够删除早前执行中已处理过的条目，同时确保新条目具有更晚的日期或更高的数值。

1.64.0 重大更新

n8n 团队在 1.64.0 版本中重构了此节点。本文档对应最新版本节点。若您使用旧版 n8n，可在此处查看历史版本文档。

运行模式#​

去重节点根据操作参数值的不同提供三种运行模式：

移除当前输入中的重复项#​

当"操作"字段设置为移除当前输入中的重复项时，去重节点会识别并删除当前输入中的重复条目。支持全字段比对或指定字段子集比对。

参数配置#​

使用移除当前输入中的重复项操作时，可配置以下参数：

  • 比对范围：选择n8n用于重复性校验的输入数据字段，可选值包括：
    • 所有字段：比对输入数据的所有字段
    • 排除指定字段：输入需要从比对中排除的字段（多个值用逗号分隔）
    • 选定字段：输入需要参与比对的字段（多个值用逗号分隔）

选项配置#​

若选择排除指定字段或选定字段作为比对类型，可添加以下选项：

  • 禁用点标记法：设置是否使用父级.子级格式的点标记法引用子字段（关闭启用/开启禁用）
  • 移除其他字段：设置是否移除未参与比对的字段（开启移除/关闭保留）

移除历史执行已处理项#​

当"操作"字段设置为移除历史执行已处理项时，去重节点会将当前输入条目与历史执行记录进行比对。

参数配置#​

使用移除历史执行已处理项操作时，可配置以下参数：

  • 保留条件：选择n8n判定保留条目的规则，可选值包括：
    • 值为新增：若条目值与历史执行记录匹配则移除
    • 值高于历史值：若当前值未超过历史值则移除
    • 日期晚于历史日期：若当前日期不晚于历史日期则移除日期类条目
  • 去重依据值：指定用于比对的输入字段。保留条件参数的选择将决定所需格式：
    • 使用值为新增时：必须为包含唯一ID的输入字段或字段组合
    • 使用值高于历史值时：必须为包含递增值的输入字段或字段组合
    • 使用日期晚于历史日期时：必须为包含ISO格式日期值的输入字段

选项配置#​

使用移除历史执行已处理项操作时，可配置以下选项：

  • 作用域：设置n8n存储和使用去重数据的方式，可选值包括：
    • 节点级：（默认）独立存储本节点数据，与工作流中其他去重节点实例隔离。使用此作用域时可单独清除本节点实例的重复历史而不影响其他节点
    • 工作流级：在工作流层级存储去重数据，与所有设为"工作流"作用域的去重节点共享数据。设为"节点级"作用域的其他去重节点仍保持独立数据管理

当保留条件选择值为新增时，还可配置：

  • 历史记录大小：n8n为跨执行去重跟踪存储的条目数量。作用域选项将决定该历史记录大小是仅适用于本节点实例，还是与工作流中其他实例共享（默认存储10,000个条目）

清除去重历史#​

当"操作"字段设置为清除去重历史时，去重节点将管理并清除历史执行存储的条目。此操作不影响当前输入中的任何条目，仅管理"移除历史执行已处理项"操作所使用的条目数据库。

参数配置#​

使用清除去重历史操作时，可配置以下参数：

  • 模式：选择管理数据库中键/值条目的方式，可选值包括：
    • 清理数据库：删除数据库中所有去重数据，将去重数据库重置为初始状态

选项配置#​

使用清除去重历史操作时，可配置以下选项：

  • 作用域：设置n8n管理去重数据库的作用范围
    • 节点级：（默认）管理本去重节点实例专属的数据库
    • 工作流级：管理所有使用工作流作用域的去重节点实例共享的数据库

模板与示例#​

有关去重节点的使用模板和实战案例，请参阅模板与示例文档。

相关资源#​

深入了解n8n工作流中的数据结构和数据流。