概述：執行在 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,SALESAMOUNT,sum(SALESAMOUNT) over (order by RANKING) AccumulativeAmount
from A)
where AccumulativeAmount>(select sum(SALESAMOUNT)/2 from SALES)
order by SALESAMOUNT desc

說明：按照銷售額累計值從小到大排序，透過累計值大於“一半銷售額”的條件，逆向找出佔到銷售額一半的客戶。為了避免視窗函式在計算累計值時對銷售額相同的值處理出現錯誤，用子查詢先計算了排名。

下面是用集算器實現相同邏輯的程式碼：
d1png
從上述程式碼我們可以看到，集算器利用一套簡潔的語法取代了需巢狀 SQL+ 視窗函式才能實現的邏輯，並且具有通用一致性（任何資料來源程式碼一致）。

集算器是一套執行在 JVM 上專門處理結構化資料的指令碼語言，類似用 SQL 函式和儲存過程，與 Java 整合可以建立可移植、功能強大和與資料庫無關的計算邏輯，執行於中間層的計算邏輯和執行於資料庫層的資料邏輯之間的分離，提高了應用程式的可擴充套件性、靈活性和可維護性。

應用場景：報表資料準備

應用結構

d4png

整合後，集算器嵌入報表應用層，相當於本地的邏輯資料庫（不需要單獨伺服器部署），在報表與資料來源間作為報表資料準備層，完成各種複雜的計算任務。

如何整合

下面以 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.xml，主要包含集算器授權、指令碼檔案路徑、其他作為集算器資料來源的連線配置等。

可在 [esProc 安裝目錄]\esProc\config 下找到，需複製後放置在類路徑下，同樣將其複製至 Birt 開發環境 [安裝目錄]\plugins\org.eclipse.birt.report.data.oda.jdbc_4.6.0.v20160607212 下。

注意：配置檔名不能改變

（二） Birt 應用環境

1、將（一）中的所有 jar 複製至應用的 WEB-INF\lib 下

2、將 raqsoftConfig.xml 複製至應用的 WEB-INF\classes 下

例一：常規呼叫

1、 Vertica 內 Sales 表欄位及資料說明（透過 vsql 查詢，本測試庫有 2013/14/15 年資料）
3png
2、編寫並部署 esProc 指令碼

（1） esProc 設計器新增 vertica JDBC 驅動包

vertica 官網下載 jdbc 驅動包（如，vertica-jdbc-9.1.0-0.jar），放至【esProc 安裝目錄】\common\jdbc 下

（2）新增 vertica 資料來源

開啟設計器，Tool—Datasource connection 新增 JDBC 方式連線

4png

點 ok 儲存，再點 connect 連線

5png

資料來源名稱變為粉色即表示連線成功。

（3）編寫演算法指令碼 (檔案：VerticaExternalProcedures.dfx)

File – New

d2png

（4）部署指令碼

將指令碼檔案部署到 raqsoftConfig.xml 配置的指令碼檔案主目錄下。

6png

3、 esProc 配置檔案 raqsoftConfig.xml 內增加 verticaLink 資料來源連線配置

<DB name="verticaLink">
<property name="url" value="jdbc:vertica://192.168.10.10:5433/ForEsprocTestDB"></property>
<property name="driver" value="com.vertica.jdbc.Driver"></property>
<property name="type" value="0"></property>
<property name="user" value="dbadmin"></property>
<property name="password" value="runqian"></property>
<property name="batchSize" value="0"></property>
<property name="autoConnect" value="false"></property>
<property name="useSchema" value="false"></property>
<property name="addTilde" value="false"></property>
<property name="needTransContent" value="false"></property>
<property name="needTransSentence" value="false"></property>
<property name="caseSentence" value="false"></property>
</DB>

4、 Birt 開發工具內新建報表，並增加 esProc 資料來源“esProcConnection”

7png

Driver class 為”com.esproc.jdbc.InternalDriver(v1.0)”，會用到 dm.jar 等
Database URL 為”jdbc:esproc:

5、 Birt 呼叫 Vertica 外部儲存過程（esProc 資料集）

新建“Data Sets”，選擇配置的集算器資料來源（esProcConnection），資料集型別選擇儲存過程（SQL Stored Procedure Query）
8png
Next，查詢指令碼（Query-Query Text）輸入：{call VerticaExternalProcedures()}