执行SQL节点

定义

执行SQL节点用于业务流中对数据库进行固定的SQL语句操作。执行SQL语句是单次运行，没有记忆功能。

---

配置使用

新增数据库

点击数据库右侧的 + 符号，再点击 新建数据库 按钮，输入符合要求的数据库名称与描述，最后点击确认按钮进入数据库表结构设计页面。

1. 新增数据库表结构： 填写字段名称、字段描述，选择字段数据类型，并标记是否为必要字段。

2. 数据导入： 表结构创建完成后，切换到数据导入页面，支持上传 Excel 或 CSV 格式文件，选择表字段映射后完成导入。

3. 数据预览： 导入完成后，切换到表预览标签页，左上角提供全局搜索框，下方以分页形式展示已导入的数据列表。

添加数据库

在数据库弹窗中点击 添加 按钮，该数据库表将添加至节点的数据表列表中，支持重复添加或删除。

删除数据库

在数据库弹窗中点击 删除 按钮，即可移除已添加的数据库。

查询数据库表数据

添加数据库后，节点会根据用户点击运行按钮，自动执行单次SQL语句的操作，执行SQL输出结果到下游节点，以供下游节点使用。

---

SQL语句生成

SQL提示词：根据输入的变量，添加的数据库表，在SQL提示词里面输入需要执行的SQL自然语言，点击生成SQL按钮，在下方的SQL语句框内，会自动生成需要执行的SQL语句

---

参数说明

参数	说明
数据库	选择需要操作的数据库表，支持添加多张表
SQL 提示词	输入自然语言描述，点击「生成SQL」按钮自动生成对应 SQL 语句
SQL 语句	最终执行的 SQL 语句，可在生成后手动修改
输出变量	类型为 Array[String]，将查询结果传递给下游节点使用

---

典型使用场景

场景：固定报表数据查询

需求： 业务流每次触发时，自动查询指定时间范围内的订单汇总数据，输出给下游节点生成报表。

配置思路：

1. 新建数据库并导入订单数据表
2. 在执行SQL节点中添加该数据库
3. 在 SQL 提示词中输入「查询本月所有订单的总金额和订单数量」，点击生成SQL
4. 确认生成的 SQL 语句无误后，将输出结果传递给下游的模型节点或直接回复节点

开始节点 → 执行SQL节点（固定SQL查询）→ 模型节点（格式化输出）→ 直接回复节点

---

常见问题

Q：执行SQL节点与对话SQL节点有什么区别？

执行SQL节点用于业务流中执行固定的 SQL 语句，每次触发均运行预设好的 SQL，适合报表查询、数据写入等确定性操作；对话SQL节点用于对话型业务流，根据用户每次输入的自然语言动态生成并执行 SQL，适合交互式数据查询场景。

Q：SQL 语句可以手动修改吗？

可以。点击「生成SQL」后，SQL 语句框内的内容支持手动编辑，可在自动生成的基础上进行调整和优化。