FineBI對接PostgreSQL實現配置服務

帆軟應用中，管理者往往會在平台設定使用者、掛載目錄、分配權限、設定排程管理。這些配置，均儲存於配置庫中。

在正式環境下，使用者可準備一個PostgreSQL資料庫，與帆軟應用對接，用於配置儲存。穩定的外部資料庫，可確定帆軟應用在高負載下的穩定運作。

本文主要講解帆軟專案對接PostgreSQL資料庫，儲存工程配置資訊：

• 使用者可自行準備一個PostgreSQL資料庫的表空間，並進行參數調優

• 在專案部署好後，可將專案與該配置庫對接

2.1 安裝插件

使用者需要透過安裝「PostgreSQL外接資料庫」插件，方可對接 PostgreSQL 配置庫。

點選下載插件：PostgreSQL外接資料庫

插件安裝方法請參見：插件管理

2.2 帆軟專案上傳驅動

帆軟專案中，預設未內建PostgreSQL相關驅動，需要手動上傳。請務必執行本節，否則無法成功對接。

1）前往PostgreSQL官網，下載資料庫對應版本的驅動包：Postgresql驅動

2）參考文檔，將驅動上傳到專案中：驅動管理

使用者需要自行準備並部署PostgreSQL資料庫和表空間。

帆軟不提供相關資料和指導，僅對必要內容進行指明，請查閱資料庫官網獲取其他幫助。

如維運能力不足，推薦使用維運平台部署新專案時，勾選「部署MySQL8」即可，無需手動部署和調優。

3.1 資料庫版本

本文列出的是帆軟測試透過的環境。

• 本文未提及的更低版本，一般預設不支援，或存在一些漏洞，不建議使用

• 本文未提及的更高版本，使用者可自行測試驗證。如果出現問題，付費使用者可聯絡技術支援獲取幫助。技術支援聯絡方式：「服務平台>線上支援」

3.2 伺服器配置

3.3 建立表空間

不同帆軟工程，不可共用同一個資料庫表空間作為配置庫，否則資料可能會出現錯亂。

因此建議在資料庫中建立一個表空間，用於儲存相關配置資料。

• 表空間名稱只允許包含數字、字母、底線和「.」

• 該表空間內不建議存放其他任何資料，包括業務資料、日誌資料等。

3.4 準備配置庫資訊

請準備好表空間的相關資訊，用於接入專案作為配置庫。

在帆軟應用的「管理系統>管理系統>標準」中，可接入自備的資料庫作為配置庫。

注：PostgreSQL類型配置庫，非預設支援的配置庫類型。

      因此無法在維運平台中進行配置，僅可查看相關資訊，或切換其他類型配置庫。

4.1 確定單應用存活（多應用服務工程須完成，單應用服務工程無需）

對於多應用專案，需要確定接入/遷移配置服務時僅存活一個應用節點。

管理者登入維運平台，選中指定專案。點選「維護>組件管理」。檢查是否有多個「bi-web」容器存活。

如果有，請點選容器的「停止」按鈕，確定將其他「bi-web」容器關停至「exited」狀態，僅保留一個容器存活。

4.2 配置外接配置庫

1）管理者登入帆軟應用，點選「管理系統>管理系統>標準」。

2）找到「外接資料庫」，點選配置。

3）填寫資料庫資訊：

• 資料庫類型：選擇「postgresql」

• 驅動：無需調整，選擇「org.postgresql.Driver」即可

• 資料庫名稱、主機、埠、帳號、密碼：填寫3.4節準備的配置庫資訊即可

4）選擇「模式」：

• 正確填寫完上面的所有配置後，點選模式下拉框中的「點選連結資料庫」，系統將自動連結該資料庫並讀取模式

• 優先選擇與資料庫使用者同名的模式

5）填寫資料連結URL：

• 一般無需手動修改，會由其他配置和預設參數共同組成

6）選擇是否「遷移資料至要啟動的資料庫」

7）點選「啟動資料庫」，提示「遷移成功」，即代表可正常對接。

4.3 確定多應用配置同步（多應用服務工程須完成，單應用服務工程無需）

1）copydb.properties檔案

前往唯一存活的「bi-web」容器所在伺服器，複製該組件外掛目錄/config資料夾中的db.properties檔案。

逐一貼上到其他「bi-web」容器所在伺服器的組件外掛目錄/config資料夾中。

2）停止所有應用

管理者登入維運平台，選中指定專案，點選「維護>組件管理」

請對「bi-web」組件進行一鍵「停止」，確定所有「bi-web」容器關停至「exited」狀態。

3）啟動所有應用

管理者登入維運平台，選中指定專案，點選「維護>組件管理」。

請對「bi-web」組件進行一鍵「啟動」，確定所有「bi-web」容器啟動至「running」狀態。