先配置连接，再让远程数据库 Agent 查询。
远程数据库 Agent 用于在项目上下文中安全地连接 MySQL、Doris 或 Oracle，检查表结构、生成 SQL、筛选和聚合数据，并把结果交给项目数据库、数据分析或可视化流程。
适用版本：QiyanAgent V3.5。最后更新：2026年9月14日。
本图来自 QiyanAgent V3.5 实际界面，标注对应连接配置、连接选择、任务输入与发送步骤。
开始前准备
- 在“设置 → 数据库连接”中准备数据库地址、端口、数据库名、用户名和密码。
- 确认账号权限符合任务需要，优先使用只读账号；不要把密码写入项目文件或提示词。
- 说明目标表、字段含义、时间范围、过滤条件和期望输出，避免 Agent 扫描无关数据。
- Oracle 用户需要按环境配置 Thick 模式；遇到 Oracle 11g 兼容问题时先检查客户端和驱动配置。
操作步骤
- 打开“设置 → 数据库连接”，新建 MySQL、Doris 或 Oracle 连接，完成连接测试后保存。
- 选择只读或读写权限。只读模式适合查询、抽样和分析；读写模式只在明确需要写入且已有备份时使用。
- 在左侧切换到“远程数据库”工作区，从“选择远程数据库连接”中选择已保存连接。
- 点击“新建 SQL”或在底部向远程数据库 Agent 描述任务，先让它查看 schema 和小范围样本，再生成查询。
- 执行读写 SQL 前，软件会先把 SQL 保存到当前项目的
sql/remote_db_history/；保存失败时不会继续执行。 - 需要复用结果时，把经过筛选、聚合和脱敏的数据交给项目数据库或导出到
data_exports/，不要直接复制整库。
验收要点
结果应说明使用的连接、表和字段范围、SQL 口径、筛选条件、返回行数及数据质量提示。读写任务还应能在项目 SQL 历史中找到执行前保存的语句；涉及个人信息或敏感字段时，必须完成脱敏和权限复核。