專案對接MySQL實現配置服務- FineOps繁体帮助文档

最後修改時間：2025-11-10

1. 概述

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

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

帆軟專案與MySQL配置庫的對接，有多種情況，本文主要講解方案二三。

	說明
方案一 ★★★★★	部署全新專案，使用者無需自行準備MySQL資料庫，只需準備好伺服器即可維運平台部署專案時，在「外接配置庫」中，可勾選「部署MySQL8」維運平台即會自動幫助使用者部署一個MySQL8配置庫，並與帆軟專案對接好
方案二 ★★★	部署全新專案，使用者自行準備一個MySQL資料庫的全新表空間維運平台部署專案時，在「外接配置庫」中，可勾選「對接已有外接資料庫」輸入相關資訊，維運平台會自動與該資料庫進行對接，在專案部署成功後啟動為配置庫
方案三	已有專案，使用者可自行準備一個MySQL資料庫，並進行參數調優在專案部署好後，可將專案與該配置庫對接

說明

方案一

★★★★★

部署全新專案，使用者無需自行準備MySQL資料庫，只需準備好伺服器即可

維運平台部署專案時，在「外接配置庫」中，可勾選「部署MySQL8」

維運平台即會自動幫助使用者部署一個MySQL8配置庫，並與帆軟專案對接好

方案二

★★★

部署全新專案，使用者自行準備一個MySQL資料庫的全新表空間

維運平台部署專案時，在「外接配置庫」中，可勾選「對接已有外接資料庫」

輸入相關資訊，維運平台會自動與該資料庫進行對接，在專案部署成功後啟動為配置庫

方案三

已有專案，使用者可自行準備一個MySQL資料庫，並進行參數調優

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

2. 準備配置庫

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

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

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

2.1 資料庫版本

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

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

資料庫類型	資料庫版本
MySQL5	5.1.73、5.5.31、5.5.46、5.5.56、5.5.62 5.6.22、5.6.28、5.6.31、5.6.35、5.6.37、5.6.44 5.7.16、5.7.23、5.7.26、5.7.33
MySQL8	8.0.11、8.0.16、8.0.20、8.0.21、8.2 注：不支援 MySQL 8.0.19 版本資料庫作為外接庫，該版本存在可能導致外接庫當機的 bug，進而導致帆軟應用不可用，建議至少升級至 8.0.20 及以上版本
RDS MySQL	全版本

資料庫類型

資料庫版本

MySQL5

5.1.73、5.5.31、5.5.46、5.5.56、5.5.62

5.6.22、5.6.28、5.6.31、5.6.35、5.6.37、5.6.44

5.7.16、5.7.23、5.7.26、5.7.33

MySQL8

8.0.11、8.0.16、8.0.20、8.0.21、8.2

注：不支援 MySQL 8.0.19 版本資料庫作為外接庫，該版本存在可能導致外接庫當機的 bug，進而導致帆軟應用不可用，建議至少升級至 8.0.20 及以上版本

RDS MySQL

全版本

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` DEFAULT CHARACTER SET utf8 COLLATE utf8_bin

配置	說明
表空間名稱	即語句中的finedb 只允許包含數字、字母、底線和「.」
字元集	推薦設定資料庫預設字元集為utf8mb3（別稱utf8）不支援 utf8mb4 編碼
排序規則	推薦設定資料庫預設排序規則為utf8mb3_bin（別稱utf8_bin）需要設定字元集排序規則為大小寫敏感不支援utf8_general_ci，因為它大小寫不敏感

配置

說明

表空間名稱

即語句中的finedb
只允許包含數字、字母、底線和「.」

字元集

推薦設定資料庫預設字元集為utf8mb3（別稱utf8）

不支援 utf8mb4 編碼

排序規則

推薦設定資料庫預設排序規則為utf8mb3_bin（別稱utf8_bin）

需要設定字元集排序規則為大小寫敏感
不支援utf8_general_ci，因為它大小寫不敏感

2.4 準備配置庫資訊

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

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

3. 專案接入配置庫

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

3.1 部署新專案時接入

在「部署新專案-專案設定」時，可接入自備的MySQL資料庫作為工程配置庫。

此情況下，請確定資料庫表空間為空，不存在任何資料，否則無法成功對接。

1）外接配置庫選擇「對接已有外接配置庫」。

2）在「外接配置庫」資訊填寫處：

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

3）點選「測試連結」，提示「測試連結成功」，即代表可正常對接。

3.2 維運平台叢集管理接入

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

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

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

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

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

注：如為非維運平台部署的專案，請參考「關閉或重啟FineBI工程」文檔，關閉叢集下的其他「bi/fr/fdl」應用，僅保留單個應用存活。

3.2.2 配置外接配置庫

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

2）輸入相關資訊

資料庫類型：選擇「mysql」
驅動：無需調整，選擇「com.mysql.jdbc.Driver」即可
資料庫名稱、主機、埠、帳號、密碼：填寫第二章準備的配置庫資訊即可
資料連結URL：一般無需手動修改，會由其他配置和預設參數共同組成

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

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

情況

新MySQL配置庫情況

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

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

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

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

希望使用其他專案配置

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

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

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

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

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

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

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

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

1）copydb.properties檔案

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

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

注：如為非維運平台部署的專案，請將唯一存活的「bi/fr/fdl」應用目錄/webroot/WEB-INF/embed資料夾中的db.properties檔案，逐一copy到其他「bi/fr/fdl」應用目錄/webroot/WEB-INF/embed資料夾中

2）停止所有應用

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

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

注：如為非維運平台部署的專案，請參考「關閉或重啟FineBI工程」文檔，關閉剩餘唯一存活的「bi/fr/fdl」應用。

3）啟動所有應用

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

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

注：如為非維運平台部署的專案，請參考「關閉或重啟FineBI工程」文檔，逐一重啟叢集下的所有「bi/fr/fdl」應用。

3.3 管理系統接入配置庫

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

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