Skip to content
Datablau DDM数据建模产品手册
数据建模智能体 模块手册下载 PDF

进行数据分析和 SQL 辅助 ​

Dora 把数据查询分析和大模型 SQL 生成集成在同一个工具中,用户可以完成模型设计、SQL 编写、查询执行和结果分析的全流程。生成内容必须结合目标数据库、数据权限和实际执行结果核对。

数据查询分析 ​

能力项说明
SQL 查询执行在 SQL 编辑器中直接执行查询,无需切换外部工具;支持多语句查询并分别查看结果;提供查询进度提示和取消功能;自动记录执行时间、结果集数量等统计信息
查询结果展示结果以表格展示,多结果集分标签页显示;支持列宽调整、行高自适应、文本换行;提供查询输出日志记录执行过程和错误信息;结果面板可折叠展开
SQL 智能补全基于当前数据模型自动提示表名、字段名、Schema 名称;支持表别名识别;智能识别 JOIN 上下文并按模型关系推荐 JOIN 条件;支持关键字和常用函数补全
元数据集成自动从当前模型提取表结构、字段类型和关系信息;支持 Schema、Table、Column 三级智能提示;编写时优先显示当前实体相关表的补全建议;元数据实时更新

执行一次查询的步骤:

  1. 打开与目标数据库类型一致的模型,在 SQL 编辑器中编写或让 Dora 生成查询语句。
  2. 核对表名、字段名、关联条件和数据范围,确认没有扩大到非目标数据。
  3. 在允许的数据源上执行,查看结果表格和输出日志。
  4. 需要继续分析时,以本次实际查询结果作为后续对话依据。

补全提示来自模型结构,不保证目标数据库中已存在相同对象;模型与数据库不同步时应先处理差异。查询账号只应具备完成任务所需的权限,分析结论必须以实际返回的查询结果为依据。

SQL 代码生成 ​

能力项说明
LLM 生成 SQL通过智能体或 MCP 工具调用大模型,按自然语言需求生成 SQL;基于当前模型上下文生成,确保符合模型结构;生成结果自动应用到编辑器并进入评审模式
代码差异对比自动计算生成代码与原始代码的差异,可视化展示新增、删除、修改;支持逐块查看,每个差异块有唯一标识,便于精确定位
评审模式可对每个差异块独立接受或拒绝;支持全部接受、全部拒绝等批量操作;实时显示新增、删除、修改行数统计;可随时退出评审模式恢复原始代码
变更管理保存评审基准内容,支持一键恢复到生成前状态;评审中的变更都被标记;评审模式下可继续编辑代码

生成结果不会直接生效,必须经过评审确认后才应用到编辑器。

评审生成结果的操作:

  1. 用自然语言说明业务要求和目标数据库,触发 SQL 生成。
  2. 进入差异对比视图,逐块查看变更内容。
  3. 对每个差异块分别接受或拒绝;涉及多表或大范围修改时,不要直接“全部接受”。
  4. 评审完成后确认最终 SQL,在实际执行和保存前保持人工检查;评审基准保存了生成前状态,随时可一键恢复。

常见问题 ​

现象排查顺序
补全建议与数据库不一致检查模型与数据库的差异,先同步模型再编写 SQL
生成的 SQL 语法不符合目标库在提示词中明确数据库类型,或确认模型绑定的数据库类型正确
评审中误接受了错误变更使用恢复到评审基准的功能回退,重新逐块评审
查询长时间未返回使用取消功能终止,检查过滤条件和数据范围,避免全量扫描

相关页面:使用对话和可视化建模、连接和使用 MCP 服务。查询使用的数据源可在服务端统一配置并授权,见服务器端可控数据源管理;把模型部署为 DDL 脚本见生成 DDL。