助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容?
有哪些近期更新的重点文档?
我应该从哪些文档开始阅读?
文档反馈
低代码项目
快速开始
智能体
应用
资源
发布
模型
多人协作
开发工具
推广与变现

新增数据节点

更新于: 2026-06-24 15:44:40

低代码工作流中的新增数据节点用于向指定的数据库插入数据,对应 SQL 中的 INSERT 操作。

节点说明

在低代码工作流中,你可以添加新增数据节点,以图形化方式配置数据库内数据的插入操作。此节点中需要指定待操作的数据库表和待插入的字段名称及字段值,每次执行此节点时自动插入一行数据。整个过程无需编写 SQL 语句,操作简单直观。
相比 SQL 自定义节点,新增数据节点中的操作极大降低了操作门槛,对于不熟悉 SQL 的用户,也能高效、轻松地操作数据库。

注意

  • 开发调试阶段不会改动数据库原表,在调试区查看到的是测试数据,和数据库中的真实数据是隔离的。
  • 在低代码工作流中调试新增数据节点时,不能使用库数据表中的真实数据,需要先插入测试数据后再进行查、删、改等操作的测试。

配置数据节点

数据表

在数据表区域,你需要根据页面提示添加需要操作的数据表。每个新增数据节点仅支持操作一张数据表。
在调试期间,新增数据节点中显示和使用的是数据表的测试数据,而非数据库中的真实线上数据。单击数据表或单击查看数据,弹出数据表的详情页,可查看此数据表的测试数据。

说明

如需在工作流中实现数据库多用户模式,需在创建数据表时,先选择多用户模式。更多信息,请参考数据库

Image

选择并设置字段

选择并设置字段区域,你可以选择目标字段及配置字段值。配置完成后,每次运行工作流时,系统会将指定的字段值作为新的一行数据插入到数据表。具体操作,请参考示例

  1. 单击➕图标,查看当前数据表所包含的所有自定义字段,并按需选择目标字段。
  2. 配置字段值。
    • 固定值:输入一个常量,每次运行工作流时,该字段均写入相同的值。
    • 引用变量:引用变量或者上游节点的输出参数,动态设置字段值。
      Image

输出

新增数据节点中的输出参数是执行数据新增操作后的输出内容。

  • outputList:执行数据新增操作后数据表中的字段和数据。你可以按需新增子项,注意变量名需与定义的字段名一致、数据类型需要和数据表中定义的数据类型一致。
  • rowNum:新增的数据行数。
  • errorBody:节点执行失败时的详细信息,包括 errorMessage 和 errorCode。
  • isSuccess:节点执行状态,true 表示执行成功,false 表示执行失败。

其中isSuccesserrorBody 仅在节点的异常处理方式设置为返回设定内容执行异常流程时返回,用于节点执行异常时传递详细信息。

异常处理

默认情况下,节点运行超时、运行异常时,工作流会中断,工作流调试界面或 API 中会返回错误信息。你也可以手动设置节点运行超时等异常情况下的处理方式,例如超时时间、是否重试、是否跳转异常分支等。

异常处理设置

说明

超时时间

超时时间指节点运行的最大耗时,如果超过此时长,则判断为节点运行超时。
默认情况下,节点的超时时间默认为 60s,即 1 分钟。你也可以将其改为 0.1s~60s,灵活控制超时时间。

重试次数

节点运行超时或异常时,默认不重试,你也可以设置为重试 1 次。

异常处理方式

节点运行超时或异常时,默认中断工作流。你也可以手动修改此节点的异常处理方式:

  • 中断流程:工作流执行中断,不再运行后续节点。
  • 返回设定内容:发生异常后,工作流运行不会中断。开发者可自定义设置需要返回的输出字段内容,必须是输出中已定义的字段,且格式为合法的 JSON 格式。另外,节点还会返回输出参数 isSuccesserrorBody,传递节点异常的详细信息。
  • 执行异常流程:发生异常后,工作流运行不会中断,转而执行异常流程分析,开发者需要为新增的异常分支配置处理流程。异常信息会通过节点的输出参数 isSuccesserrorBody 返回。

Image

示例

例如使用新增数据节点,向用户信息表 userinfo 中插入一条数据,companynamecousernamexiaomingtel123
Image