SQL 数据库查询：SQL Database 组件（AI Flowi Workflow）
SQL 数据库查询组件 SQL Database 在兼容 SQLAlchemy 的数据库上执行 SQL 查询。导出内容将结果类型列为 Table，因此将查询连接到后续处理之前，请先规划接收端口。
SQL Database 已在目录中记录；Ai Flowi 尚未在生产环境中测试。
作者：Ai Flowi · 发布于
目录参考
本 SQL 参考文档采用 2026年10月9日 导出的 AI Flowi Workflow 1.9.2 目录，具体条目为 data_source.SQLComponent。目录描述： 在兼容 SQLAlchemy 的数据库上执行 SQL 查询。
查看 SQL Database 的目录条目.
相关内容：自然语言转 SQL。
输入
database_url 和 query 是两个必填字段；两者均接受 Message 连接。布尔字段没有接受输入类型的元数据，表中显示为“未列出”。
| 名称 | 类型 | 是否必填 | 接受的输入类型 | 说明 |
|---|---|---|---|---|
add_error | bool | 否 | 未列出 | 名为 add_error 的布尔设置；未说明错误格式及默认值。 |
database_url | str | 是 | Message | 必填的数据库连接 URL；列出的接受连接类型为 Message。 |
include_columns | bool | 否 | 未列出 | 名为 include_columns 的布尔设置；导出内容未解释其对结果的影响。 |
query | str | 是 | Message | 必填的 SQL 查询文本，也可通过 Message 连接提供。 |
输出
| 显示名称 | 名称 | 类型 |
|---|---|---|
| Result Table | run_sql_query | Table |
Result Table 是 run_sql_query 的显示名称，声明类型为 Table。SQL Database 未列出独立错误端口或 JSON 输出。
何时使用 SQL Database
来源是数据库，且已有待执行的 SQL 查询时，可选择 SQL Database。如需在获取结果后处理文本，Parser.input_data 列出了接受的 Table 类型；设置下一步配置前，请先检查返回的列。
何时选择其他组件
如需访问 HTTP 端点，请参阅 API Request ，无须配置数据库 URL。如需处理现有 JSON 对象，请参阅 JSON Operations；如需将 Table 转换为 JSON，请先查看 Type Convert ，再使用仅接受 JSON 的处理组件。
配置示例
配置示例，非已记录的测试
{
"database_url": "YOUR_DATABASE_URL",
"query": "SELECT 1 AS sample_value;"
}请在本地将 YOUR_DATABASE_URL 替换为您有权查询的数据库连接 URL。查询常量的 SELECT 语句仅为起始查询示例；本文未验证数据库连接、返回行或支持的驱动程序。
关于 SQL 连接凭据与变量，请阅读 连接 和 模型与变量.
限制
- 目录仅说明兼容 SQLAlchemy，并未导出数据库引擎或已安装驱动程序的列表。来源未提供连接字符串示例、TLS 控制项或网络要求。
- add_error 并不证明存在异常恢复、错误信息脱敏或错误分支。在向其他系统提供查询结果或错误详情之前，请先确认失败处理方式。
- include_columns 没有文档规定的默认值或输出结构定义；仅有列名设置，无法确定 Result Table 的结构。
- 四个导出字段中未列出参数绑定输入、事务控制、行数限制或超时设置。请使用受控查询及适合任务的数据库权限；本参考文档不保证写入、回滚或防注入能力。
- Select Data.data_list 和 Filter Data.data 列出的类型为 Data 和 JSON，不包括 Table。导出的类型列表不支持将 Result Table 直接连接到这两个输入中的任何一个。
节点用量
相关组件
API Request · Parser · Type Convert · Select Data · Filter Data