1. 程式人生 > 資料庫 >如何讓Birt報表指令碼資料來源變得既簡單又強大

如何讓Birt報表指令碼資料來源變得既簡單又強大

概述:執行在 JVM 上的 SQL 函式和儲存過程

總所周知,有些資料庫沒有強大的分析函式(eg. Mysql),有些資料庫沒有儲存過程(eg. Vertica),當遇到複雜的資料計算,往往只能通過 Python,R 等外部指令碼來實現,但這些指令碼語言和主流工程語言(Java)整合性不好,如果直接用工程語言實現類似 SQL 函式和儲存過程的功能,經常只是針對某個計算需求編寫冗長的程式碼,程式碼幾乎不可複用。

另外,即便擁有強大的分析函式,實現稍複雜的邏輯其實也不算容易,比如下面這種常見的業務計算,找出“銷售額佔到一半的前 n 個客戶,並按銷售額從大到小排序”,在 Oracle 中 SQL 實現如下:

with A as
(selectCUSTOM,SALESAMOUNT,row_number() over (order by SALESAMOUNT) RANKING
from SALES)
select CUSTOM,SALESAMOUNT
from (select CUSTOM,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 資料來源連線配置

<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報表指令碼資料來源變得既簡單又強大,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回覆大家的。在此也非常感謝大家對我們網站的支援!