資料連結進階設定

1.1 版本

1.2 功能簡介

本文將介紹資料連結進階設定的配置項中各參數的意義。

在連結 FineReport 時，使用者可以在連結頁面進行一些進階設定，平台和設計器都可以設定。

2.1 設計器進階設定

設計器設定頁面如下圖所示：

• 常用設定

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

2.2 平台進階設定

• 常用連結池屬性

• 「更多設定」中不太常用的連結池屬性（如無特殊場景不建議修改）

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

• 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 中的任意數值，若為空則表明不配置此項參數。

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

警告: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)

則需要把相應連結數調大。