新增数据节点

新增数据节点用于向指定数据表插入一条记录，对应常规数据库操作中的 INSERT。它把数据表、字段和值做成可视化配置，不要求编写 SQL，适合单表新增场景。

每次执行节点时，系统会把已配置的字段值作为一条新记录写入目标表。需要批量写入、多表联动或复杂 SQL 时，应重新评估流程设计，必要时使用循环、批处理或 SQL 自定义节点，并补充幂等和失败补偿方案。

添加与配置

在节点面板的 数据库 分类中添加 新增数据 节点。属性面板依次提供数据表、字段、输出和异常处理配置。

新增数据节点完整配置

截图示例向 daily_expenses 表写入一条记录：name 为“文档示例”，price 为 100。

数据表

单击 添加数据表，从资源库数据库中选择目标表。每个新增数据节点只支持操作一张数据表；选中后可以移除并重新选择。

配置前应确认：

数据表属于正确的工作空间和运行环境；
当前执行身份具有新增数据权限；
表结构、必填字段、唯一约束和字段默认值符合业务要求；
多用户数据隔离、调试数据隔离等能力已在目标环境实际验证。

试运行可能产生真实写入。应使用专门的测试表或带有明确标识的测试记录，并在完成验证后按数据治理规则处理。

选择并设置字段

单击 选择并设置字段 右侧的加号，从数据表可写的自定义字段中选择目标字段。字段类型由数据表结构确定，不能在节点内随意修改。

每个字段支持两种取值方式：

固定值：直接输入常量，每次执行都写入相同的值；
引用变量：引用开始节点、上游节点输出或流程变量，在运行时动态写入。

配置时需注意：

字符串、整数、布尔、时间等值必须与字段类型一致；
数据表中的必填字段如果没有默认值，应在节点中提供；
唯一字段或业务幂等键必须避免重复；
未显示在可选列表中的系统字段通常由平台维护，不应强行写入；
引用变量可能为空时，应在上游先校验或提供明确的空值策略。

输出

新增数据节点提供两个固定输出：

输出	类型	说明
`outputList`	`Array＜Object＞`	新增操作返回的记录列表；需要引用具体字段时，可按真实返回结构添加子项
`rowNum`	`Integer`	本次新增的数据行数；单条新增成功时通常为 `1`

为 outputList 添加子项时，变量名应与返回字段一致，类型应与数据表定义一致。下游需要新记录 ID、业务字段或系统生成字段时，应先试运行确认实际返回内容，再配置输出子项，不能只凭字段名称猜测。

流程应以异常处理设置和实际运行结果为准，不要直接引用未在面板中定义的字段。

异常处理

新建节点的默认设置为：

整体执行超时：60 秒；
重试次数：不重试；
异常处理方式：中断流程。

新增数据属于有副作用的写操作。请求超时并不代表数据库一定没有写入，因此不要在没有幂等保护时开启重试。确需重试时，应使用业务唯一键、数据库唯一约束或其他可验证的幂等机制，并明确重复请求的处理方式。

如果业务允许节点失败后继续，应在异常分支中记录失败原因并设计补偿处理；不要吞掉错误后继续使用不存在的新增结果。

示例：新增一条费用记录

选择 daily_expenses 数据表；
添加 name 字段，填写固定值“文档示例”；
添加 price 字段，填写整数 100；
检查表中的必填字段和唯一约束；
试运行节点，确认 rowNum 和 outputList；
再将输出连接到需要使用新增记录的下游节点。

正式流程中可以把固定值替换为开始节点或上游节点的输出，例如将表单中的费用名称和金额动态写入数据表。

常见问题

为什么字段选择列表里没有某个字段？

先确认数据表结构已经保存并刷新节点。系统字段可能由平台自动维护，不一定作为可写字段展示；若是自定义字段仍未出现，移除并重新选择数据表后再次检查。

为什么节点提示字段类型不匹配？

检查固定值或引用变量的真实类型。数字字符串不一定会自动转换为整数，时间文本也必须符合字段接受的格式。建议在上游先完成类型转换和空值校验。

为什么新增操作违反唯一约束？

写入值已经存在于唯一字段中。应根据业务选择更新已有记录、提前查询去重，或生成稳定的业务幂等键，而不是直接重试新增节点。

为什么试运行后数据库出现了记录？

立即核对所选工作空间、数据库和表，后续使用专门测试表或可识别、可清理的测试数据。

为什么 `outputList` 有结果，但下游无法选择具体字段？

展开 outputList 并按实际返回结构添加子项，变量名和类型必须与试运行结果一致。若执行结果没有返回所需字段，应调整节点输出或在新增后使用查询节点获取完整记录。