Execute SQL 工具 (Execute SQL Tool)

该工具用于在指定的关系型数据库上执行 SQL 查询。

---

Execute SQL (执行 SQL) 工具允许您连接到关系型数据库并运行 SQL 查询，这些查询既可以由您直接输入，也可以通过 Agent 组件利用系统的 Text2SQL 能力生成。

前提条件 (Prerequisites)

• 数据库实例已正确配置并处于运行状态。
• 数据库必须是以下类型之一：
  • MySQL
  • PostgreSQL
  • MariaDB
  • Microsoft SQL Server

示例 (Examples)

您可以将 Agent 组件与 Execute SQL 工具成对使用，其中由 Agent 生成 SQL 语句，而 Execute SQL 工具则负责处理数据库连接并执行查询。这种配置的示例可以在如下所示的 Text-to-SQL data expert (Text-to-SQL 数据专家) 智能体模板中找到：

配置项 (Configurations)

SQL statement (SQL 语句)

此文本输入框允许您编写静态 SQL 查询（例如 SELECT * FROM my_table）以及使用变量的动态 SQL 查询。

注意

点击 (x) 或输入 / 可以插入变量。

对于动态 SQL 查询，您可以在 SQL 查询中包含变量，例如 SELECT * FROM /sys.query；如果将 Agent 组件与 Execute SQL 工具成对使用以生成 SQL 任务（参见 示例 部分），您可以直接将该 Agent 的输出变量 content 插入到此字段中。

Database type (数据库类型)

支持的数据库类型。目前可用的数据库类型包括：

• MySQL
• PostgreSQL
• MariaDB
• Microsoft SQL Server (Mssql)

Database (数据库)

仅在选择 Split（拆分）作为方法时出现。

Username (用户名)

具有访问数据库权限的用户名。

Host (主机)

数据库服务器的 IP 地址。

Port (端口)

数据库服务器监听的端口号。

Password (密码)

数据库用户的密码。

Max records (最大记录数)

SQL 查询返回的最大记录数，用以控制响应大小并提高效率。默认值为 1024。

Output (输出)

Execute SQL 工具提供了两个输出变量：

• formalized_content：一个字符串。如果您在 Message 组件中引用此变量，返回的记录将以表格形式显示。
• json：一个对象数组。如果您在 Message 组件中引用此变量，返回的记录将以键值对 (Key-Value Pairs) 形式呈现。