跳转至

MergeKeyValuePair 多字典合并与配置聚合节点

节点核心功能 (What is it?)

MergeKeyValuePair 节点用于将多个分立的字典对象合并为一个统一的字典。它最多支持同时接收多达 4 个输入字典，并按照明确的合并规则将它们包含的所有键值映射融合为单一的结构化输出。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

  • 将多个分散的字典对象聚合为一个统一的汇总字典；
  • 整合来自不同数据源的独立运行时配置参数；
  • 将不同模块产出的键值数据聚合为下游单节点所需的复合载荷；
  • 运用积木化思路，将各分立组件生成的局部参数拼装为完整请求体；
  • 统一整理并集中传递工作流中分散的键值对。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 MergeKeyValuePair 节点。
  2. 将最多 4 个产生字典工件的上游节点分别接入本节点的 4 个输入插槽。
  3. 节点将把所有接入的键值对自动压合融为一体。
  4. 在 output 引脚即可提取合并后的全新复合字典。

参数输入插槽 (Parameters)

  • key_value_pair_1：参与合并的第 1 个输入字典。
  • key_value_pair_2：参与合并的第 2 个输入字典。
  • key_value_pair_3：参与合并的第 3 个输入字典。
  • key_value_pair_4：参与合并的第 4 个输入字典。

输出引脚 (Outputs)

  • output：聚合了所有输入字典所有键值映射的全新单一字典工件。

典型工作流示例 (Example)

假设您需要合并来自系统各处的配置片段：

  1. 添加一个 MergeKeyValuePair 节点至工作流。
  2. 将数据库配置字典接入 key_value_pair_1（例如 {"host": "localhost", "port": 5432}）。
  3. 将身份认证凭据接入 key_value_pair_2（例如 {"username": "admin", "password": "secure123"}）。
  4. 将应用层运行选项接入 key_value_pair_3（例如 {"app_name": "MyApp", "debug": true}）。
  5. 节点输出端将即刻融汇生成包含全量属性的单一字典： 
    {
  "host": "localhost",
  "port": 5432,
  "username": "admin",
  "password": "secure123",
  "app_name": "MyApp",
  "debug": true
}

关键技术特性 (Important Notes)

  • 键名冲突后发优胜机制 (Last-Write-Wins)：当相同的键名同时出现在多个输入字典中时，顺位靠后的输入插槽将覆写先前的取值（例如 key_value_pair_2 中的同名键会覆盖 key_value_pair_1 中的值）。
  • 非字典与空值自动容错：未接线、值为 None 或非合法字典类型的输入插槽将被自动跳过，绝不阻塞计算。
  • 弹性输入承载：无需接满全部 4 个插槽，接入 1 至 4 个任意数量的有效字典均可平稳执行。
  • 顺序敏感性：在预期存在同名键覆盖的场景下，合理安排插槽连接顺序即可实现“默认参数 + 用户自定义覆盖”的设计范式。