数据库节点

数据库节点使用资源库中已创建、已授权的数据库。可视化节点适合常规增删改查，SQL 自定义节点适合需要完整 SQL 表达能力的场景。

所有数据库节点当前统一提供 outputList（结果记录列表）和 rowNum（返回或受影响行数）两个输出；列表内部字段取决于表结构、查询字段和实际执行结果。

SQL 自定义节点

SQL 自定义节点在选定数据库上执行自定义 SQL。

配置	说明
SQL 输入	定义 SQL 中需要使用的动态参数
SQL 数据库	选择资源库数据库连接
SQL	编写查询或写入语句
输出	outputList、rowNum

不要把未经校验的用户文本拼进 SQL。动态值应通过节点参数映射，并限制可操作的表、字段和语句范围。执行写操作前先在测试数据上验证。

新增数据节点

新增数据节点向指定数据表插入一条或多条字段值。

配置数据库和数据表后，将表字段映射为固定值或上游变量。必填字段、唯一约束、字段长度和类型由当前表结构决定。

执行后使用 rowNum 判断影响行数；需要取得完整新增记录时，应根据业务唯一键继续查询，不能假定数据库一定返回全部字段。

查询数据节点

查询数据节点按字段、条件、排序和数量限制返回记录。

配置	说明
查询字段	只选择后续真正需要的列，避免读取敏感或大字段
查询条件	支持组合条件；变量为空时应有明确处理
排序字段	分页或取最新记录时必须使用稳定排序
限制条数	当前节点默认限制为 100，按实际场景缩小范围

结果位于 outputList。没有命中时通常返回空列表，后续节点应判断列表长度后再访问元素。

更新数据节点

更新数据节点修改满足条件的记录。配置更新字段和值，并设置精确的更新条件。

更新前建议先用相同条件执行查询，确认命中数量和样例记录。条件变量为空、类型非法或命中范围超出预期时，应停止流程。通过 rowNum 检查实际影响行数。

删除数据节点

删除数据节点删除满足条件的记录。删除不可通过工作流自动恢复，因此必须设置条件并验证范围。

推荐流程：先查询并展示待删除数据 → 校验数量或取得用户确认 → 执行删除 → 检查 rowNum → 记录业务审计信息。

权限、事务与错误处理

• 节点能选择数据库不代表当前用户拥有所有表或所有行权限，实际访问仍受资源授权和数据隔离控制。
• 多个数据库节点默认是多次独立调用，不应假定它们自动组成事务。
• 表结构变化后，重新打开相关节点并检查字段映射、条件和下游变量。
• 对唯一键冲突、空结果、超时、连接失败和部分写入设置可见的异常处理。

参见：在工作流中使用数据库。