資料連結進階設定- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 版本

報表伺服器版本	功能變動
10.0.18	「連結池設定」按鈕改名為「進階設定」部分資料連結支援設定 fetchsize
11.0.2	進階設定佈局優化
11.0.23	所有資料庫直接調整 fetchsize 參數

1.2 功能簡介

本文將介紹進階設定設定方法及其屬性中各參數的意義。

連結池
fetchsize

2. 具體介紹

2.1 進階設定

在連結 FineReport 時，使用者可以在連結頁面進行一些進階設定，平台和設計器都可以設定，如下圖所示：

設計器進階設定

平台進階設定

2.2 連結池屬性參數介紹

常用連結池屬性

名稱	druid學名	預設值	含義
最大活動連結數	maxActive	50	連結池在同一時間能夠分配的最大活動連結的數量
校驗語句	validationQuery	預設語句	用來檢查連結是否有效的 SQL 語句，要求是一個查詢語句，常用select 'x' 。使用者可自訂該語句。
獲取連結前檢驗	testOnBorrow	是	申請連結時執行 validationQuery 檢查連結是否有效
最大等待時間	maxWait	10000	獲取連結時最大等待時間，單位毫秒

不太常用的連結池屬性（如無特殊場景不建議修改）

名稱	druid學名	預設值	含義
初始化連結數	initialSize	0	初始化時建立物理連結的個數
最小閒置連結數	minIdle	0	連結池最小連結數量
歸還連結前校驗	testOnReturn	否	歸還連結時執行validationQuery檢查連結是否有效
開啟閒置回收器校驗	testWhileIdle	否	指明連結是否被閒置連結回收器(如果有)進行檢驗，如果檢查失敗，則連結將被從池中去除
閒置連結回收器休眠時間	timeBetweenEvictionRunsMillis	-1	在閒置連結回收器執行緒運作期間休眠的時間值，以毫秒為單位
閒置連結回收檢查數	numTestPerEvictionRun	3	在每次閒置連結回收器執行緒（如果有）運作時檢查的連結數量
保持閒置最小時間值	minEvictableIdleTimeMillis	1800s	連結保持閒置而不被驅逐的最小時間

最大活動連結數設定超過資料庫中的連結數目，只能按照資料庫中的連結數目為準，如想調至最大，則也要調整資料庫中的連結數目，參考文檔連結池滿問題中的解決方案。

fetchsize 設定

fetchSize 參數是用於控制從資料庫中獲取資料的成成批處理大小的設定。較小的 fetchSize 值會減少每次資料庫查詢的記憶體消耗，但可能需要更多的資料庫往返來獲取完整的結果集；較大的 fetchSize 值可以減少資料庫往返次數，但會增加記憶體使用量。可以根據你的需求透過設定 fetchSize 參數值，來優化資料庫查詢效能。

若參數值 ≤ 0（例如：-20）則表示不開啟 fetchsize 參數。

1）Oracle、DB2、Postgre 這三種資料庫必須設定 fetchsize 參數，所以若設定了≤0 的參數值，會自動分別被更換為 128、50、10000。

2）其他資料庫預設情況下不開啟 fetchsize 參數。

使用者也可在設計器中，對「Oracle、DB2、Postgre」資料連結設定 fetchsize。可輸入 1~1,000,000 中的任意數值，若為空則表明不配置此項參數。

3. 注意事項

如果存取範本時，報連結逾時、等待狀態，警告如下所示：

警告:Cannot get a connection, pool error Timeout waiting for idle object
at com.fr.third.org.apache.commons.dbcp.PoolingDataSource.getConnection(PoolingDataSource.java:114)
at com.fr.third.org.apache.commons.dbcp.BasicDataSource.getConnection(BasicDataSource.java:1044)
at com.fr.data.pool.MemoryConnection.create(Unknown Source)
at com.fr.data.impl.JDBCDatabaseConnection.createConnection(Unknown Source)