使用 n8n/Key_concepts/Data
数据表#
概述#
数据表(Data tables)将数据存储功能集成到你的 n8n 环境中。通过使用数据表,你可以在工作流内部直接保存、管理和操作数据,而无需依赖外部数据库系统,适用于以下场景:
- 在同一项目的不同工作流之间持久化数据
- 存储标记以防止重复运行或控制工作流触发
- 在多个工作流之间复用提示词(prompts)或消息
- 为 AI 工作流存储评估数据(evaluation data)
- 存储工作流执行过程中生成的数据
- 整合来自不同源的数据以丰富数据集
- 创建查找表(lookup tables)作为工作流中的快速参考点
如何使用数据表#
使用数据表包含两个部分:创建数据表以及在工作流中与其交互。
步骤 1:创建数据表#
- 在你的 n8n 项目中,选择 数据表(Data tables) 标签页。
- 点击右上角的拆分按钮,并选择 创建数据表(Create Data table)。 数据表创建
- 为你的数据表输入一个具有描述性的名称。
在出现的表格视图中,你可以:
- 添加和重新排序列以组织数据
- 添加、删除和更新行
- 编辑现有数据
步骤 2:在工作流中与数据表交互#
使用 数据表节点(Data table node) 在工作流中与数据表进行交互,该节点允许你检索、更新和操作存储在数据表中的数据。 参见 数据表节点文档。
数据表的注意事项与限制#
- 数据表适用于轻量至中等规模的数据存储。默认情况下,单个数据表的数据量不能超过 50MB。在自托管(self-hosted)环境中,你可以通过环境变量
N8N_DATA_TABLES_MAX_SIZE_BYTES增加此默认大小限制。 - 当数据表接近存储上限的 80% 时,系统会发出警告;达到存储上限时会再次提醒。超出限制后,将无法手动向表中添加数据,并且在尝试插入或更新数据时会导致工作流执行错误。
- 默认情况下,项目内创建的数据表对该项目中的所有团队成员开放访问。
- 在 个人(Personal) 空间中创建的表仅对其创建者可见。
数据表与变量#
| 功能 | 数据表(Data tables) | 变量(Variables) |
|---|---|---|
| 统一的表格视图 | ✓ | ✗ |
| 行列关系 | ✓ | ✗ |
| 跨项目访问 | ✗ | ✓ |
| 单个值显示 | ✗ | ✓ |
| 优化用于短值存储 | ✗ | ✓ |
| 结构化数据 | ✓ | ✗ |
| 作用域限定为项目 | ✓ | ✗ |
| 将值用作表达式 | ✗ | ✓ |
导出和导入数据#
要在 n8n 与外部工具之间传输数据,请使用以下工作流:
- 从数据表中检索数据。
- 使用 API 或文件导出功能导出数据。
- 相应地将数据导入到另一个系统或数据表中。