参数应用数据集参数

1 概述

1.1 应用场景

类似通信、监控行业，每天都有海量数据生成，数据库表中总数据量非常大，而报表中往往只要获取当天的几百条数据就可以了。

如果使用模板参数，就需要先取出所有数据，再进行过滤，取数+过滤，将消耗大量时间，极大影响报表的查询效率。而数据集参数在数据库查询时就已经完成了数据过滤，所以使用数据集参数设计的查询报表会比使用模板参数的效率高。

附：FineReport下载地址点击下载个人免费数据分析可视化软件

1.2 功能简介

定义数据集时，通过在 SQL 语句中添加 ${para}格式的内容，即可定义数据集参数，定义完成后，使用方法和模板参数一致。如下图所示，下拉框选择「华东」，点击查询，只查询出报表中华东地区的销售信息。

数据集参数,SQL语句查询,定义数据集,定义参数

2 使用说明

数据集 SQL 查询语句中可以使用参数宏 ${}动态地生成过滤条件，${} 执行结果与 SQL 语句拼接起来形成最终的查询语句，传递给数据库执行。SQL 语句中可以使用多个 ${}，定义多个参数使用。

使用${} 定义参数时，{ }内写入的内容即为定义参数的内容，其中可以使用 FineReport 所有内置的函数，如 if 函数、len 函数等。{ }中除了 FineReport 内置的函数名、常量、字符串拼接语法外，其他变量就是数据集参数。

如：SELECT * FROM 销量 where 地区 = ‘${area}’ 中定义的数据集参数为 area。

注：定义数据集参数时，尽量不要在${}中直接使用{ 、}，可能会无法解析。若必须在${}中直接使用{ 、}，需要使用函数 CONCATENATE 转义，例如：SELECT * FROM 销量${‘{‘}语句会出现报错，需要将语句改为 SELECT * FROM ${CONCATENATE(“销量{“)}，即可正常查询。

带有数据集参数的 SQL 语句写好后，点击数据集定义界面「预览」按钮时，若显示出定义的数据集参数。则表明数据集参数定义成功。如下图所示：

在参数位置输入值后点击确定，参数值就会代入 SQL 语句中，查询出数据。

数据集参数,SQL语句查询,定义数据集,定义参数

如下给出几种常见的应用方式，用户在使用时按实际场景调整即可。注意，因为数据集参数用在 SQL 查询语句中，所以在使用时，特别要注意语法和对应数据库类型的 SQL 语法匹配。

2.1 简单应用

如要定义一个地区参数，通过此参数过滤数据。新建数据集时，就可以在 SQL 查询语句中定义一个数据集参数 area：SELECT * FROM 销量 where 地区 = ‘${area}’

SQL 语句中，其他内容都是确定的，唯有 area 不确定，当 area 对应不同值时，数据集也将查询出不同地区的数据。

2.2 带公式的应用

定义数据集参数时，可以使用 FineReport 所有内置函数。如需要定义一个地区参数，当地区为空时，查询所有地区的数据；当地区值不为空时，查询对应地区的数据：

SELECT * FROM 订单 where 1=1 ${if(len(area) == 0,””,”and 货主地区 = ‘” + area + “‘”)}

定义时，先使用函数 len 获取参数的长度，然后使用 if 函数进行判断

如果 area 参数的长度为 0，则内容为空，SQL 拼接后为 SELECT * FROM 订单 where 1=1；
如果 area 参数的长度不为 0，则将字符串 and 货主地区 = ‘、参数area、‘拼接成一句 SQL ，如area的值为华东，那么参数定义部分的执行结果为and 货主地区=’华东’，完整的 SQL 语句就变成：SELECT * FROM 订单 where 1=1 and 货主地区=’华东’

2.3 定义多个参数

如果在数据过滤中，需要多个过滤条件，则可以定义多个数据集参数，如：

SELECT * FROM 订单 where 1=1 ${if(len(area) == 0,””,”and 货主地区 = ‘” + area + “‘”)} ${if(len(province) == 0,””,”and 货主省份 = ‘” + province + “‘”)}

其中使用了两次 ${}，定义了两个数据集参数 area 和 province，定义过程解释可参考 2.2 节。

2.4 嵌套应用

定义数据集参数时，也可以通过一些逻辑判断嵌套定义多个数据集参数。如：

SELECT * FROM 销量 where 1=1 ${if(len(area)!=0,” and 地区='”+area+”‘”,if(len(product)=0,””,” and 产品='”+product+”‘”))}

if 函数是 FineReport 内置的公式，变量 area 和 product 是数据集参数，如果len(area)!=0，即 area 参数不为空，即以

SELECT * FROM 订单 where 1=1 and 货主地区=’area’ 查询，如地区为空，则要判断 len(product) ，若product参数为空，则不拼接任何查询条件，即查出所有，否则以 SELECT * FROM 订单 where 1=1 and 产品=’product’ 查询。

3 示例

3.1 定义数据集参数

新建数据集 ds1，数据库查询对话框中写入 SQL 查询语句 SELECT * FROM 销量 WHERE 地区=’${area}’，相当于在数据库查询语句中定义一个数据集参数area。点击右下角「刷新」按钮，下方数据集参数管理面板会显示已经新建好的数据集参数area，设置它的默认值为华东。点击「确定」，即同时完成了数据准备和定义数据集参数的工作。如下图所示：

数据集参数,SQL语句查询,定义数据集,定义参数