从 n8n-nodes-databricks 社区包迁移
内置 Databricks 节点取代了 n8n-nodes-databricks 社区包。本页面将每个社区节点映射到对应的内置节点,列出已移动的字段,并说明需要注意的行为变化。
社区节点和内置节点使用不同的 node type,因此无法原地转换节点。对于工作流中的每个社区节点:添加内置节点,复制设置,重新连接,然后删除社区节点。
内置 AI 节点需要使用服务主体或用户登录的 Databricks OAuth2 凭据。社区包使用 host 和个人访问令牌的凭据,在内置 AI 节点中没有对应方式;只有内置 Databricks 和 Databricks Trigger 节点接受个人访问令牌。
节点映射
| 社区节点 | 内置节点 | 变化 |
|---|---|---|
| Databricks | Databricks | 资源相同。内置节点新增 Job 操作,以及 Databricks Trigger 节点。 |
| Databricks Chat Model | Databricks Chat Model | Model 模型选择 Unity AI Gateway 模型服务 catalog.schema.service,而不是 serving endpoint。Conversation ID 会话 ID和 Return Trace 返回跟踪选项已不存在。 |
| Embeddings Databricks | Embeddings Databricks | Serving Endpoint 服务端点改为 Model 模型,即支持 embeddings 的模型服务列表。 |
| Databricks Vector Store | Databricks Vector Store | Index Name 索引名称改为 Index 索引,可从列表选择或输入完整的 catalog.schema.index 名称。Text Column 文本列改为 Content Column 内容列,从索引列中选择。Metadata Columns 元数据列从逗号分隔列表改为多选字段。Score Threshold 分数阈值已移除;请使用 Limit 限制。新增:Search Mode 搜索模式和 Metadata Filter 元数据筛选器。 |
| Databricks AI Agent | Databricks AI Agent | Enable MLflow Tracking 启用 MLflow 跟踪改为 Export Traces to MLflow 导出跟踪到 MLflow。默认 experiment 路径 /Shared/n8n-workflows-<workflow-id> 保持不变,新的 Experiment 实验字段可用于选择现有 experiment。agent 上的凭据仅用于导出。 |
Vector Store 节点的字段差异
| 社区字段 | 内置字段 | 说明 |
|---|---|---|
| Index Name 索引名称(文本) | Index 索引 | 选择 From List 从列表中选择,或在 Name 名称中输入全名。在 Insert Documents 插入文档模式下,列表仅显示 Direct Access 索引。 |
Text Column 文本列(默认 text) |
Content Column 内容列 | 从索引列中选择。在托管索引上留空可使用 embedding source column。 |
| Metadata Columns 元数据列(逗号分隔文本) | Metadata Columns 元数据列选项 | 多选字段。留空时返回除 primary key、content column 和 vector column 以外的所有列。 |
Score Threshold 分数阈值(默认 0.8) |
无 | 使用 Limit 限制。原因请参阅不提供分数阈值。 |
| 无 | Search Mode 搜索模式选项 | Vector 向量或 Hybrid 混合。 |
| 无 | Metadata Filter 元数据筛选器选项 | 作为 filters_json 发送的 JSON 筛选器。 |
需要注意的行为变化
- 现在可以搜索托管索引。社区节点始终发送
query_vector,因此对使用 Databricks 计算 embeddings 的 Delta Sync 索引执行搜索都会失败。内置节点会根据索引要求发送query_text或query_vector。请参阅索引类型和嵌入。 - 不再因阈值丢弃结果。社区节点的 Score Threshold 分数阈值默认为
0.8,会丢弃相似度分数远低于该值的索引中的所有结果。内置节点返回 Limit 限制指定数量的顶部结果。 - 混合搜索和 metadata filter 可用于所有搜索模式,包括 agent 将索引用作工具时。
- 插入前会先验证。如果使用 Delta Sync 索引或错误的 Content Column 内容列,节点会给出明确指出问题的消息,而不是原始 API 错误。
- Agent 不会偏离主版本。内置 Databricks AI Agent 运行 AI Agent 节点自身的代码,而不是 fork,因此拥有相同选项,并获得相同修复。
- 替换 agent 节点后,trace 仍写入同一 experiment,因为默认 experiment 路径包含 workflow ID。
相关资源
- Databricks Vector Store
- Embeddings Databricks
- Databricks AI Agent
- Databricks Chat Model
- Databricks 凭据
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。