数据库只读任务

概览

PostgreSQL 与 MySQL 资源支持连接检查、版本查询和登记的只读查询模板。建议使用独立只读账号，设置 TLS，限制输出列、行数与超时。密码只参与原生驱动认证，不进入 SQL 或连接 URL。

边界与检查

SQL 中的普通值使用类型化参数绑定，不能把表名、列名或 SQL 片段作为参数。审批前检查目标数据库、完整查询、参数值和返回字段；运行后验证业务结果与截断标志。

支持的操作

PostgreSQL 与 MySQL 原生连接器提供连接检查、版本查询和用户登记的只读查询模板。它们不接受自由 SQL，也不依赖 psql 或 mysql 命令行程序。建议建立专用只读账户，记录固定数据库、端口与完整 TLS 验证；密码只用于驱动认证，不放进 SQL、连接 URL 或聊天。当前资料列出的测试范围为 PostgreSQL 14–17、MySQL 8.0/8.4，不宣称 MariaDB 已支持。

配置一条查询

1. 在“资源”中登记地址、账号、数据库和认证，运行固定的只读连接检查。
2. 创建数据库任务，选择连接或版本检查，或登记一个 SELECT／WITH 查询。普通值使用未加引号的 {{param:名称}} 交给驱动绑定；不能把表名、列名、排序或 SQL 片段作为参数。
3. 明确选择 1–32 个返回列、1–1000 行上限和可选最低预期行数。审批前查看完整 SQL、参数解析值、目标与结果范围。
4. 执行后同时查看技术状态、validation_status、truncated 和 cleanup_ok；单元格以文本或 NULL 返回，以保护长整数和高精度小数。

查询在只读事务中执行。默认 verify_full 验证证书与主机名；可按产品文档配置私有 CA。显式关闭 TLS 会传输明文，程序不会自动降级。输出列筛选和已知秘密过滤不等于业务数据可随意交给 AI。

失败后的判断

结果超过行数或预算会标记截断；未达最低预期行数时应检查业务查询本身。超时与取消会尝试停止数据库会话，cleanup_ok:false 需要检查远端是否仍工作；不要推断所有远端工作已经回滚。更多参数与 SQL 限制见页面底部所链的产品源文档。