Skip to content

数据表(Data tables)#

概述(Overview)#

数据表将数据存储集成到你的 n8n 环境中。使用数据表，你可以直接在工作流程中保存、管理和交互数据，而无需依赖外部数据库系统，适用于以下场景：

🌐 Data tables integrate data storage within your n8n environment. Using data tables, you can save, manage, and interact with data directly in your workflows without relying on external database systems for scenarios such as:

  • 在同一项目的不同工作流中持久化数据。
  • 存储用于防止重复运行或控制工作流触发器的标记。
  • 在工作流中重用提示或消息
  • 存储 AI 工作流的评估数据。
  • 存储工作流执行生成的数据。
  • 合并来自不同来源的数据以丰富你的数据集。
  • 创建查找表，作为工作流中的快速参考点

处理数据表(Working with data tables)#

你可以通过三种方式创建、筛选和管理数据表及其数据：使用 数据表节点、DataTable API 端点 或 数据表选项卡。

🌐 You can create, filter, and manage data tables and their data in three ways: using the Data Table node, the DataTable API endpoint , or the Data tables tab.

数据表节点(Data Table node)#

在工作流中使用数据表来存储和管理数据，使你的工作流在运行时能够自动创建、检索、更新和删除数据。

🌐 Use data tables inside workflows to store and manage data, enabling automated creation, retrieval, updates, and deletions as your workflow runs.

请参阅 数据表节点 以获取完整文档。

🌐 See the Data Table node for full documentation.

数据表 API 端点(DataTable API endpoint)#

使用 n8n API 中的 /datatables 端点以编程方式处理数据表。

🌐 Work with data tables programmatically using the /datatables endpoint in the n8n API.

请参见 API参考 获取完整文档。

🌐 See the API reference for full documentation.

数据表标签(Data table tab)#

通过可视化界面在用户界面中直接查看和操作数据表。这让你可以浏览和编辑数据，以及在无需构建工作流的情况下管理表格。

🌐 View and work with data tables directly in the UI through a visual interface. This lets you browse and edit data, and manage tables without building a workflow.

  1. 在你的 n8n 项目中，选择 数据表 选项卡。

  2. 点击位于右上角的拆分按钮，然后选择 创建数据表。

    数据表创建

  3. 输入表格的描述性名称。

  4. 选择创建表的方式：

    • 从零开始：通过手动定义列并使用可视化界面添加行来创建新表。
    • 导入 CSV：上传 CSV 文件以自动创建表结构并用文件中的数据填充表格。

    在出现的表格视图中，你可以：

    • 重命名或删除数据表或其列
    • 添加并重新排序列以整理数据
    • 添加、删除和更新行
    • 编辑现有数据

导出和导入数据(Exporting and importing data)#

在 数据表 选项卡中，你可以：

🌐 From the Data tables tab, you can:

  • 按照上一节所述，将 CSV 数据直接导入数据表
  • 下载你的数据表的 CSV。点击左上角的三点菜单并选择 下载 CSV。

数据表的注意事项和局限性(Considerations and limitations of data tables)#

  • 数据表适合轻量到中等的数据存储。默认情况下，实例中所有数据表使用的总存储空间限制为50MB。在自托管环境中，你可以使用环境变量 N8N_DATA_TABLES_MAX_SIZE_BYTES 来增加此默认大小限制。
  • 当你的数据表接近存储限制的 80% 时，n8n 会显示警告。当达到存储限制时，会出现最终警告。超过此限制将禁止手动向表中添加数据，并在尝试插入或更新数据时导致工作流执行错误。
  • 默认情况下，在项目中创建的数据表对该项目中的所有团队成员都可访问。
  • 在个人空间中创建的表格只有创建者可以访问。
  • 不支持从代码节点直接编程访问数据表。你不能通过内置方法或变量访问数据表的值。

数据表与变量(Data tables versus variables)#

功能 数据表 变量
统一表格视图 ✓ ✗
行列关系 ✓ ✗
跨项目访问 ✗ ✓
单个值显示 ✗ ✓
优化短值 ✗ ✓
结构化数据 ✓ ✗
限于项目范围 ✓ ✗
将值用作表达式 ✗ ✓