反馈已提交

网络繁忙

配置資料連結入門

1. 概述

1.1 版本

FineBI 版本功能變動
6.0-

1.2 功能簡介

實際使用時最常見的是將業務資料儲存在資料庫中,並且不斷更新。建立 FineBI 與資料庫的連結,讓 FineBI 能夠直接獲取到資料庫中的資料。

1.3 注意事項

在進行資料連結時,不支援資料庫中表名欄位名包含下表所示的特殊字元:

表名和欄位名不支援包含下面字元 
JOJO___NULL____EMPTY__##__order__partition##RF#JO
.[]{}()=/_
RE_MTRE 自然數RE-MT_MT

2. 建立資料連結

以管理者身分進入 FineBI ,點選「管理系統>資料連結>資料連結管理>建立資料連結」可建立新的資料連結,如下圖所示:

注:如果非管理者,使用者需要有 資料連結使用權限 才可以設定資料連結。

1資料連接路徑.jpg

3. 選擇資料庫型別

接下來我們需要選擇自己需要的資料庫型別,本文選擇「MySQL」資料庫。如下圖所示:

3搜索.jpg

4. 配置資料連結

4.1 配置資料庫資訊

輸入資料庫的相關資訊,如下圖所示:

不同資料庫具體的連結方式可能略有不同,可查看具體的文檔,例如 MySQL 可查看:MySQL資料連結

4mysql配置.jpg

以下為資料連結資訊的詳細解譯,不同資料庫要設定的連結資訊不同,所以某些資料庫會缺失一些項。

配置
介紹
資料連結名稱給這個資料連結一個名稱,按使用者自己的習慣起名即可
驅動

連結資料庫所需要的驅動:

  • 預設:一小部分資料庫中內建了資料庫驅動,使用預設即可。

  • 自訂:FineReport 中未內建驅動,需要使用者自訂驅動,詳細操作請參見:驅動管理

資料庫名稱輸入要連結的資料庫的名稱
主機輸入資料庫所在主機(或伺服器)的 IP
輸入資料庫所在主機(或伺服器)的埠
認證方式

部分資料庫支援多種認證方式,則點選會出現認證方式下拉框:

編碼推薦使用預設
模式
  • 部分資料庫需要選擇模式,需要先連結成功後才能選擇模式

  • 當資料庫不存在模式選擇,則無需進行模式選擇

  • 如果這些資料庫未進行模式選擇,則預設選擇的是第一個模式

  • 連結多模式的資料庫時使用 SQL 語句需要帶上模式名前綴進行搜尋

注:需要正確選擇資料庫對應的模式,否則會導致新增資料庫表時顯示「當前資料連結中無可用表」,只能透過 SQL 資料集進行取數。

資料連結URL自動生成的 URL ,無需特意配置

點選「測試連結」,即可測試是否可以連結成功。

4連接成功.jpg

若使用者不需要進行一些特殊的配置(本文 4.2、4.3、4.4節),到這裏已經可以點選「儲存」結束配置了。

4.2 進階設定

在連結資料庫時,我們有可能需要進行一些進階設定,但大部分情況下是不需要設定的。我們可以根據需要選擇性設定,如下圖所示:

5高級設定.jpg

  • 常用設定

連結數指的是連結到資料庫的 IO 活動數。若同時對此資料庫進行連結取表的使用者數越多,連結數就越高。

連結數高會嚴重影響資料庫的效能,所以我們需要設定最大活動連結數進行限制。

名稱  druid學名預設值
含義  
最大活動連結數maxActive50
連結池在同一時間能夠分配的最大活動連結的數量
校驗語句validationQuery預設語句
用來檢查連結是否有效的 SQL 語句,要求是一個查詢語句,常用select 'x' 。使用者可自訂該語句。
獲取連結前檢驗testOnBorrow申請連結時執行校驗語句 validationQuery 檢查連結是否有效
最大等待時間maxWait10000
獲取連結時最大等待時間,若超過此時間還沒有連結成功,則判定此次連結失敗,不再等待。
  • 更多設定(不常用,如無特殊場景不建議修改)

名稱
druid學名預設值含義
初始化連結數
initialSize0初始化時建立物理連結的個數
最小閒置連結數minIdle0
連結池最小連結數量
歸還連結前校驗testOnReturn
歸還連結時執行校驗語句validationQuery 檢查連結是否有效
開啓閒置回收器校驗testWhileIdle
指明連結是否被閒置連結回收器(如果有)進行檢驗,如果檢查失敗,則連結將被從池中去除
閒置連結回收器休眠時間timeBetweenEvictionRunsMillis-1
在閒置連結回收器執行緒運作期間休眠的時間值,以毫秒為單位
閒置連結回收檢查數

numTestPerEvictionRun

3
在每次閒置連結回收器執行緒(如果有)運作時檢查的連結數量
保持閒置最小時間值minEvictableIdleTimeMillis1800s
連結保持閒置而不被驅逐的最小時間

4.3 SSH 設定

若使用者安全性要求高,需要使用 SSH 。可以直接勾選「使用SSH通道」,輸入對應資訊。

注:驗證方法支援密碼和公用鍵,其中選擇「公用鍵」需要將檔案放置在 %FineBI%/webapps/webroot/WEB-INF/resources 下。

6SSH.jpg

點選「測試連結」,若提示連結成功,點選「儲存」儲存該配置。

4.4 SSL 設定

注:暫只支援 MySQL 資料庫

1)在%FineBI%/webapps/webroot/WEB-INF/resources/certificates 中put 命令 CA 憑證、用戶端憑證以及用戶端祕鑰,如下圖所示:

7pem檔案.jpg

2)勾選「使用SSL通道」,將檔案新增進對應位置。如下圖所示:

8SSL.jpg

3)點選「測試連結」,若連結成功點選「儲存」儲存該配置。

5. 管理資料連結

5.1 管理範圍

在數據決策系統中,點選「管理系統>資料連結>資料連結管理」,點選某一資料庫右側圖示,如下圖所示:

9資料連結管理.jpg

資料連結管理」各設定項說明如下表所示:

設定項說明
測試連結測試資料庫配置是否成功
編輯修改資料連結配置項
重命名重命名該資料庫
複製複製該筆資料庫,且資料連結名自動加 1 
刪除刪除該資料庫
資料連結資訊顯示資料庫型別和建立者

需要注意以下幾點:

  • 未適配的資料庫型別右側不顯示生省略號.png圖示。

  • 在管理資料連結時,資料連結的名稱不能隨意改動。更新到本地的表與資料庫匹配依靠的是資料連結的名稱,如果修改資料連結的名稱,從該連結中取出的表將無法再更新。  

    如果是 SQL 資料集,也會導致沒有「修改 SQL」的按鈕。

  • 如果更新本地儲存的表中的資料庫,例如由開發環境變化到生產環境,表名與表結構均一致時,只需要修改資料連結的 URL 即可。本地儲存的表依照資料連結名依然可以更新資料。

5.2 連結池狀態

資料連結介面提供連結池狀態頁面,可看到目前已建立的資料連結及對應的連結狀態,如下圖所示:

10連結池狀態.jpg

活動連結數」和「空閒連結數」的說明如下表所示:

連結池狀態說明
活動連結數

連結池最大可建立的連結數,若最大連結數是 10 ,過程已申請 10 個連結,而且一直在使用,第 11 個連結申請時報錯:active 10 maxActive 10

閒置連結數

當前處於閒置狀態的連結, 隨時會轉成活動連結, 閒置狀態超過最大閒置連結時間時自動釋放

活動連結數 閒置連結數=實際物理連結數

6. 常見報錯

資料無法預覽

BI 連結伺服器資料集,資料預覽時有報錯資訊:find fieldinfo failed for table:XXX

這是因為資料庫表中有重複的欄位名,BI 是不支援重複欄位名及空值的,如下圖所示。我們需要重新修改重複的欄位名。

11重複字段.png

附件列表


主题: 資料準備
  • 有帮助
  • 没帮助
  • 只是浏览
中文(繁體)

售前咨询电话

400-811-8890转1

在线技术支持

在线QQ:800049425

热线电话:400-811-8890转2

总裁办24H投诉

热线电话:173-1278-1526

文 档反 馈

鼠标选中内容,快速反馈问题

鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

不再提示

10s后关闭