FineBI對接SQL Server實現配置服務- FineBI帮助文档 FineBI帮助文档

提示:

由於 SQL Server 資料庫自身特性，作為配置儲存服務時效能較差。

推薦使用者優先考慮使用 MySQL/Oracle 類型的資料庫作為配置儲存服務。

1. 概述

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

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

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

使用者可自行準備一個SqlServer資料庫的表空間，並進行參數調優
在專案部署好後，可將專案與該配置庫對接

2. 準備配置庫

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

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

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

2.1 資料庫版本

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

本文未提及的更低版本，一般預設不支援，或存在一些漏洞，不建議使用
本文未提及的更高版本，使用者可自行測試驗證。如果出現問題，付費使用者可交握技術支援獲取幫助。技術支援交握方式：「服務平台>線上支援」

資料庫類型	資料庫版本
SqlServer	2000、2005、2008、2012、2014、2016、2017、2019

2.2 伺服器配置

配置類型	最低配置	推薦配置	注意事項
記憶體	1GB	2GB	記憶體，是指分配給配置庫的記憶體，而非伺服器的所有記憶體如有條件，建議配置庫獨佔一台伺服器如條件不足，至少確定部署配置庫的伺服器中，不部署帆軟應用以外的任何內容，且確定分配給配置庫的記憶體足夠
CPU	4核	8核	-
網速	50Mbps	100Mbps	配置庫和應用工程、其他組件建議在同一網段，避免網路波動等問題配置庫和應用工程、其他組件之間需要網路暢通，互相埠可存取
finedb佔用空間	1GB	2GB	佔用空間，請結合工程使用度進行調整建議根據推薦配置，增大1~2倍，預留足夠空間
伺服器磁碟空間	100GB	200GB	-
磁碟讀寫速度	50MB/s	100MB/s	-

2.3 建立表空間

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

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

標準建立表空間語句：CREATE DATABASE finedb COLLATE Chinese_PRC_CS_AS

配置	說明
表空間名稱	即語句中的finedb 表空間名稱只允許包含字母、底線和「.」，不支援數字該表空間內不建議存放其他任何資料，包括業務資料、日誌資料等。
排序規則	推薦設定資料庫預設排序規則為Chinese_PRC_CS_AS（區分大小寫） Chinese_PRC_CS_AS：大小寫敏感，即使在進行資料遷移時，也會原封不動的把全部資料遷移過去 Chinese_PRC_CI_AS：大小寫不敏感，可能會導致遷移資料時出現報錯，提升違反了 PRIMARY KEY 約束之類的字樣。屆時需要執行SQL語句查看髒資料：select lower(ID),COUNT(1) FROM FINE_CONF_ENTITY GROUP BY LOWER(ID) HAVING COUNT(1) >1

配置

說明

表空間名稱

即語句中的finedb

表空間名稱只允許包含字母、底線和「.」，不支援數字
該表空間內不建議存放其他任何資料，包括業務資料、日誌資料等。

排序規則

推薦設定資料庫預設排序規則為Chinese_PRC_CS_AS（區分大小寫）

Chinese_PRC_CS_AS：大小寫敏感，即使在進行資料遷移時，也會原封不動的把全部資料遷移過去
Chinese_PRC_CI_AS：大小寫不敏感，可能會導致遷移資料時出現報錯，提升違反了 PRIMARY KEY 約束之類的字樣。屆時需要執行SQL語句查看髒資料：select lower(ID),COUNT(1) FROM FINE_CONF_ENTITY GROUP BY LOWER(ID) HAVING COUNT(1) >1

2.4 準備配置庫資訊

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

設定項	說明
資料庫名稱	2.3節，在資料庫建立的表空間名稱表空間名稱只允許包含字母、底線、「-」和「.」
主機	資料庫所在伺服器的IP
埠	資料庫佔用的伺服器埠
帳號	資料庫的用戶名稱所準備的使用者需要具備 create、delete、alter、update、select、insert、index 權限，以滿足配置表架構調整、配置資訊調整等訴求
密碼	資料庫的用戶密碼配置庫對接成功後，請勿輕易修改所使用的資料庫帳號和密碼，否則會導致工程啟動失敗
模式	即為所準備的資料的帳號稱

3. 專案接入配置庫

支援在以下情況下接入SqlServer配置庫，請根據情況自行選擇即可。

3.1 維運平台叢集管理接入

在維運平台的「叢集管理」中，可為專案接入自備的SqlServer資料庫作為配置庫。

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

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

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

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

3.1.2 配置外接配置庫

1）管理者登入維運平台，選中指定專案。點選「維護>叢集管理」，對「外接配置庫」進行配置。

2）填寫資料庫資訊：

資料庫類型：選擇「SqlServer」
驅動：無需調整，選擇「com.microsoft.sqlserver.jdbc.SQLServerDriver」即可
資料庫名稱、主機、埠、帳號、密碼：填寫第二章準備的配置庫資訊即可

3）選擇「模式」：

正確填寫完上面的所有配置後，點選模式下拉框中的「點選連結資料庫」，系統將自動連結該資料庫並讀取模式
優先選擇與資料庫使用者同名的模式

4）填寫資料連結URL：

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

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

情況	新SqlServer配置庫情況
希望使用當前專案原有配置	1）必須勾選「遷移資料至要啟動的資料庫」 2）專案與該配置庫對接成功後，會將工程原有配置資料，遷移到該表空間中 3）無論準備的新SqlServer表空間中是否有資料，均會被清空，無法找回
希望使用其他專案配置（例如將正式環境配置，copy一份給測試環境使用）	1）自行將準備的配置資料上傳到新SqlServer表空間中必須確定所準備的資料，對應的專案 JAR 包版本和當前專案的 JAR 包版本完全一致，否則無法使用 2）不勾選「遷移資料至要啟動的資料庫」 3）專案與該配置庫對接成功後，會使用表空間中的資料，作為專案的配置 4）專案原有配置的對接資訊，會備份到工程config目錄下的db.properties.bak檔案中

情況

新SqlServer配置庫情況

希望使用當前專案原有配置

1）必須勾選「遷移資料至要啟動的資料庫」

2）專案與該配置庫對接成功後，會將工程原有配置資料，遷移到該表空間中

3）無論準備的新SqlServer表空間中是否有資料，均會被清空，無法找回

希望使用其他專案配置

（例如將正式環境配置，copy一份給測試環境使用）

1）自行將準備的配置資料上傳到新SqlServer表空間中

必須確定所準備的資料，對應的專案 JAR 包版本和當前專案的 JAR 包版本完全一致，否則無法使用

2）不勾選「遷移資料至要啟動的資料庫」

3）專案與該配置庫對接成功後，會使用表空間中的資料，作為專案的配置

4）專案原有配置的對接資訊，會備份到工程config目錄下的db.properties.bak檔案中

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

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

1）copydb.properties檔案

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

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

2）停止所有應用

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

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

3）啟動所有應用

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

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

3.2 管理系統接入配置庫

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

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