如何让Birt报表脚本数据源变得既简单又强大
概述:运行在 jvm 上的 sql 函数和存储过程
总所周知,有些数据库没有强大的分析函数(eg. mysql), 有些数据库没有存储过程(eg. vertica),当遇到复杂的数据计算,往往只能通过 python,r 等外部脚本来实现,但这些脚本语言和主流工程语言(java)集成性不好,如果直接用工程语言实现类似 sql 函数和存储过程的功能,经常只是针对某个计算需求编写冗长的代码,代码几乎不可复用。
另外,即便拥有强大的分析函数,实现稍复杂的逻辑其实也不算容易,比如下面这种常见的业务计算,找出“销售额占到一半的前 n 个客户,并按销售额从大到小排序”,在 oracle 中 sql 实现如下:
1 2 3 4 5 6 7 8 | with a as (selectcustom,salesamount,row_number() over ( order by salesamount) ranking from sales) select custom,salesamount from ( select custom,salesamount, sum (salesamount) over ( order by ranking) accumulativeamount from a) where accumulativeamount>( select sum (salesamount)/2 from sales) order by salesamount desc |
说明:按照销售额累计值从小到大排序,通过累计值大于“一半销售额”的条件,逆向找出占到销售额一半的客户。为了避免窗口函数在计算累计值时对销售额相同的值处理出现错误,用子查询先计算了排名。
下面是用集算器实现相同逻辑的代码:
从上述代码我们可以看到,集算器利用一套简洁的语法取代了需嵌套 sql+ 窗口函数才能实现的逻辑,并且具有通用一致性(任何数据源代码一致)。
集算器是一套运行在 jvm 上专门处理结构化数据的脚本语言,类似用 sql 函数和存储过程,与 java 集成可以创建可移植、功能强大和与数据库无关的计算逻辑,运行于中间层的计算逻辑和运行于数据库层的数据逻辑之间的分离,提高了应用程序的可扩展性、灵活性和可维护性。
应用场景:报表数据准备
应用结构
集成后,集算器嵌入报表应用层,相当于本地的逻辑数据库(不需要单独服务器部署),在报表与数据源间作为报表数据准备层,完成各种复杂的计算任务。
如何集成
下面以 vertica 为数据源,birt 为报表工具,描述怎样集成 esproc 作为数据准备层。
(一) birt 开发环境
1、 基础 jar 集成
集算器 jdbc 需要三个基础 jar 包,都可以在 [esproc 安装目录]/esproc/lib 目录下找到,分别为:
dm.jar 集算器计算引擎及jdbc驱动包
jdom.jar 解析配置文件
icu4j/_3/_4_5.jar 处理国际化
除了基础包外,还有一些为完成特定功能的 jar 包。如,要在集算器 jdbc 用其它数据库作为集算器的数据源,那么还需要相应数据库的驱动 jar 包,本文涉及到 vertica,所以要同时增加其 jdbc 驱动包(以 vertica9.1。0 为例)
vertica-jdbc-9.1.0-0.jar vertica 官网即可下载
获取到以上 jar 后,将其拷贝至 birt 开发环境 [安装目录]/plugins/org.eclipse.birt.report.data.oda.jdbc_4.6.0.v20160607212 下。
注意:标红部分,不同 birt 版本略有不同
2、 配置文件集成
raqsoftconfig. ,主要包含集算器授权、脚本文件路径、其他作为集算器数据源的连接配置等。
可在 [esproc 安装目录]/esproc/config 下找到,需复制后放置在类路径下,同样将其拷贝至 birt 开发环境 [安装目录]/plugins/org.eclipse.birt.report.data.oda.jdbc_4.6.0.v20160607212 下。
注意:配置文件名不能改变
(二) birt 应用环境
1、 将(一)中的所有 jar 拷贝至应用的 web-inf/lib 下
2、 将 raqsoftconfig. 拷贝至应用的 web-inf/classes 下
例一:常规调用
1、 vertica 内 sales 表字段及数据说明(通过 vsql 查询,本测试库有 2013/14/15 年数据)
2、 编写并部署 esproc 脚本
(1) esproc 设计器添加 vertica jdbc 驱动包
vertica 官网下载 jdbc 驱动包(如,vertica-jdbc-9.1.0-0.jar),放至【esproc 安装目录】/common/jdbc 下
(2) 新增 vertica 数据源
打开设计器,tool—datasource connection 新增 jdbc 方式连接
点 ok 保存,再点 connect 连接
数据源名称变为粉色即表示连接成功。
(3) 编写算法脚本 (文件:verticaexternalprocedures.dfx)
file – new
(4) 部署脚本
将脚本文件部署到 raqsoftconfig. 配置的脚本文件主目录下。
3、 esproc 配置文件 raqsoftconfig. 内增加 vertica 数据源连接配置
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | <db name = "vertica " > <property name = "url" value= "jdbc:vertica://192.168.10.10:5433/foresproctestdb" /> <property name = "driver" value= "com.vertica.jdbc.driver" /> <property name = "type" value= "0" /> <property name = "user" value= "dbadmin" /> <property name = "password" value= "runqian" /> <property name = "batchsize" value= "0" /> <property name = "autoconnect" value= "false" /> <property name = "useschema" value= "false" /> <property name = "addtilde" value= "false" /> <property name = "needtranscontent" value= "false" /> <property name = "needtranssentence" value= "false" /> <property name = "casesentence" value= "false" /> </db> |
4、 birt 开发工具内新建报表,并增加 esproc 数据源“esprocconnection”
driver class 为”com.esproc.jdbc.internaldriver(v1.0)”,会用到 dm.jar 等
data url 为”jdbc:esproc:local://"
5、 birt 调用 vertica 外部存储过程(esproc 数据集)
新建“data sets”,选择配置的集算器数据源(esprocconnection),数据集类型选择存储过程(sql stored procedure query)
next,查询脚本(query-query text)输入:{call verticaexternalprocedures()}
其中:verticaexternalprocedures 为 esproc 脚本文件名
finish,预览数据(preview results)
此时,便看到了把 esproc 脚本作为 vertica 外部存储过程取数辅助计
算的过程。
6、 birt web 端呈现
以简单的网格报表为例
报表设计如下
web 发布预览
例二:参数调用
这里把“找出订单销售额占到一半的前 n 个客户,并按销售额从大到小排序”,改为要求按年查询,即“按年度查询订单销售额占到一半的前 n 个客户,并按销售额从大到小排序”,因此增加了参数过滤功能。
下面看下具体的改法:
1、 esproc 脚本增加按年度参数及过滤功能
打开 esproc 设计器,program – parameter – add
参数名为“qyear”(可与报表参数名不同)
脚本改动:
注:a2 增加条件过滤
2、 报表内增加年度参数
报表增加按年查询的入口参数,参数名为“qyear”
开发工具打开报表,data explorer – report parameter – new patameter
default value 为 qyear 的默认值。
3、 报表数据集增加数据集参数并与报表参数绑定
data set 内编辑 verticaexternalprocedures 数据集
query text 改为“{call verticaexternalprocedures(?)}”,? 为入口参数年
度,此处用占位符设置。
选 parameters,增加数据集参数 qyear 并与报表参数 qyear 绑定。
preview results, 这里根据 qyear 默认值仅有查询 2013 年数据
改为“2015”后
4、 web 端预览
查询“2015”年数据
修改或 url 传入 qyear 为“2013”年后
更多 "birt 整合方案" 详见: http://c.raqsoft.com.cn/tag/report
总结
以上所述是小编给大家介绍的如何让Birt报表脚本数据源变得既简单又强大,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对网站的支持!