进行数据分析和 SQL 辅助
Dora 把数据查询分析和大模型 SQL 生成集成在同一个工具中,用户可以完成模型设计、SQL 编写、查询执行和结果分析的全流程。生成内容必须结合目标数据库、数据权限和实际执行结果核对。
数据查询分析
| 能力项 | 说明 |
|---|---|
| SQL 查询执行 | 在 SQL 编辑器中直接执行查询,无需切换外部工具;支持多语句查询并分别查看结果;提供查询进度提示和取消功能;自动记录执行时间、结果集数量等统计信息 |
| 查询结果展示 | 结果以表格展示,多结果集分标签页显示;支持列宽调整、行高自适应、文本换行;提供查询输出日志记录执行过程和错误信息;结果面板可折叠展开 |
| SQL 智能补全 | 基于当前数据模型自动提示表名、字段名、Schema 名称;支持表别名识别;智能识别 JOIN 上下文并按模型关系推荐 JOIN 条件;支持关键字和常用函数补全 |
| 元数据集成 | 自动从当前模型提取表结构、字段类型和关系信息;支持 Schema、Table、Column 三级智能提示;编写时优先显示当前实体相关表的补全建议;元数据实时更新 |
执行一次查询的步骤:
- 打开与目标数据库类型一致的模型,在 SQL 编辑器中编写或让 Dora 生成查询语句。
- 核对表名、字段名、关联条件和数据范围,确认没有扩大到非目标数据。
- 在允许的数据源上执行,查看结果表格和输出日志。
- 需要继续分析时,以本次实际查询结果作为后续对话依据。
补全提示来自模型结构,不保证目标数据库中已存在相同对象;模型与数据库不同步时应先处理差异。查询账号只应具备完成任务所需的权限,分析结论必须以实际返回的查询结果为依据。
SQL 代码生成
| 能力项 | 说明 |
|---|---|
| LLM 生成 SQL | 通过智能体或 MCP 工具调用大模型,按自然语言需求生成 SQL;基于当前模型上下文生成,确保符合模型结构;生成结果自动应用到编辑器并进入评审模式 |
| 代码差异对比 | 自动计算生成代码与原始代码的差异,可视化展示新增、删除、修改;支持逐块查看,每个差异块有唯一标识,便于精确定位 |
| 评审模式 | 可对每个差异块独立接受或拒绝;支持全部接受、全部拒绝等批量操作;实时显示新增、删除、修改行数统计;可随时退出评审模式恢复原始代码 |
| 变更管理 | 保存评审基准内容,支持一键恢复到生成前状态;评审中的变更都被标记;评审模式下可继续编辑代码 |
生成结果不会直接生效,必须经过评审确认后才应用到编辑器。
评审生成结果的操作:
- 用自然语言说明业务要求和目标数据库,触发 SQL 生成。
- 进入差异对比视图,逐块查看变更内容。
- 对每个差异块分别接受或拒绝;涉及多表或大范围修改时,不要直接“全部接受”。
- 评审完成后确认最终 SQL,在实际执行和保存前保持人工检查;评审基准保存了生成前状态,随时可一键恢复。
常见问题
| 现象 | 排查顺序 |
|---|---|
| 补全建议与数据库不一致 | 检查模型与数据库的差异,先同步模型再编写 SQL |
| 生成的 SQL 语法不符合目标库 | 在提示词中明确数据库类型,或确认模型绑定的数据库类型正确 |
| 评审中误接受了错误变更 | 使用恢复到评审基准的功能回退,重新逐块评审 |
| 查询长时间未返回 | 使用取消功能终止,检查过滤条件和数据范围,避免全量扫描 |
相关页面:使用对话和可视化建模、连接和使用 MCP 服务。查询使用的数据源可在服务端统一配置并授权,见服务器端可控数据源管理;把模型部署为 DDL 脚本见生成 DDL。
