历史版本25 :数据库查询 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

SQL 查询是指从定义好的数据库连接中,也就是数据源中使用 SQL 语句来选择我们所需要的数据字段,一般是直接对数据源中的数据库表直接进行操作。在设计器中我们把数据源分为两种,一种是服务器数据集,一种是模板数据集,两者被引用的范围不一样,下面我们以模板数据集为例进行说明。

2. 数据库查询编辑

点击菜单模板>模板数据集,弹出模板数据集对话框,点击模板数据集窗口的左上角的按钮,选择数据库查询,然后给数据库查询命名,接着我们就可以添加 SQL 查询了。

222

使用 SQL ,选择好数据源后,我们就可以使用 SQL 对数据库表进行操作,选中查询编辑器,在其中输入 SQL 语句SELECT * FROM ORDERS where ORDERID=${ID}

这是一个带参数的 SQL 查询,${}为参数的形式,中间的ID即是参数的名称,预览时输入参数 ID=10004 的结果可以在预览组中看,实际就是执行了一个SELECT * FROM ORDERS where ORDERID=10004的 SQL 查询。

222

注:一般的 SQL 我们都通用,只是在设置参数时需要参照以上的形式。

下面介绍整个数据集界面的一些基本属性,在后面的章节中就不再加以介绍了。

类型

对于查询类型,FineReport 既支持普通的 SQL 查询,也支持存储过程,并且这两种类型的查询语句中都可以包含参数。 注意:  SQL 查询和存储过程,通过 JDBC,最终都是由数据库软件来解析执行,并将结果返回给 FineReport 来显示的,所以查询执行的速度和性能完全由对应的数据库软件来决定。

向导

FineReport 提供了简单的向导来帮助用户创建简单的 SQL 查询和存储过程。  注意:由于SQL语言比较复杂,FineReport 提供的向导只能定义常用的简单 SQL 查询(不支持分组,子查询等等);存储过程的向导基本可以满足要求,它能够列出所连接数据库中所有的存储过程,并根据所选择存储过程的名字,自动获得存储过程的参数来产生可以执行的存储过程语句。 

查询编辑器

当向导产生的查询不能完全满足要求的时候,可以通过我们提供的文本编辑器来编辑任意复杂的查询语句(利用向导产生的存储过程,一般不需要再次编辑)。

参数

FineReport可以完美地支持参数查询,在定义查询语句的时候,你只需要用特殊字符串 "${XXX}" (参数值为数值型,为${参数},否则为 '${XXX}') ,将参数名字前后包含起来,点击下面的刷新按钮,可以给参数赋默认值,这样当报表引擎执行这个 SQL 语句的时候,在 C/S 系统会弹出一个对话框来要求用户输入对应参数的数值,并且会自动显示默认值,在 B/S 系统会遍历客户端(通常是浏览器)传递过来的所有参数数值;然后 FineReport 利用这些参数的数值来替换查询中对应的字符串“${XXX}”,将替换过的查询语句提交给数据库解析和执行。  比如: 1.用户输入的查询语句为: “select * from Customers where ID = ${ID}”;  2.从客户端动态取到的ID数值为: 1; 3.根据参数值产生新的查询语句:“select * from Customers  where ID = 1”,利用 JDBC,将这个新产生的查询语句传递给相应的数据库解析和执行。

最大预览数

这里为了加快预览的速度,才设置了预览的最大行数(默认值是 200),这个数值只有在点击(预览)按钮的时候才起作用,不会错误地作用到引用这个查询的报表模板文件中。

使用服务器数据集的操作方法和模板数据集类似,只是打开服务器数据集对话框,接下来的操作和模板数据集操作相同。二者的区别在于服务器数据集的配置信息保存在当前服务器 FineDB 的 fine_conf_entity 中,当前服务器上面设计任意一张报表都可以使用该数据集,而模板数据集则将信息保存到当前的 cpt 文件当中,即只能适用于当前打开的这一张报表。

注:模板数据集,只适用于当前的报表。

3. 视图查询编辑

视图查询是指对定义好的数据源中的视图进行操作。

3.1 数据库查询

点击菜单模板>模板数据集,弹出模板数据集对话框,点击模板数据集窗口的左上角的按钮,选择数据库查询,然后给数据库查询命名,接着我们就可以添加视图查询等等。

222

3.2 使用视图查询

选择数据源后我们就可以使用 SQL 对视图查询进行操作。如下我们以 SQL Server 视图数据库为例:

在查询编辑器中写 SQL,select * from INFORMATION_SCHEMA.[KEY_COLUMN_USAGE].(INFORMATION_SCHEMA.[KEY_COLUMN_USAGE]是某个视图查询的名字),然后点击预览可以看到视图查询引用成功。

222


注:小技巧,我们可以将数据连接中的表、视图直接拖动到查询编辑器中。

4. 模糊查询编辑

在表下方有一块空白搜索框,它们用作模糊查询。例如想要搜索客户相关的表,在搜索框中填入客户二字,会进行自动搜索进行模糊匹配:

222


注1:FR 数据库查询只支持一条自然 SQL 语句的查询,不支持多个自然 SQL,比如 SELECT * FROM A SELECT * FROM B

注2:create 、drop 等新建表、删除表不在官方支持范围内,官方只支持 select