1 概述

1.1 版本

服务器版本
v8.0.0及以上版本

1.2 功能简介

“SQL查询(图形)”模型是对“SQL查询”的一个图形化方式的操作,本质仍旧是SQL,简单数据查询可以使用该模式。

2 功能入口

进入数据模型管理界面,点击全局“+”或某目录的“+”选择新建模型“SQL查询(图形)”,如下图:

3 功能说明

“SQL查询(图形)”适合规范的SQL查询,或者说,适合对于SQL不熟悉的用户。界面如下图:

“图形模式”让用户免写存储过程,但是本质上还是SQL语句的对应过程,支持的功能如下:

3.1 数据连接选择

首先需要选择查询的数据所在数据连接,目前仅支持选择当前应用下的DBC类型连接。

选择之后,下方将自动获取当前数据连接下的表和视图,可以使用拖拽的方式将其添加到右侧图形设计区。

3.2 模型配置

3.2.1输出列

显示图形上勾选的输出字段,对应SQL语句的直接SELECT的字段名,支持进行字段别名、聚合类型、描述信息设置。

3.2.2 附加列

点击“添加”可手动添加附加字段,对应SQL语句的SELECT中的表达式字段。

3.2.3 联接

表之间的关联,目前只支持 INNER JOIN模式。添加多个表后,在上方的图形设计区域通过拖拽设置关联字段,即可查看表联接关系。

3.2.4 条件

可设置过滤条件,对应SQL语句的WHERE内容。

若该条件需要作为模型的查询参数使用,则值类型选择“查询参数”并设置参数名称即可。

3.2.5 排序

可设置排序字段以及排序方式,对应SQL语句的ORDER BY内容。

3.2.6 分组

可设置分组规则,对应SQL语句的GROUP BY内容。

3.2.7 查询参数

与“SQL查询”的定义方式不同:需要在“条件”中将字段的值类型设置为“查询参数”,设置为查询参数的字段则视为参数,将参数名称显示在查询参数列表中,可设置参数默认值。

3.3 执行

模型设计好之后,可点击“运行”进行调试,如果存在参数,可设置对应的参数值进行查询,为空表示禁用该参数,如下图:

点击“确定”即可在下方“执行结果”Tab中查询到对应的数据,最多显示1000条数据,如下图:

点击“导出Excel”可将所有数据导出Excel(非前1000条数据)。
切换到“日志信息”可查看QL执行日志,包括执行的SQL和执行时间,如下图:

除了设计时运行,还可以在左侧模型树的菜单上点击“运行”进行当前模型的执行。

3.4 其他功能

3.4.1 转码

同“SQL查询”的转码功能。

3.4.2 SQL查询

设置完成后,可以在左侧模型树的菜单上点击“SQL查询”查看对应的完整SQL语句,如下图:

3.4.3 转换为SQL

SQL查询(图形)模型通过菜单操作“转换为SQL”即可将其转换为SQL查询模型,如下图:

注意:从SQL查询(图形)模型转换为SQL查询模型,不可逆,即无法从SQL查询模型转换回SQL查询(图形)模型。

作者:fancy  创建时间:2025-08-27 14:01
最后编辑:fancy  更新时间:2025-08-27 17:08