自定义 SQL 节点
通过配置输入变量与自定义 SQL 语句,灵活完成数据库读写操作。

一、应用场景
自定义SQL节点可广泛应用于以下业务场景:
- 数据录入场景:当用户输入内容或AI优化后的结果,自动把数据插入数据库;
- 动态查询场景:根据输入变量动态选择数据表与筛选条件,构造标准 SELECT 语句并完成查询。
二、添加自定义 SQL 节点
点击前一节点的 按钮,选择“自定义 SQL 节点”并添加。

三、节点配置详解
选中已添加的自定义 SQL 节点,在右侧面板中进行详细配置。

1. 输入变量配置
在右侧配置面板中设置该节点的输入变量:
- 左侧输入框:填写变量名
- 右侧下拉框:选择变量来源。变量必须来自前置节点,不可引用后续或并行节点

2. 数据源配置
- 点击数据源后的
图标,在弹窗中选择数据源
- 选中后的效果
- 数据源的配置请参考 多数据源
3. SQL
- 支持编写增删改查语句,并可使用动态变量
{{变量名}}
变量会通过数据库参数绑定执行,支持以下常用写法:
| 场景 | 示例 |
|---|---|
| 字符串精确匹配 | WHERE realname = {{name}} 或 WHERE realname = '{{name}}' |
| 数字及比较查询 | WHERE age >= {{age}},支持 >、<、>=、<=、!=、<> |
| 模糊查询 | WHERE realname LIKE '%{{name}}%',也支持前缀、后缀匹配 |
| 列表查询 | WHERE id IN ({{ids}}) |
| 动态表名 | SELECT * FROM {{tableName}} |
数字和布尔变量建议不加引号;参数为空时,SQL 空值判断应使用
IS NULL,不要使用= NULL。
4. 输出变量
- 查询语句返回 JSON 集合对象
- 新增、删除、编辑语句返回受影响的行数
- 支持更改输出类型,点击类型既可更改
注:SELECT 语句不能使用
number类型,UPDATE/INSERT/DELETE 语句不能使用object[]类型